From 0e23332d226b0ad83fd1d2ed7138c7b4f475e05d Mon Sep 17 00:00:00 2001 From: Galen Charlton Date: Wed, 22 Dec 2021 16:54:22 -0500 Subject: [PATCH] LP#1938835: release notes for the customizable staff portal To test ------- [1] Apply the patch. [2] Verify that the Angular staff portal is now the default and that it displays the stock portal entries. [3] In the new Staff Portal Page local administration interface, make changes to add, subtract, or modify portal page entries. [4] Verify that those changes appear on the staff portal page and that they are sensitive to the workstation that the staff user is logged in as. Sponsored-by: Pioneer Library System Signed-off-by: Galen Charlton Signed-off-by: Shula Link Signed-off-by: Mike Rylander Signed-off-by: Dan Guarracino --- .../Client/Customizable_Staff_Portal.adoc | 57 ++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 docs/RELEASE_NOTES_NEXT/Client/Customizable_Staff_Portal.adoc diff --git a/docs/RELEASE_NOTES_NEXT/Client/Customizable_Staff_Portal.adoc b/docs/RELEASE_NOTES_NEXT/Client/Customizable_Staff_Portal.adoc new file mode 100644 index 0000000000..afcdab526a --- /dev/null +++ b/docs/RELEASE_NOTES_NEXT/Client/Customizable_Staff_Portal.adoc @@ -0,0 +1,57 @@ +== Customizable Staff Portal == + +The staff portal / staff home page is now customizable. A new Local +Administration interface, Staff Portal Page, allows staff users who +have the new `ADMIN_STAFF_PORTAL_PAGE` permission to specify groups +of Evergreen menu links, external links, catalog search widgets, +and free text to display on the staff home page. + +The portal customization is available only on the Angular version of +the portal, so access to the AngularJS version is now redirected to +the Angular one. + +Different portal pages may be configured for different Organizational +Units. The displayed portal page will depend on the staff user's +workstation. The Organizational Unit tree will be walked up starting +from the workstation until one or more `config.ui_staff_splash_page_entry` +rows are found for the Organizational Unit. The set of entries for +that Organizational Unit will constitute the entire splash page entries +to display, i.e., it won't try to merge branch, system, and +consortial-level entries. + +The administration interface allows authorized to: + +* create, modify, or delete portal page entries +* clone a library's set of portal page entries to a + different library + +Portal page entries consist of the following fields: + +* Entry Label: free text that displays on the portal page +* Entry Type: Catalog Search, Header, Link, Menu Item, or Text and/or HTML +* Entry Target URL: target of Link or Menu Item entries +* Entry Text: Free text and limited HTML to display for Text/HTML entry + types. HTML is sanitized to allow only basic formatting and link + elements. +* Entry Image URL: for specifying an icon to display with the + portral entry. +* Owner: the Organization Unit that owns the entry. +* Page Column and Column Position: these control the positioning + of the entry. The portal is styled so that three columns are + displayed by default, as with the legacy hard-coded portal, but + if the user chooses to define more than three columns, columns + after the third will stack vertically as additional rows. + +=== Upgrade notes === + +This patch adds the following: + + * New database table `config.ui_staff_splash_page_entry`. This + stories the entries to display on the portal. + * New database table `config.ui_staff_portal_page_entry_type`. + This is a lookup table for entry types. + * New permission `ADMIN_STAFF_SPLASH_PAGE`. This is implicitly + available to stock Local and Global Administrator permission + groups via the `EVERYTHING` permission. + * New grid setting for the administration interface. + -- 2.11.0