GetThis feature + Regex config file support

config/vufind/GetThis.yaml

@@ -0,0 +1,61 @@
+---
+# This file contains the settings for the GetThis feature
+
+# Either to display the copy number (next to the call number), default false
+showCopyNumber: true
+
+# The order changes the order it's displayed
+#template_name_within_get-this:
+#  enabled: true/false
+#  condition_function: my_function_within_GetThisLoader (optional / can be a list), the function can be negated with leading "!"
+#  view_variables:
+#    - my_var: Value
+#    - my_link_with_placeholder: https://mylib.edu/{{location}}/open_hours # Placeholder can be used
+# If the function does not exist, the condition will evaluate to false
+# Exemple of nested conditions
+#  holdings:
+#    conditions:
+#      - conditions:
+#          - conditions:
+#              - condition_function: showHoldings
+#              - and
+#              - condition_function: and_other_function
+#          - condition_function: showHoldings
+#      - conditions:
+#          - condition_function: showHoldings
+#          - condition_function: or_other_function
+#      - condition_function: showHoldings
+templates:
+  holdings:
+    condition_function: showHoldings
+
+  biblio-info:
+    enabled: true
+
+  micro-form:
+    condition_function: showMicroForm
+    view_variables:
+      open_hours: https://your_lib.edu/hours
+
+  message:
+    condition_function: showMessage
+
+  staff-office-delivery:
+    condition_function: showStaffDelivery
+    view_variables:
+      general_link: https://your_lib.msu.edu/facstaffdelivery
+      request_link: https://interlib.your_lib.edu/request_link/{{title}}?author={{author}}&rft.isbn={{isbn}}&loc={{location}}&callno={{callNum}}&CAT=1
+
+
+  inter-library:
+    condition_function: showInterLibrary
+    view_variables:
+      general_link: https://your_lib.edu/ils/
+      request_link: https://interlib.your_lib.edu/request_link/{{title}}?author={{author}}&rft.isbn={{isbn}}&loc={{location}}&callno={{callNum}}&CAT=1
+
+
+  remote-delivery:
+    condition_function: showRemotePatron
+    view_variables:
+      general_link: https://your_lib.edu/ils/distance
+      request_link: https://interlib.your_lib.edu/request_link/{{title}}?author={{author}}&rft.isbn={{isbn}}&loc={{location}}&callno={{callNum}}&CAT=1

config/vufind/Regex.yaml

@@ -0,0 +1,56 @@
+---
+# This file contains the settings for the Regex feature
+
+# Status
+AVAILABLE:
+  - '/^AVAILABLE/i'
+  - '/ITEM IN LIBRARY/i'
+LIB_USE_ONLY:
+  - '/RESTRICTED/i'
+OUT:
+  - '/CHECKED/i'
+  - '/BILLED/i'
+  - '/ON SEARCH/i'
+  - '/LOST/i'
+  - '/HOLD/i'
+  - '/AWAITING PICKUP/i'
+  - '/AWAITING DELIVERY/i'
+  - '/IN TRANSIT/i'
+  - '/PAGES/i'
+UNAVAILABLE:
+  - '/AGED TO LOST/i'
+  - '/CLAIMED RETURNED/i'
+  - '/DECLARED LOST/i'
+  - '/IN PROCESS/i'
+  - '/IN PROCESS (NON-REQUESTABLE)/i'
+  - '/LONG MISSING/i'
+  - '/LOST AND PAID/i'
+  - '/MISSING/i'
+  - '/ON ORDER/i'
+  - '/ORDER CLOSED/i'
+  - '/UNKNOWN/i'
+  - '/WITHDRAWN/i'
+
+# Description / Call Number
+AV_MEDIA:
+  - '/DISC/i'
+  - '/VIDEO/i'
+  - '/CD/i'
+  - '/DVD/i'
+  - '/BLU-RAY/i'
+  - '/VINYL/i'
+  - '/AUDIOCASSETTE/i'
+
+# Location
+EXCLUSIVE:
+#  - CAMPUS
+MICROFORMS:
+  - '/MICROFORMS/i'
+ONLINE:
+  - '/ONLINE RESOURCE/i'
+  - '/ELECTRONIC RESOURCES/i'
+  - '/INTERNET/i'
+
+# Format
+SERIAL:
+  - '/SERIAL/i'

