Primo Basic UI using Custom Tiles

Tags: elympics, intermediate
Last Updated: Nov 20, 2009 00:04

• 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

http://library.nyu.edu

Download

Download the code

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

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: css id = sidebar; css class = sidebar css id = searchBox; css class = searchBox css id = tabs; css class = tabs 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

1. 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