Email the service desk after a request is placed

config/vufind/config.ini

@@ -375,6 +375,10 @@ renewals_enabled = false
 ;   if available, but not supported by all drivers)
 title_level_holds_mode = "disabled"
 
+; Email submitted request notifications to and from these addresses
+;holds_email_to = "[email protected]"
+;holds_email_from = "[email protected]"
+
 ; Determines how holdings are grouped in the record display, using fields from
 ; the item information provided by the ILS driver.
 ;

languages/en.ini

@@ -728,6 +728,7 @@ ISBN = "ISBN"
 ISBN/ISSN = "ISBN/ISSN"
 ISSN = "ISSN"
 Issue = "Issue"
+item_barcode = "Item Barcode"
 Item Description = "Item Description"
 Item Notes = "Notes"
 Item removed from favorites = "Item removed from saved items"
@@ -1066,6 +1067,7 @@ password_only_numeric = "Numbers only"
 Passwords do not match = "Passwords do not match"
 past_days = "{range, plural, =1 {Yesterday} =7 {Past Week} other {Past # Days}}"
 patron_account_expires = "Expires"
+patron_barcode = "Patron Barcode"
 patron_status_address_missing = "Your address is missing."
 patron_status_card_blocked = "This library card is blocked from borrowing."
 patron_status_card_expired = "Your library card has expired."
@@ -1221,6 +1223,8 @@ renew_success = "Renewal Successful"
 renew_success_summary = "Successfully renewed {count, plural, =1 {1 item} other {# items}}."
 Renewed = "Renewed"
 Request full text = "Request full text"
+request_email_item_message = "A request was placed for item: %%id%%"
+request_email_subject = "Request Placed for item: %%id%%"
 request_in_transit = "In Transit to Pickup Location"
 request_place_text = "Place a Request"
 request_submit_text = "Submit Request"

module/VuFind/src/VuFind/Controller/HoldsTrait.php

@@ -195,6 +195,7 @@ public function holdAction()
 
                 // Success: Go to Display Holds
                 if (isset($results['success']) && $results['success'] == true) {
+                    $this->emailRequestPlaced($holdDetails);
                     $msg = [
                         'html' => true,
                         'msg' => empty($gatheredDetails['proxiedUser'])
@@ -282,4 +283,55 @@ public function holdAction()
         $view->setTemplate('record/hold');
         return $view;
     }
+
+    /**
+     * Email the successful request to staff as a notification.
+     *
+     * @param array $holdDetails Details about the successful hold request
+     *
+     * @return void
+     */
+    protected function emailRequestPlaced($holdDetails)
+    {
+        $renderer = $this->getViewRenderer();
+        $message = $renderer->render(
+            'Email/request-placed.phtml', ['hold_details' => $holdDetails]
+        );
+
+        $config = $this->getConfig();
+        $to = $this->getEmailRecipient($holdDetails);
+        $from = $config->Catalog->holds_email_from ?? null;
+        if (!$to || !$from) {
+            return;
+        }
+        $subject = $this->translate('request_email_subject', [
+            '%%id%%' => $holdDetails['id'] ?? '',
+            '%%barcode%%' => $holdDetails['barcode'] ?? '',
+        ]);
+        try {
+            $mailer = $this->getService(\VuFind\Mailer\Mailer::class);
+            $mailer->send(
+                $to,
+                $from,
+                $subject,
+                $message
+            );
+        } catch (\VuFind\Exception\Mail $e) {
+            return;
+        }
+    }
+
+    /**
+     * Get the appropriate staff email recipient for a hold request.  This falls back
+     * on a configured default but may be overridden to vary based on the hold details.
+     *
+     * @param array $holdDetails Details about the successful hold request
+     *
+     * @return string The email address
+     */
+    protected function getEmailRecipient($holdDetails)
+    {
+        $config = $this->getConfig();
+        return $config->Catalog->holds_email_to ?? null;
+    }
 }

themes/root/templates/Email/request-placed.phtml

@@ -0,0 +1,19 @@
+<?php // This is a text-only email template; do not include HTML! ?>
+<?=$this->translate('request_email_item_message', ['%%id%%' => $hold_details['id']])?>
+
+
+-----
+
+<?=$this->translate('patron_barcode')?>: <?=$hold_details['patron']['cat_username'] ?? ''?>
+
+<?=$this->translate('item_barcode')?>: <?=$hold_details['barcode'] ?? ''?>
+
+<?=$this->translate('Title')?>: <?=$hold_details['itemTitle'] ?? ''?>
+
+<?=$this->translate('Call Number')?>: <?=$hold_details['callNo'] ?? ''?>
+
+<?=$this->translate('Location')?>: <?=$hold_details['homeLocation'] ?? ''?>
+
+<?=$this->translate('Comments')?>: <?=$hold_details['comment'] ?? ''?>
+
+<?php /* Request Group: <?=$this->translate('request_group')?>: <?=$hold_details['requestGroupId'] ?? ''?> */ ?>