Differences

This shows you the differences between two versions of the page.

--- en:user:favourites [2024/02/12 23:42] – [Customizing Favourites] kjdon
+++ en:user:favourites [2025/10/03 00:55] (current) – [Disable Favourites for one collection] kjdon
@@ Line 2: / Line 2: @@
 ====== Greenstone 3 Favourites ======
-//[ This page documents favourites for Greenstone 3 version 3.11. For 3.10 and earlier versions, please see our [[en:user:berry_baskets| Berry Baskets]] page. ]//
+//[ This page documents favourites for Greenstone 3 version 3.11 and later. For 3.10 and earlier versions, please see our [[en:user:berry_baskets| Berry Baskets]] page. ]//
 The favourites functionality allows the user to collect up a set of interesting or useful documents as she is browsing through the library. Once they are finished, they can view the basket of links, and email it to themselves.
@@ Line 14: / Line 14: @@
 A library can enable the favourites functionality using a servlet option. Favourites are enabled by default. To disable, please edit resources/web/servlets.xml.in, and set the **favouritebasket** parameter to **false** in the servlet description for the library you want to change.
-A user can enable/disable favourites for themselves (assuming the library provides the funtionality) on the preferences page. Favourites are enabled for the user by default. To set them to be disabled by default,  set a paramDefault in web/sites/localsite/siteConfig.xml (or in the siteConfig.xml of the site you are using for the library). This format element goes at the top level of the siteConfig element.
+A user can enable/disable favourites for themselves (assuming the library provides the funtionality) on the preferences page. Favourites are enabled for the user by default. To set them to be disabled by default (for the entire library), set a paramDefault in web/sites/localsite/siteConfig.xml (or in the siteConfig.xml of the site you are using for the library). This format element goes at the top level of the siteConfig element.
 <code>
@@ Line 22: / Line 22: @@
 </code>
+Note, this doesn't completely disable favourites, it just makes them turned off by default, and a user can turn them back on in Preferences.
+Second note, if you are testing this you may need to use a private browser window. Greenstone stores your settings between sessions and if it has stored the favourites being on, then this changing this setting in the library won't affect your current stored session.
+===== Disable Favourites for one collection =====
+If you would like to turn off favourites just for one collection, you can add a custom gslib.xsl into the collection's transform folder. Use the Files tab in GLI (Greenstone 3.12) to do this, or locate the collection at web/sites/localsite/collect/<collname>. You may need to create the transform folder if the collection doesn't already have one.
+Open a new file in the transform folder called gslib.xsl and add the following as its contents.
+<code>
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet version="1.0"
+  xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+  xmlns:xslt="http://www.w3.org/1999/XSL/Transform"
+  xmlns:gslib="http://www.greenstone.org/XSL/Library"
+  xmlns:gsf="http://www.greenstone.org/greenstone3/schema/ConfigFormat"
+  xmlns:util="http://org.greenstone.gsdl3.util.XSLTUtil"
+  xmlns:gs3="http://www.greenstone.org/gs3"
+  xmlns:xlink="http://www.w3.org/1999/xlink"
+  xmlns:gsvar="http://www.greenstone.org/skinning-var"
+  exclude-result-prefixes="util xalan gslib gsf xslt gs3 gsvar xlink">
+  <xsl:template name="documentFavouriteForClassifierOrSearchPage"></xsl:template>
+  <xsl:template name="gotoFavourites"></xsl:template>
+</xsl:stylesheet>
+</code>
 ===== Customizing Favourites =====