compared with
Key
This line was removed.
This word was removed. This word was added.
This line was added.

Changes (18)

View Page History
h4. Theme Editor
{toc}
h1. Nuxeo Themes
- Nuxeo Themes is implemented in WebEngine
- WebEngine is a lightweight framework, and comes empty: there's nothing in it. To switch from the current framework (JSF SEAM) to WebEngine means to give up all the functionality and reimplement in WebEngine
- There is a [Themes JSF|http://explorer.nuxeo.org/nuxeo/site/distribution/current/viewComponent/org.nuxeo.theme.jsf] component that implements themes in JSF SEAM.
-- proof: Nuxeo 5.3 documentation [12.4.2.1. "Styling the theme using the editor"|http://community.nuxeo.com/5.3/books/nuxeo-book/html/theme-service.html#d2452e3421] shows Theme Editor working in something looking suspiciously similar to Nuxeo DM:
!Nuxeo-theme-editor.png!
- SEAM and WebEngine can be mixed and used together (but not on the same page). In fact they are mixed in the default install: Nuxeo DM is written in SEAM, while the Theme Editor is written in WebEngine.
-- proof: [Themes Editor|http://explorer.nuxeo.org/nuxeo/site/distribution/current/viewBundle/org.nuxeo.theme.editor] View META-INF/MANIFEST.MF
{code}
Bundle-Name: NXThemes editor
Bundle-Vendor: Chalmers
Provide-Package: org.nuxeo.theme.editor
Require-Bundle: org.nuxeo.theme.webengine
{code}
- More tech details in [Nuxeo Themes]
-- [listComponents|http://explorer.nuxeo.org/nuxeo/site/distribution/current/listComponents] to find all components mentioning "theme"
-- [listSeamComponents|http://explorer.nuxeo.org/nuxeo/site/distribution/current/listSeamComponents] to find all SEAM components mentioning "theme"
- It seems templates define only layout of the whole application - and more specifically, the Document Management section. There seems not to be nested templates.

h1. Theme Editor
- The theme editor from Chamlers is now integrated within Nuxeo 5.5 and it works with the JSF/Seam UI.
!theme_manager.png!
-- Unfortunately, it seems rather unstable and I could not create a new theme with it.
TODO: report to the NUXEO Jira, and check if it's already reported and track it
-- The editor is a graphical tool for editing the theme xml file. We can edit the config XML manually to achieve a desired layout
!theme_manager_xml.png!

!theme_manager.png|thumbnail,width=200!
Unfortunately, it seems rather unstable and I could not create a new theme with it.

It seems templates define only layout of the whole application - and more specifically, the Document Management section. There seems not to be nested templates.

The editor basically is a graphical tool for editing the theme xml file:

!theme_manager_xml.png|thumbnail!

h4. Customizing a theme

These are the steps that I have found working for modifying the layout.

- I downloaded the theme-galaxy.xml from the Theme Editor. This is the default theme.

- I renamed it to theme-mytheme.xml and put it in the the resources/themes in the contribution project. There is the OSGI-INF/theme-contrib.xml as well where we specify:
{code}
<extension target="org.nuxeo.theme.services.ThemeService" point="themes">
This effectively outputs the logo after the footer.

h41. Questions

In theme-mytheme.xml:
Types seem to be:

* *"generic fragment"*: predefined nuxeo fragments like "nuxeo5 clip board" or "nuxeo5 breadcrumbs". (?) &nbsp;What are all possible fragments? (See here: [http://explorer.nuxeo.org/nuxeo/site/distribution/Nuxeo%20DM-5.3.2/viewComponent/org.nuxeo.theme.fragments|http://explorer.nuxeo.org/nuxeo/site/distribution/Nuxeo%20DM-5.3.2/viewComponent/org.nuxeo.theme.fragments]a and&nbsp;[http://explorer.nuxeo.org/nuxeo/site/distribution/Nuxeo%20DM-5.3.2/viewContribution/org.nuxeo.theme.nuxeo.default--views|http://explorer.nuxeo.org/nuxeo/site/distribution/Nuxeo%20DM-5.3.2/viewContribution/org.nuxeo.theme.nuxeo.default--views]) [theme.fragments|http://explorer.nuxeo.org/nuxeo/site/distribution/Nuxeo%20DM-5.3.2/viewComponent/org.nuxeo.theme.fragments] and [default--views|http://explorer.nuxeo.org/nuxeo/site/distribution/Nuxeo%20DM-5.3.2/viewContribution/org.nuxeo.theme.nuxeo.default--views])
* *"region fragment"*: (?) &nbsp;What is this? For the corresponding fragment we have&nbsp;<view>facelet region</view>. What does it mean? Where does it say what content to include?

h41. Links
- [Theme doc|http://doc.nuxeo.com/display/NXDOC/Theme]
- [ui--shortcutshttp://explorer.nuxeo.org/nuxeo/site/distribution/Nuxeo%20DM-5.3.2/viewContribution/org.nuxeo.theme.editor.ui--shortcuts] (
Interesting!)
[http://doc.nuxeo.com/display/NXDOC/Theme|http://doc.nuxeo.com/display/NXDOC/Theme]

Interesting:&nbsp;[http://explorer.nuxeo.org/nuxeo/site/distribution/Nuxeo%20DM-5.3.2/viewContribution/org.nuxeo.theme.editor.ui--shortcuts|http://explorer.nuxeo.org/nuxeo/site/distribution/Nuxeo%20DM-5.3.2/viewContribution/org.nuxeo.theme.editor.ui--shortcuts]