mirror of
https://github.com/advplyr/audiobookshelf.git
synced 2026-05-30 23:40:40 +02:00
[PR #5052] [CLOSED] Add placholder books #4405
Assignees
adam (Adam Melkus)
Clear assignees
adam (Adam Melkus)
No Assignees
Notifications
Due Date
No due date set.
Dependencies
No dependencies set.
Reference: starred/audiobookshelf#4405
Reference in New Issue
Block a user
Delete Branch "%!s()"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
📋 Pull Request Information
Original PR: https://github.com/advplyr/audiobookshelf/pull/5052
Author: @JensBickel
Created: 2/12/2026
Status: ❌ Closed
Base:
master← Head:add-placholder-books📝 Commits (6)
96de890test(placeholders): add server coverage for placeholder creation, serialization, and query visibilitydc52a6bfeat(db): add libraryItems.isPlaceholder migration and model serialization supportc0d9dc4feat(series): add placeholder creation endpoint and reuse existing cover flow2a775d4feat(server): promote placeholders on scan and enforce visibility rules across list/search/author-series contextsfc325a4feat(client): add placeholder UX for series/upload flows, card styling/action guards, and localized strings5ae65d3fix(placeholders): avoid false promotion on upload📊 Changes
43 files changed (+3305 additions, -44 deletions)
View changed files
📝
client/components/app/BookShelfToolbar.vue(+32 -0)📝
client/components/app/LazyBookshelf.vue(+13 -0)📝
client/components/cards/ItemUploadCard.vue(+38 -2)📝
client/components/cards/LazyBookCard.vue(+70 -6)📝
client/components/cards/LazySeriesCard.vue(+5 -1)➕
client/cypress/tests/components/app/BookShelfToolbar.placeholder.cy.js(+147 -0)📝
client/cypress/tests/components/cards/LazyBookCard.cy.js(+28 -0)📝
client/cypress/tests/components/cards/LazySeriesCard.cy.js(+13 -0)➕
client/cypress/tests/components/pages/Upload.placeholder.cy.js(+122 -0)📝
client/pages/author/_id.vue(+23 -1)📝
client/pages/upload/index.vue(+75 -2)📝
client/strings/en-us.json(+15 -1)📝
docs/controllers/AuthorController.yaml(+40 -0)📝
docs/controllers/LibraryController.yaml(+48 -0)📝
docs/objects/LibraryItem.yaml(+3 -0)📝
docs/root.yaml(+4 -0)📝
package-lock.json(+2 -2)📝
package.json(+6 -1)📝
server/controllers/AuthorController.js(+191 -0)📝
server/controllers/FileSystemController.js(+13 -3)...and 23 more files
📄 Description
Brief summary
I found the placeholder issue/feature request on GitHub and I found the placeholder feature request on GitHub and implemented a first version of it.
See: https://github.com/advplyr/audiobookshelf/issues/3221
This PR adds manually creatable placeholders for existing book series and at the author level.
Which issue is fixed?
closes #3221
In-depth Description
This implementation allows users with upload permission to add placeholders at both the author and series levels.
Placeholders are tracked in the database and can be selected as upload targets, which allows in-place promotion to a real library item during upload.
This makes it possible to prepare and organize incomplete series entries before media files are available.
When a matching upload is completed, the placeholder is reused instead of creating a duplicate item, keeping metadata continuity.
Placeholders are visually distinct from regular books.
The implementation is backed by the file system to closely match the behavior of real books.
How have you tested this?
I added unit tests for the newly introduced code and manually tested the behavior in two browsers.
I verified that placeholders can be created from both author and series views and appear with distinct placeholder styling in the UI.
I also validated the upload flow by targeting an existing placeholder and confirming it is promoted in place to a regular library item without creating duplicates.
Screenshots
🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.