config/vufind/config.ini

@@ -2191,6 +2191,10 @@ includeSchemaOrgMetadata = true
 ; If set to "numerical", it will sort numerically by MARC tag.
 ;marcSubjectHeadingsSort = "numerical"
 
+; Enable the link for the get this feature
+; The get this feature opens a lightbox with information on how to get the record
+;getThisEnabled = true
+
 ; The following two sections control the Alphabetic Browse module.
 [AlphaBrowse]
 ; This setting controls how many headings are displayed on each page of results:

languages/en.ini

@@ -70,6 +70,7 @@ All Text = "All Text"
 alphabrowse_matches = "Results"
 alphabrowselink_html = 'Browse entries by %%index%% starting from <a href="%%url%%">%%from%%</a>.'
 Alternate Title = "Alternate Title"
+Alternative = "Alternative"
 Always ask me = "Always ask me"
 An error has occurred = "An error has occurred"
 An error occurred during execution; please try again later. = "An error occurred during execution; please try again later."
@@ -195,6 +196,9 @@ By Topic = "By Topic"
 cached_record_warning = "This record is not available in the search index. Last cached version is shown."
 Call Number = "Call Number"
 callnumber_abbrev = "Call #"
+campus_pickup = "On-Campus Pickup"
+campus_pickup_place_request = "Place Request for On-Campus Pickup"
+campus_pickup_place_request_text = "We will hold materials for pickup at the campus library of your choice, or you may pick up materials at a self-service locker. (All patrons)"
 Cannot find record = "Cannot find record"
 Cannot find similar records = "Cannot find similar records"
 cannot set = "Cannot set"
@@ -301,6 +305,7 @@ Cookie Settings = "Cookie Settings"
 Coordinates = "Coordinates"
 Copies = "Copies"
 Copy = "Copy"
+copy_number = "Copy #%%number%%"
 copy_to_clipboard_button_label = "Copy to clipboard"
 copy_to_clipboard_failure_message = "Copying to clipboard failed"
 copy_to_clipboard_success_message = "Successfully copied to clipboard"
@@ -353,6 +358,10 @@ delete_selected_favorites = "Delete Selected Saved Items"
 delete_tag = "Delete Tag"
 delete_tags = "Delete Tags"
 delete_tags_by = "Delete Tags By"
+delivery_request = "Request Delivery"
+delivery_request_distance = "Distance Delivery Services"
+delivery_request_distance_text = "We deliver materials directly to your home, free of charge, via UPS. Shipping is limited to anywhere in the US or Canada. (Students, Faculty and Staff only)"
+delivery_request_distance_user = "Request Item as Distance User"
 Department = "Department"
 Description = "Description"
 Descriptors = "Descriptors"
@@ -740,6 +749,7 @@ Institutional Login = "Institutional Login"
 institutional_login_desc = "Enter your campus-wide username and password."
 Instructor = "Instructor"
 Interlibrary Loan Requests = "Interlibrary Loan Requests"
+interlibrary_loan_requests_text = "Request materials through the Inter-library Loan Request Form. Typically available for pickup in 3-14 business days (Students, Staff and Faculty only)"
 Internet = "Internet"
 interval_captcha_not_passed = "This action can only be performed after %%delay%% seconds."
 Invalid Patron Login = "Invalid Patron Login"
@@ -855,6 +865,7 @@ Message = "Message"
 Message From Sender = "Message From Sender"
 Metadata Prefix = "Metadata Prefix"
 Microfilm = "Microfilm"
+microform_viewing_request_text = "Microform materials can be accessed at the Main Library during %%link_start%%open hours%%link_end%%. Please note remotely held materials will have to be requested in advance using the Remote Storage Request."
 MLA Citation = "MLA Citation"
 MLA Edition Citation = "MLA (9th ed.) Citation"
 Mobile Number = "Mobile Number"
@@ -932,6 +943,7 @@ nohit_query_without_filters = "Remove all filters from this search."
 nohit_spelling = "Perhaps you should try some spelling variations"
 nohit_suggest = "You may want to try to revise your search phrase by removing some words or check your spelling."
 NOT = "NOT"
