ThePalaceProject / web-patron / 26652146743

88%

push

github

Allow users to preview books and audiobooks (PP-4357) (#141)

## Description
<!--- Describe your changes -->
<img width="293" height="101" alt="image"
src="https://github.com/user-attachments/assets/701dd830-ff40-45d3-a550-09805bc17853"
/>

The mobile apps allow users to preview books and audiobooks. These
changes introduce the same functionality into the web catalog. If a
preview link is present in an OPDS entry, then the web catalog parses
that link for a URL and renders a preview button on the book details
page. When a user clicks this button, they are moved to a new tab which
renders a third-party web reader.

As is the case with the mobile apps, the button is rendered when a book
is

- borrowable
- reservable
- on hold

It should not render once a book has been borrowed.

## Motivation and Context

<!--- Why is this change required? What problem does it solve? -->
<!--- If it fixes an open issue, please link to the issue here. -->
This change ensures parity with the mobile apps and allows users to
sample a title before borrowing.

[Jira PP-4357](https://ebce-lyrasis.atlassian.net/browse/PP-4357)

## How Has This Been Tested?

<!--- Please describe in detail how you tested your changes. -->
<!--- Include details of your testing environment, and the tests you ran
to -->
<!--- see how your change affects other areas of the code, etc. -->
- Manual testing in Firefox, Chrome, Safari, and Edge (MacOS)
- preview player opens in new tab (mimicking behavior for external web
readers)
  - playback behavior for audiobooks
  - keyboard navigation
- Unit/Integration tests

## Checklist:

<!--- Go over all the following points, and put an `x` in all the boxes
that apply. -->
<!--- If you're unsure about any of these, don't hesitate to ask. We're
here to help! -->

- [ ] I have updated the documentation accordingly.
- [x] All new and existing tests passed.

---------

Co-authored-by: Tim DiLauro <tdilauro@users.noreply.github.com>

223 of 258 branches covered (86.43%)

Branch coverage included in aggregate %.

1 of 1 new or added line in 1 file covered. (100.0%)

356 of 400 relevant lines covered (89.0%)

31.67 hits per line