Theme : add page header


I would like to add a header in the document management pages. By header I mean a new DIV positionned above the table containing the “headers” views (Nuxeo DM logo (Galaxy Theme) / Nuxeo header / nuxeo5 includes).
The main idea is to append a “banner” at the top of the page and just after having the nxHeader.

Updated : The new div will contain one image : horizontal logo big size (a quarter of the width I would say) with a embedded text (inside the image with aweson fonts, color and everything Gimp or whichever graphics softwrae allows). I'm currently searching if I can override the theme view. Basically I would have prefere somehting like the nxFooter view : an unique block easily extensible.

If possible I would like to update the galaxy / default theme : it's easier for me to maintain if I stay on the “standard” in place of writing a full theme (which can break in the future).

Any ideas ?

0 votes

3 answers



Hi Kahlua,

Just to understand better your need about this div: does it contain only text ? Like a warning banner ? Thanks


Update done. Thanks


There are several options:

  1. override this xhtml template that's common to default themes in the application (as Lise explained) using CSS or JavaScript tricks to make it cover the top of the page (as it'll be rendered in a table in the DOM, between the logo and the “includes” fragment). Default themes include the Document Management, Home, Admin Center, DAM views for instance. This template is quite stable (and has been made easier to override partly or completely over the time).

  2. override the default document management theme layout. This layout does not support merging, so as you said, there can be surprises when upgrading. It should not be too hard to upgrade/migrate, but this change will have to be done on each of the themes. There, the custom banner can be placed above the table in the header, in a new section for instance.

  3. another option is to change the main HTML templates used by the theme system, by contributing to the theme extension points. But this will require changing the theme layouts anyway (although with a smaller diff). This may be deprecated in the future, but should be easy to migrate to a newer model. You can search for “section frame” in document-management.xml, and look it up in nxthemes-jsf-contrib.xml to understand where the table comes from, for instance: section-frame.xml.

At some point, the theme layout system may be made closer to the other layout system (handling forms, listings and summary pages), in which case you may need to follow changes around it when maintaining your customization.

Hope this helps

0 votes

Hi François,

I think the better way to customize the header is to override only the nuxeo_header.xhtml file instead of review all the theme.

The original file is here but you can override it by a new nuxeo_header.xhtml with something like:

<div xmlns:ui="">
  <!-- here my div with my awesome banner etc... -->
  <ui:decorate template="/incl/nuxeo_header_template.xhtml" />

This way, you won't modify the theme and the maintenance will be simple. Thanks for the update.

2 votes

Thanks I will try that. My current solution is based on CSS : override the galaxy logo template and use absolute positionning to put my div at 0,0 coordinates :D ugly I know but efficient. I will try your smart answer.



Yes but i guess you don't want to hide the tabs and search in Header, right ?

Something quite not clear for me at this moment. In document-management.xml I have : <widget element="page[1]/section[1]/cell[2]/fragment[1]"> <view>Nuxeo header</view> </widget>

In theme-contrib : <view name="Nuxeo header" template-engine="jsf-facelets"> <format-type>widget</format-type> <template>incl/nuxeo_header.xhtml</template> <resource>screen.css</resource> </view>

And I can customize the nuxeo_header.xhtml is as you mentionned in your answer.

But this content is only the content of the second cell of the nxHeader table. Am I wrong on this assertion ? I didn't test (shame on me) but it seems to me that the awesome div (just before this seam ui decorate) will appear in the table td.
Can you explain in more details the "how this works" please.

Thanks a lot.



Thanks for your answers ; both of you. I chose the first option like I said to Lise. I put out the html flow the Nuxeo galaxy Theme logo content (after overriden it) using absolute postionning (0,0). I didin't want to hide the tabs and search so I add a margin top equals to the size of my logo div content. That did the tricks. I think the JS hack will be less effective : perhaps a blink when the div is moved to its new position. The CSS hack seems fine and well supported by all the browsers (and it is basic css features).

So if I well understood Anahide answer I chose the first option. In the future it can easier to have a empty div as pre-header which can be overriden. This div will live outside the table marked with the nxHeader css class and can be overriden. The problem with the layout is : if I add something at the top of the layout tree then all the indexes are shift.

Hope I'm clear.
Thanks again :)


0 votes


I was thinking yesterday about another solution: what do you think about adding your image in background of the header with CSS and align the tabs and search to bottom ? The logo can be replaced by a transparent png to keep the link on it. What do you think ?


I didn't try because the css hack is OK for the users but I keep your solution in my head (can be useful and will work in my opinion). thanks