+Not Available = "Not Available"
 Not Illustrated = "Not Illustrated"
 Not On Reserve = "Not On Reserve"
 not_applicable = "n/a"
@@ -1417,6 +1429,8 @@ Source Title = "Source Title"
 spell_expand_alt = "Expand Search"
 spell_suggest = "Search alternatives"
 Staff View = "Staff View"
+staff_office_delivery = "Faculty/Staff Office Delivery"
+staff_office_delivery_text = "We deliver materials to your on-campus office, free of charge, typically within 3-5 business days. (Staff and Faculty only)"
 standalone_record_link = "Standalone Record"
 Start a new Advanced Search = "Start a new Advanced Search"
 Start a new Basic Search = "Start a new Basic Search"
@@ -1586,6 +1600,7 @@ View Retraction Notice = "View Retraction Notice"
 View this record in EBSCOhost = "View this record in EBSCOhost"
 view_already_selected = "%%current%% view already selected"
 view_in_opac = "View in OPAC"
+viewing_request = "Request Viewing"
 visual_facet_parent = "From"
 Volume = "Volume"
 Volume Holdings = "Volume Holdings"

languages/fr.ini

@@ -66,6 +66,7 @@ All Pages Loaded = "Toutes les pages chargées"
 All Text = "Tout le texte"
 alphabrowse_matches = "Résultats"
 alphabrowselink_html = 'Parcourir par %%index%% à partir de <a href="%%url%%">%%from%%</a>.'
+Alternative = "Alternative"
 Always ask me = "Toujours me demander"
 An error has occurred = "Une erreur est survenue"
 An error occurred during execution; please try again later. = "Erreur lors de l'exécution de la commande. Veuillez réessayer plus tard."
@@ -184,6 +185,9 @@ By Topic = "par sujet"
 cached_record_warning = "Cette notice n'est pas disponible dans l'index de recherche. La version affichée est la dernière enregistrée dans le cache."
 Call Number = "Cote"
 callnumber_abbrev = "Cote :"
+campus_pickup = "Retrait sur le campus"
+campus_pickup_place_request = "Faire une demande de retrait sur campus"
+campus_pickup_place_request_text = "Nous mettrons de côté les ressources demandées dans la bibliothèque de votre choix, ou vous pouvez les retirer dans un casier en libre-service. (Tous les usagers)"
 Cannot find record = "Notice introuvable"
 Cannot find similar records = "Pas de notices similaires trouvées"
 cannot set = "Ne peut pas être modifié"
@@ -281,6 +285,7 @@ Cookie Settings = "Configuration des cookies"
 Coordinates = "Coordonnées"
 Copies = "Exemplaires"
 Copy = "Exemplaire"
+copy_number = "Exemplaire N°%%number%%"
 copy_to_clipboard_button_label = "Copier vers le presse-papier"
 copy_to_clipboard_failure_message = "Échec de la copie vers le presse-papier"
 copy_to_clipboard_success_message = "Copié avec succès vers le presse-papier"
@@ -330,6 +335,10 @@ delete_selected_favorites = "Supprimer les favoris sélectionnés"
 delete_tag = "Supprimer le tag"
 delete_tags = "Supprimer les tags"
 delete_tags_by = "Supprimer les tags par"
+delivery_request = "Me faire livrer"
+delivery_request_distance = "Livraison à distance"
+delivery_request_distance_text = "Nous livrons à votre domicile, gratuitement, via UPS. La livraison est limitée aux USA et au Canada. (étudiants et employés uniquement)"
+delivery_request_distance_user = "Se faire livrer à distance"
 Department = "Département"
 Description = "Description"
 Desired Username = "Nom d'utilisateur souhaité"
@@ -683,6 +692,7 @@ Institutional Login = "Accéder à votre institution"
 institutional_login_desc = "Entrez votre identifiant institutionnel et votre mot de passe."
 Instructor = "Professeur"
 Interlibrary Loan Requests = "Demandes de prêt entre bibliothèques"
+interlibrary_loan_requests_text = "Demander un prêt entre bibliothèques via le formulaire. Généralement prêt sous 3-14 jours ouvrables (étudiants et employés uniquement)"
 Internet = "Internet"
 interval_captcha_not_passed = "Il n'est possible de réaliser cette action qu'après un délai de %%delay%% secondes."
 Invalid Patron Login = "Identifiant lecteur invalide"
