This RFC describes small changes to Koha's opac to simplify maintaining css and template changes between different libraries in a single Koha installation, allowing css overrides per branch location depending on the URI used to access the PAC.

This feature is implemented via the web server's capacity to pass environment variables to CGI. Three environment variables are defined:

• opac_css_override : defines a css file to apply after opaclayoutstylesheet and opaccolorstylesheet
• opac_search_limit : defines a search limit to associate with this url.
• opac_limit_override : defines how the opac_search_limit query terms interact with branch limits imposed by the searchmylibraryfirst system preference.

• opaclayoutstylesheet
  • In most cases this will be the stock koha stylesheet.
• opaccolorstylesheet
  • System-wide styles overriding the stock koha stylesheet.
• opac_css_override
  • CSS applied only if Koha is accessed via a specific url.

• opac_search_limit
  • a ccl query limit to add to all searches in this opac interface. common examples:
    • branch: each library in the Koha installation can have its own PAC, with scoped searches.
    • audience: in school libraries, one may wish to have define interfaces based on audience. The css can replace icons with a kid-friendly set, and opac_search_limit add audience-specific search limits.
    • itemtype / collection: a library may wish to offer a separate interface for materials that are available electronically. By cataloging those materials as a specific itemtype or ccode ( or any other ccl-indexed field ), a separate user interface can be built to provide access to these materials.

• opac_limit_override
  • a boolean value describing how the opac_search_limit variable should interact with the searchmylibraryfirst system preference.
    • true : the searchmylibraryfirst branch limit will be ignored, and not applied to searches in this interface.
    • false : the opac_search_limit will be ANDed with the searchmylibraryfirst branch limit.

none

Atuh.pm will pass these vars from CGI to templates.

none; this feature is enabled by creating the env vars in web server configuration.

This feature potentially conflicts with the searchmylibraryfirst sytem preference. If the opac_search_limit is a branch limit, opac_limit_override should be set to true.