LSTA EAD stylesheet installation instructions

• For hosts using Contentdm
• For hosts not using Contentdm

For hosts using Contentdm

Prerequisites

• Contentdm 4 or higher
• PHP 5 or higher
• PHP5 XML support through DOMDocument (enabled by default)
• PHP5 XSL support through XSLTProcessor (included by default, but not always enabled)

  To determine whether your server meets the PHP requirements, view the output of phpinfo(). There should be both an 'xml' section and an 'xsl' section. If the 'xsl' section is missing, you may need to enable the xsl extension in the php.ini file, by uncommenting the proper "extension=" line. For additional information see http://php.net/manual/en/book.xsl.php.

Copy CSS and Image files

1. Copy the Contentdm/cdm4/ead_css/ directory to your server's /cdm4/ directory.
   • The files should now be in the [Contentdm document root]/cdm4/ead_css/ directory on your server.

     *Note*: If you choose to copy these files to a different directory you will need to update the two <link> tags in the ss-committee-cdm.xsl to reflect this change.

2. Copy the Contentdm/cdm4/ead_images/ directory to your server's /cdm4/ directory.
   • The files should now be in the [Contentdm document root]/cdm4/ead_images/ directory on your server.

     *Note*: If you choose to copy these files to a different directory you will need to update the seven image URLs in stylesheet-committee.css to reflect this change.

Copy XSL Transform files

• Copy the Contentdm/cdm4/includes/xsl/ directory to your server's /cdm4/includes directory.
  • The files should now be in the [Contentdm document root]/cdm4/includes/xsl/ directory on your server.

    *Note*: If you choose to copy these files to a different directory you will need to update the $xsl_dir variable in basic_view_ead.php to reflect this change.

Set up Contentdm modification

1. Merge Contentdm/cdm4/includes/basic_view.php from this package with your current [CDM document root]/cdm4/includes/basic_view.php .

   Be sure to make a backup copy of your current basic_view.php first!

   • If you have Contentdm 4.3 and haven't already modified this file, you can overwrite your current file with this one.
   • If you have Contentdm 4.3 and have already modified this file, the changes will have to be merged manually.
   • For Contentdm versions prior to 4.3 the changes will have to be merged manually.

     If you need to manually merge your files, make sure to copy only the changes marked by the "EAD CUSTOMIZATION" label. Copying any of the other Contentdm v4.3 changes to a v4.2 copy of basic_view.php will cause unpredictable, undesirable results.

2. Configure basic_view.php
   • Change "/eadcollection" to your EAD collection's alias in the following line:
     if( "/eadcollection" == urldecode($_GET['CISOROOT']) && strtolower(substr($filename, -4)) == '.xml' )
   • If you have multiple Contentdm collections containing EAD files, you'll need to create an array of collection aliases and use the in_array() function, as follows:
     $ead_collections = array("/eadcollection1", "/eadcollection2", "/eadcollection3"); if( in_array(urldecode($_GET['CISOROOT']), $ead_collections) && strtolower(substr($filename, -4)) == '.xml' )
3. [optional]: Modify the ss-committee-container.xsl file to ensure the container list meets the needs your institution.
4. [optional]: Modify the stylesheet-committee.css file to reflect your institution's branding.

For hosts not using Contentdm

It's assumed that these hosts already know how to apply an XSL stylesheet to their EAD items, using SAXON or some other XSL processor.

1. Copy the ss-committee.xsl and ss-committee-container.xsl files from the /non-Contentdm directory to your desired XSLT directory.
2. Copy the stylesheet-committee.css and stylesheet-committee-IE.css files from the /non-Contentdm/ead_css/ directory to your desired, web-accessible CSS directory.

   Note: If you are displaying your EAD files in another content management system its CSS may interfere with the desired EAD display. If this is happening, try using the stylesheet-committee.css file from the /Contentdm directory. This copy uses more specific CSS selectors which minimize interference from other stylesheets, but also make it more difficult to override its rules.

3. Update the <link> tags in ss-committee.xsl to ensure that the href attribute reflects the correct location of the .css stylesheets.
4. Copy the contents of the /non-Contentdm/ead_images/ directory to your desired, web-accessible image directory.
5. Update the image URLs in stylesheet-committee.css to reflect the directory chosen in the step above. There should be seven (7) references, all of which start with /ead_images/.
6. [optional]: Modify the ss-committee-container.xsl file to ensure the container list meets the needs your institution.
7. [optional]: Modify the stylesheet-committee.css file to reflect your institution's branding.