@@ -792,6 +802,7 @@ Message = "Message"
 Message From Sender = "Message de l'expéditeur"
 Metadata Prefix = "Préfixe des métadonnées"
 Microfilm = "Microfilm"
+microform_viewing_request_text = "Les ressources microform peuvent être consulter pendant les %%link_start%%horaires d'ouverture%%link_end%% de la bibliothèque. Veuillez noter, les ressources gardées à distance devront être demandées en avance via le formulaire approprié."
 MLA Citation = "Style de citation MLA"
 MLA Edition Citation = "Style de citation MLA (9e éd.)"
 Mobile Number = "Numéro de téléphone portable"
@@ -860,6 +871,7 @@ nohit_query_without_filters = "Supprimer tous les filtres de cette recherche."
 nohit_spelling = "Essayez une orthographe différente."
 nohit_suggest = "Vérifiez votre recherche en supprimant des mots-clés et en vérifiant l'orthographe."
 NOT = "PAS"
+Not Available = "Non-disponible"
 Not Illustrated = "Sans illustrations"
 Not On Reserve = "Non réservé"
 not_applicable = "n/a"
@@ -1278,6 +1290,8 @@ Source Title = "Titre de la source"
 spell_expand_alt = "Recherche élargie"
 spell_suggest = "Recherches alternatives"
 Staff View = "Affichage MARC"
+staff_office_delivery = "Livraison au bureau (employés)"
+staff_office_delivery_text = "Nous livrons des ressources à votre bureau sur le campus, gratuitement, généralement sous 3-5 jours ouvrés. (Employés uniquement)"
 Start a new Advanced Search = "Nouvelle recherche avancée"
 Start a new Basic Search = "Nouvelle recherche simple"
 Start Page = "Page d'accueil"
@@ -1440,6 +1454,7 @@ View Retraction Notice = "Voir l'avis de rétractation"
 View this record in EBSCOhost = "Voir cette notice dans EBSCOhost"
 view_already_selected = "%%current%% voir les éléments déjà sélectionnés"
 view_in_opac = "Voir à l'OPAC"
+viewing_request = "Demande de consultation"
 visual_facet_parent = "De"
 Volume = "Volume"
 Volume Holdings = "Indications des volumes"

module/VuFind/config/module.config.php

@@ -465,6 +465,7 @@
             'VuFind\Favorites\FavoritesService' => 'VuFind\Favorites\FavoritesServiceFactory',
             'VuFind\Form\Form' => 'VuFind\Form\FormFactory',
             'VuFind\Form\Handler\PluginManager' => 'VuFind\ServiceManager\AbstractPluginManagerFactory',
+            'VuFind\GetThis\GetThisLoader' => 'VuFind\GetThis\GetThisLoaderFactory',
             'VuFind\GeoFeatures\BasemapConfig' => 'VuFind\GeoFeatures\AbstractConfigFactory',
             'VuFind\GeoFeatures\MapTabConfig' => 'VuFind\GeoFeatures\AbstractConfigFactory',
             'VuFind\GeoFeatures\MapSelectionConfig' => 'VuFind\GeoFeatures\AbstractConfigFactory',
@@ -513,6 +514,7 @@
             'VuFind\RecordDriver\PluginManager' => 'VuFind\ServiceManager\AbstractPluginManagerFactory',
             'VuFind\RecordTab\PluginManager' => 'VuFind\ServiceManager\AbstractPluginManagerFactory',
             'VuFind\RecordTab\TabManager' => 'VuFind\RecordTab\TabManagerFactory',
+            'VuFind\Regex\Regex' => 'VuFind\Regex\RegexFactory',
             'VuFind\Related\PluginManager' => 'VuFind\ServiceManager\AbstractPluginManagerFactory',
             'VuFind\Resolver\Driver\PluginManager' => 'VuFind\ServiceManager\AbstractPluginManagerFactory',
             'VuFind\Role\PermissionDeniedManager' => 'VuFind\Role\PermissionDeniedManagerFactory',
