It is possible to add custom html to home page header, and news sections, by setting cris.cms.home-header and cris.cms.home-news metadata. Html code can be used to set metadata values.

Administrators can access this functionality from the navigation menu.

Metadata value can be different for each configured language in DSpace-CRIS instance.

cris.cms.home-header allows to add a custom html text to home page header, this html will replace the header defined by theme in use.


cris.cms.home-news metadata is used to define a custom text in home news section, theme default background is preserved.

Custom CMS metadata

Further custom CMS metadata, whose value can be set by administrator by mean of Edit CMS metadata section, can be defined. They need to be added to metadata registry (REST side) and to cms.metadatalist array in angular environment configuration file (FrontEnd side).

Those custom metadata can be used together with Cris Sections configuration, this means that its value can be displayed either in the home page or in other explore sections.

By recalling one or many of those user-defined metadata in any cris section of cris-sections.xml configuration, the administrator can have their content displayed in a user-defined part of the home page or of an explore section.

For example, this xml bean, in cris-sections.xml configuration, related to a simple text component.

<bean class="org.dspace.layout.CrisLayoutTextRowComponent">
  <property name="contentType" value="text-metadata"/>
  <property name="content" value="cris.cms.custom"/>
  <property name="style" value="style"/>
</bean>

will instruct page rendering logic to render a simple text among other parts of home page (in case of “site” section) / explore. Actual Content of this component will be the one which is defined within the cris.cms.custom metadata value. cris.cms.custom in this example is user defined, this means that needs to be added to registry and angular environment configuration as specified in previous paragraph.

Setting those metadata allows DSpace-CRIS administrators to customize part of the content home page or of a given explore section, or predefined home page parts like header and news sections, by editing a metadata value, without having to restart or re-compile the whole instance.


  • No labels