Bug 40245 - Support option to display firstname in memberresultst
Summary: Support option to display firstname in memberresultst
Status: Signed Off
Alias: None
Product: Koha
Classification: Unclassified
Component: Patrons (show other bugs)
Version: Main
Hardware: All All
: P5 - low enhancement
Assignee: CJ Lynce
QA Contact: Testopia
URL:
Keywords:
: 40484 (view as bug list)
Depends on:
Blocks:
 
Reported: 2025-06-25 18:20 UTC by Chip Halvorsen
Modified: 2025-07-25 14:45 UTC (History)
6 users (show)

See Also:
GIT URL:
Change sponsored?: Sponsored
Patch complexity: Small patch
Documentation contact:
Documentation submission:
Text to go in the release notes:
Version(s) released in:
Circulation function:


Attachments
Bug 40245: Add new system preference ShowFirstIfDifferentThanPreferred (3.75 KB, patch)
2025-07-22 18:56 UTC, CJ Lynce
Details | Diff | Splinter Review
Bug 40245: Show firstname in patron search results when different than preferred_name (7.96 KB, patch)
2025-07-22 18:57 UTC, CJ Lynce
Details | Diff | Splinter Review
Bug 40245: Show firstname in patron search results when different than preferred_name (8.03 KB, patch)
2025-07-25 14:06 UTC, Emily Lamancusa (emlam)
Details | Diff | Splinter Review
Bug 40245: Add new system preference ShowFirstIfDifferentThanPreferred (3.82 KB, patch)
2025-07-25 14:07 UTC, Emily Lamancusa (emlam)
Details | Diff | Splinter Review
Bug 40245: Show firstname in patron search results when different than preferred_name (8.03 KB, patch)
2025-07-25 14:08 UTC, Emily Lamancusa (emlam)
Details | Diff | Splinter Review

Note You need to log in before you can comment on or make changes to this bug.
Description Chip Halvorsen 2025-06-25 18:20:06 UTC
Circulation staff would find it very useful to see firstname in addition to preferred_name in the patron search results table (memberresultst). Currently at 24.11+, only the preferred name is displayed.

One way to handle this might be to add firstname as a line at between address and email address. 

SMITH, KAT 
  123 MAIN ST.
  ANYTOWN, STATE/PROVINCE POSTCODE
Firstname: KATELYNN
Email: X@Y.Z

Or we might want to put the firstname in parenthesis.
SMITH, KAT (Firstname: KATELYNN)
  123 MAIN ST.
  ANYTOWN, STATE/PROVINCE POSTCODE
Email: X@Y.Z

Having the firstname appear somewhere would help disambiguate similar patron names in the search results. Even better would be logic that only displayed the Firstname when it differs from the Preferred_name.

This should be made optional. Some libraries might not want firstname to appear here, to avoid accidentally deadnaming a patron.
Comment 1 CJ Lynce 2025-07-22 18:56:41 UTC
Created attachment 184501 [details] [review]
Bug 40245: Add new system preference ShowFirstIfDifferentThanPreferred

Adds a new system preference ShowFirstIfDifferentThanPreferred to allow a
    patron's firstname to be shown in search results when different than
    their preferred name.
Comment 2 CJ Lynce 2025-07-22 18:57:26 UTC
Created attachment 184502 [details] [review]
Bug 40245: Show firstname in patron search results when different than preferred_name

This patch shows the patron's firstname in search results and autosuggestions when
    thier preferred_name is different than their first name. Requires that sysprep
    ShowFirstIfDifferentThanPreferred is enabled. When disabled, only the preferred
    name shows in results.

Test plan:
0. Apply patches and login to the staff interface.
1. Edit a patron to give a different preferred name than first.
2. Return to home page and search for the patron in the quick-search bar.
3. Verify patron shows up in autosuggest list, showing preferred name only.
4. Verify patron shows up in regular list (member.pl) with preferred name showing only.
5. Change syspref ShowFirstIfDifferentThanPreferred to "Show" and save.
6. Return to home page and search for the patron in the quick-search bar.
7. Verify patron shows up in autosuggest list, showing preferred name, and firstname in brackets.
8. Verify patron shows up in regular list (member.pl) with preferred name, and firstname in brackets.

Sponsored-by: Westlake Porter Public Library <https://westlakelibrary.org>
Comment 3 CJ Lynce 2025-07-24 19:36:17 UTC
*** Bug 40484 has been marked as a duplicate of this bug. ***
Comment 4 Emily Lamancusa (emlam) 2025-07-25 14:06:04 UTC
Created attachment 184637 [details] [review]
Bug 40245: Show firstname in patron search results when different than preferred_name

This patch shows the patron's firstname in search results and autosuggestions when
    thier preferred_name is different than their first name. Requires that sysprep
    ShowFirstIfDifferentThanPreferred is enabled. When disabled, only the preferred
    name shows in results.

Test plan:
0. Apply patches and login to the staff interface.
1. Edit a patron to give a different preferred name than first.
2. Return to home page and search for the patron in the quick-search bar.
3. Verify patron shows up in autosuggest list, showing preferred name only.
4. Verify patron shows up in regular list (member.pl) with preferred name showing only.
5. Change syspref ShowFirstIfDifferentThanPreferred to "Show" and save.
6. Return to home page and search for the patron in the quick-search bar.
7. Verify patron shows up in autosuggest list, showing preferred name, and firstname in brackets.
8. Verify patron shows up in regular list (member.pl) with preferred name, and firstname in brackets.

Sponsored-by: Westlake Porter Public Library <https://westlakelibrary.org>
Signed-off-by: Emily Lamancusa <emily.lamancusa@montgomerycountymd.gov>
Comment 5 Emily Lamancusa (emlam) 2025-07-25 14:07:57 UTC
Created attachment 184638 [details] [review]
Bug 40245: Add new system preference ShowFirstIfDifferentThanPreferred

Adds a new system preference ShowFirstIfDifferentThanPreferred to allow a
    patron's firstname to be shown in search results when different than
    their preferred name.

Signed-off-by: Emily Lamancusa <emily.lamancusa@montgomerycountymd.gov>
Comment 6 Emily Lamancusa (emlam) 2025-07-25 14:08:03 UTC
Created attachment 184639 [details] [review]
Bug 40245: Show firstname in patron search results when different than preferred_name

This patch shows the patron's firstname in search results and autosuggestions when
    thier preferred_name is different than their first name. Requires that sysprep
    ShowFirstIfDifferentThanPreferred is enabled. When disabled, only the preferred
    name shows in results.

Test plan:
0. Apply patches and login to the staff interface.
1. Edit a patron to give a different preferred name than first.
2. Return to home page and search for the patron in the quick-search bar.
3. Verify patron shows up in autosuggest list, showing preferred name only.
4. Verify patron shows up in regular list (member.pl) with preferred name showing only.
5. Change syspref ShowFirstIfDifferentThanPreferred to "Show" and save.
6. Return to home page and search for the patron in the quick-search bar.
7. Verify patron shows up in autosuggest list, showing preferred name, and firstname in brackets.
8. Verify patron shows up in regular list (member.pl) with preferred name, and firstname in brackets.

Sponsored-by: Westlake Porter Public Library <https://westlakelibrary.org>
Signed-off-by: Emily Lamancusa <emily.lamancusa@montgomerycountymd.gov>
Comment 7 Emily Lamancusa (emlam) 2025-07-25 14:45:02 UTC
Thanks, CJ! This looks nice and works as advertised!

Testing notes:
- After applying patch, run updatedatabase and clear browser cache