Primo Basic UI using Custom Tiles
Tags: intermediate
, elympics
Last Updated: Mar 31, 2011 16:15
- Description
This contribution uses back office settings, custom JSPs, custom css files and a few static HTML files to present a simpler, more basic, UI for Primo. The design of this UI was based on David Walker's Xerxes css. It also allows for a view to "hijack" a tab to send to a different application. This could be useful for unifying several systems into a single look and feel. The generic example links out to the Databases A-Z list generated by David Walker's Xerxes demo and the Journals A-Z list generated by the SFX instance at ExLibris. This allows users to look to one place for research needs and designers to create uniform UIs for a variety of integrated systems. The side bar also allows additional links (from Primo's "Main Menu") to be set through the back office.
- Author: Scot Dalton
- Additional author(s):
- Institution: New York University
- Year: 2009
- License: BSD style
- Short description: Use, modification and distribution of the code are permitted provided the copyright notice, list of conditions and disclaimer appear in all related material.
- Link to terms: [Detailed license terms]
- Skill required for using this code:
Intermediate.
State
In Development
Programming language
JSP, HTML, CSS
Software requirements
Primo 2.1.5 (I think.)
Screen captures
Author(s) homepage
Download
Working example
http://bobcatdev.library.nyu.edu/primo_library/libweb/action/search.do?vid=BASICRD http://bobcatdev.library.nyu.edu/primo_library/libweb/action/search.do?vid=NYURD
In production in a Beta capacity at http://bobcat.library.nyu.edu/nyurd
Using the following Ex Libris open interfaces
Primo custom tiles
Changes
Version 1.0
Initial Release
Release notes
Initial Release
Installation instructions
The installation can be divided into two sets of work: Front End Server(s) and Back Office.
Front End Server(s)
Place the attached code on your front end server(s) in the appropriate directories as specified below.
JSP
- primo_basic/views/include/* -> primo_library-libweb.war/views/include (This will overwrites existing files to comment out a javascript file that causes errors.)
- primo_basic/views/custom -> primo_library-libweb.war/views/
CSS - primo_basic/views/css custom directory goes in the primo_library-libweb.war/css/
Add the css files to your mapping table in the back office and configure your view to use them. 
To add your libraries banner, just add it as a background image in the custom/basic/basic.css. HTML
- primo_basic/static_htmls/custom -> primo_library-libweb.war/static_htmls
Configure your view to use these files in the back office. locale/lang/css/Primo_Locale.css loads in the e-Shelf and tags page. At NYU we removed the styles from this file.
Back Office
The back office configuration has two parts: Custom Layout Configuration and Additional Code Table Configuration
Custom Layout Configuration
Create view as you would and select Layout Set: "customized layout".
Then configure the customized layouts according to the following screen shots.
| Default Ex Libris divs and tiles have the suffix EXL. You should drag and drop these as is. |
| The following custom divs and tiles should have both css id and css class set:
Otherwise all custom divs and tiles only require css id as specified in screen shots. |
Home Page
Brief Result
Full Display
Additional Code Table Configuration
- Views Table (where VID = your particular view id)
- VID.breadcrumbs.separator = >
- VID.breadcrumbs.base.title = Your Library
- VID.breadcrumbs.base.url = http://library.you.edu
- VID.tabbedmenu.hijack.(tab code, e.g. journals).url
- example VID.tabbedmenu.hijack.journals.url = http://sfx.exlibrisgroup.com/sfxlcl3/a-z
When creating a tab for hijacking you must select a scope. We chose our "all" scope to be able to save.
- VID.mainmenu.title = More Options
TO DO list
- Clean up e-Shelf and tags css.
- Add search specific links to the side bar based on code table configuration.
Known issues
- Deep links don't seem to work with custom tiles
- Tags and e-Shelf don't inherit from custom layouts
Comments