en:user:favourites
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
en:user:favourites [2023/07/24 02:14] – kjdon | en:user:favourites [2024/02/12 23:42] (current) – [Customizing Favourites] kjdon | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ====== Greenstone 3 Favourites |
- | //[ This version is for 3.11. For 3.10 and earlier versions, please see our [[en: | + | //[ This page documents favourites |
- | A favourites functionality | + | 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. |
- | Favourites - a star is displayed for each document in browsing and searching lists. Clicking the star will add/remove that document from the favourites list. | + | When favourites are enabled, |
- | A link to the favourites list is displayed on searching | + | A link to the favourites list is also displayed on searching, browsing |
===== Activating Favourites ===== | ===== Activating Favourites ===== | ||
Line 24: | Line 24: | ||
===== Customizing Favourites ===== | ===== Customizing Favourites ===== | ||
+ | The links in the list of favourites can now be customised using format statements (like we use to customise document lists for browsing and searching). | ||
+ | The content of the favourites page is defined in web/ | ||
+ | The default templace for the documentNode is below. This will be used if there is no alternative specified in the FavouriteBasket ServiceRack, | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | |||
+ | </ | ||
+ | |||
+ | The displayFavourite template displays a link to the source doc (eg pdf/image etc) plus the document title which is linked to the greenstone version of the document. The displayPlainText template makes a plain text version, with no HTML markup, suitable for use in an email or in the copy buffer. | ||
+ | |||
+ | web/ | ||
+ | |||
+ | < | ||
+ | < | ||
+ | < | ||
+ | <!-- set the following to true is you have an email service on the server, or if you have setup mail server properties in resources/ | ||
+ | < | ||
+ | <!-- default template used for email/ | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | <!-- default template used for favourites display --> | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | A collection can specify its own customisation for documents from that collection in the favourites list. In this case, we have to put it in a special place: inside a top level ccServices element (cross collection services), specifying which service the format element is for. | ||
+ | |||
+ | For example: | ||
+ | < | ||
+ | < | ||
+ | <format service=" | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | < | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | </ | ||
+ | |||
+ | The first template uses the default display template, but adds on dc.Creator metadata. The second template does away with the default altogether, and displays the dc.Title metadata, followed by the collection name in brackets. A pretty useless display, as it contains no link to the document, but just for illustrative purposes. | ||
===== Setting up the Email Results Functionality ===== | ===== Setting up the Email Results Functionality ===== | ||
The favourites list can be emailed out using a mail server, or by using the user's existing mail client. | The favourites list can be emailed out using a mail server, or by using the user's existing mail client. | ||
+ | |||
Mail server: | Mail server: | ||
- | * the results will be emailed from an address | + | * the results will be emailed from a pre-specified |
* requires the mail server to be set up | * requires the mail server to be set up | ||
* works for all users | * works for all users | ||
Line 43: | Line 98: | ||
If you have a mail server set up on the machine running tomcat, or you want to use another existing mail server, | If you have a mail server set up on the machine running tomcat, or you want to use another existing mail server, | ||
- | Please edit resources/ | + | Please edit resources/ |
< | < |
en/user/favourites.1690164863.txt.gz · Last modified: 2023/07/24 02:14 by kjdon