@@ -778,6 +780,7 @@
     'AddComment', 'DeleteComment', 'AddTag', 'DeleteTag', 'Save', 'Email', 'SMS',
     'Cite', 'Explain', 'Export', 'RDF', 'Hold', 'Home', 'StorageRetrievalRequest',
     'AjaxTab', 'ILLRequest', 'PDF', 'Epub', 'LinkedText', 'Permalink', 'Rating',
+    'GetThis',
 ];
 
 // Define dynamic routes -- controller => [route name => action]

module/VuFind/src/VuFind/AjaxHandler/GetItemStatuses.php

@@ -37,6 +37,7 @@
 use Laminas\View\Renderer\RendererInterface;
 use VuFind\Config\Config;
 use VuFind\Exception\ILS as ILSException;
+use VuFind\GetThis\GetThisLoader;
 use VuFind\I18n\Translator\TranslatorAwareInterface;
 use VuFind\ILS\Connection;
 use VuFind\ILS\Logic\AvailabilityStatusInterface;
@@ -82,14 +83,16 @@ class GetItemStatuses extends AbstractBase implements
      * @param RendererInterface         $renderer                  View renderer
      * @param Holds                     $holdLogic                 Holds logic
      * @param AvailabilityStatusManager $availabilityStatusManager Availability status manager
+     * @param ?GetThisLoader            $getThis                   Get this loader or null if not enabled
      */
     public function __construct(
         SessionSettings $ss,
         protected Config $config,
         protected Connection $ils,
         protected RendererInterface $renderer,
         protected Holds $holdLogic,
-        protected AvailabilityStatusManager $availabilityStatusManager
+        protected AvailabilityStatusManager $availabilityStatusManager,
+        protected ?GetThisLoader $getThis,
     ) {
         $this->sessionSettings = $ss;
     }
@@ -279,6 +282,17 @@ protected function getItemStatus(
         $locationSetting,
         $callnumberSetting
     ) {
+        if (isset($this->getThis)) {
+            $urlHelper = $this->renderer->plugin('url');
+            $itemIdParams = !empty($record[0]['item_id']) ? ['query' => ['item_id' => $record[0]['item_id']]] : null;
+            $getThisURI = $urlHelper(
+                'record-getthis',
+                ['id' => $record[0]['id']],
+                $itemIdParams
+            );
+        } else {
+            $getThisURI = '';
+        }
         // Summarize call number, location and availability info across all items:
         $callNumbers = $locations = [];
         $services = [];
@@ -331,6 +345,7 @@ protected function getItemStatus(
             'reserve_message'
                 => $this->translate($reserve ? 'on_reserve' : 'Not On Reserve'),
             'callnumberHtml' => $this->renderCallnumbers($callnumberSetting, $callNumber),
+            'getThisURI' => $getThisURI,
         ];
     }
 
@@ -463,6 +478,7 @@ protected function renderFullStatus($record, $simpleStatus, array $values = [])
 
         $values = array_merge(
             [
+                'getThis' => $this->getThis,
                 'statusItems' => $record,
                 'simpleStatus' => $simpleStatus,
                 'callnumberHandler' => $this->getCallnumberHandler(),

module/VuFind/src/VuFind/AjaxHandler/GetItemStatusesFactory.php

@@ -69,13 +69,17 @@ public function __invoke(
         if (!empty($options)) {
             throw new \Exception('Unexpected options passed to factory.');
         }
+        $config = $container->get(\VuFind\Config\PluginManager::class)->get('config');
+        $getThisEnabled = ($config?->Record?->getThisEnabled ?? null) == true;
+        $getThis = $getThisEnabled ? $container->get(\VuFind\GetThis\GetThisLoader::class) : null;
         $handler = new $requestedName(
             $container->get(\VuFind\Session\Settings::class),
-            $container->get(\VuFind\Config\PluginManager::class)->get('config'),
+            $config,
             $container->get(\VuFind\ILS\Connection::class),
             $container->get('ViewRenderer'),
             $container->get(\VuFind\ILS\Logic\Holds::class),
-            $container->get(\VuFind\ILS\Logic\AvailabilityStatusManager::class)
+            $container->get(\VuFind\ILS\Logic\AvailabilityStatusManager::class),
+            $getThis,
         );
         $handler->setSorter($container->get(\VuFind\I18n\Sorter::class));
         return $handler;