User Tools

Site Tools


en:user:gs3_sample_interface_modifications
This version is outdated by a newer approved version.DiffThis version (2019/10/21 22:18) is a draft.
Approvals: 0/1
The Previously approved version (2019/10/21 20:58) is available.Diff

This is an old revision of the document!


Sample Greenstone3 Interface Modifications

This page provides examples of interface modifications. Many of these changes can be made at either the collection, interface or site level.

See the interfaces page for more general information about customising the interface.

Changing the collection description

The collection's description - shown on the about page - generally comes from the 'description' displayItem in the collection's collectionConfig.xml file. This can only hold text and html. Sometimes you might want to do more in the description.

The place where the description gets printed out is in the about page XSL: web/interfaces/default/transform/pages/about.xsl.

There is a template called coll-description:

<xsl:template name="coll-description">
   <gslib:collectionDescriptionTextAndServicesLinks/>
</xsl:template>

<gslib> elements are shortcuts to predefined templates, and can be found in web/interfaces/default/transform/gslib.xsl. See the gslib page for more details.

Lets leave the collection description displayed as is, but also output "This collection contains X documents, and was last built on Y".

We can redefine the template as:

<xsl:template name="coll-description">
   <gslib:collectionDescriptionTextAndServicesLinks/>
   <xsl:variable name="raw_date"><gslib:collectionMeta name="buildDate"/></xsl:variable>
   The collection contains <gslib:collectionMeta name="numDocs"/> documents, and was last 
   built on <xsl:value-of select="util:formatTimeStamp($raw_date, 0, 0, /page/@lang)"/>.
</xsl:template>

<gslib:collectionMeta> can retrieve metadata elements from the collection (as opposed to from documents). Here we use it to retrieve "numDocs" metadata - the number of documents in the collection - and "buildDate" metadata - the date the collection was last built.

The buildDate metadata element is a timestamp, so is not user friendly. We can use one of our utility functions to format it. Utility functions are defined in src/java/org/greenstone/gsdl3/util/XSLTUtil.java. In this case, we are formatting the timestamp as a date (the second 0). We could also format it as 'days ago' (using 3 instead of 0):

The collection contains <gslib:collectionMeta name="numDocs"/> documents, and was last 
   built <xsl:value-of select="util:formatTimeStamp($raw_date, 0, 3, /page/@lang)"/> days ago.

If we want this text to be displayed in a language dependent manner, then we need to define it in the properties file, (and translate it in the appropriate language properties file), and retrieve it from there.

Total documents in library

The above section shows how to add "this collection contains X number of documents" to a collection's about page. But what if we want to do that for the whole library?

We can add up all the numDocs from each collection using 'sum', and count the number of collections using 'count':

<xsl:template match="/page/pageResponse">
....
<xsl:variable name="totaldocs" select="sum(/page/pageResponse/collectionList/collection/metadataList
/metadata[@name='numDocs'])" />
<xsl:variable name="totalcolls" select="count(/page/pageResponse/collectionList/collection)"/>

<p>This library contains a total of <xsl:value-of select="$totaldocs"/> documents over <xsl:value-of 
select="$totalcolls"/> collections.</p>
....
</xsl:template>

In the default interface, the footer code is located in main.xsl in Greenstone3 → web → interfaces → default → transform → layouts. Near the bottom of the file, you will see the gs_footer template. If you want to change the footer for this interface, simply modify this template (this assumes your image is located in the interface's images folder):

<!-- Template controlling the footer. -->
<xsl:template name="gs_footer">
    <div id="gs_footer" class="ui-widget-header ui-corner-bottom">
        <div id="footer-text">Copyright 2013<br/>
        Greenstone Digital Library<br/>University of Waikato
        </div>
        <div id="footer-image">
            <img src="interfaces/{$interface_name}/images/GB.png"/>
        </div>
    </div>
</xsl:template>

and (optionally) add style to the footer by modifying default → style → core.css, for instance, by adding the following:

#gs_footer {
height: 50px;
}

#footer-text {
width: 50%;
text-align: left;
float: left;
padding-left: 5px;
margin-top: -2px;
}

#footer-image {
width: 49%;
text-align: right;
float: left;
}

To modify the footer for only a specific collection, open the collection in the GLI; in the Format Features section of the Format panel, add the following to the end of the global feature (this assumes your image is located in the collection's images folder):

<xsl:variable name="httpCollection">
    <xsl:value-of select="/page/pageResponse/collection/metadataList/metadata[@name='httpPath']"/>
</xsl:variable>

<!-- Template controlling the footer. -->
<xsl:template name="gs_footer">
    <div id="gs_footer" class="ui-widget-header ui-corner-bottom">
        <div id="footer-text">Copyright 2013<br/>
            Greenstone Digital Library<br/>
            University of Waikato
        </div>
        <div id="footer-image">
            <img src="{$httpCollection}/images/logo.png"/>
            </div>
    </div>
</xsl:template>

To also add style to the footer, create a file called style.css in the collection's style folder with the style above. Then, back in the GLI, still in the global feature of the Format Features section, add:

<!-- Template adding stylesheet to html header -->
<xsl:template name="additionalHeaderContent">
    <link href="{$httpCollection}/style/style.css" rel="stylesheet" type="text/css"/>
</xsl:template>
en/user/gs3_sample_interface_modifications.1571696337.txt.gz · Last modified: 2019/10/21 22:18 by kjdon