About this plugin
Publications List Display for Zotero displays live Zotero library data in a dynamic Gutenberg block. Publications are grouped by year and can include authors, linked titles, publication details, item-type badges, dates, DOI links, citation keys, source URLs, and abstracts. Tags remain searchable but are not displayed on publication cards.
This is an independent third-party integration for Zotero. It is not affiliated with or endorsed by Zotero.
The block includes search, year/type/author filters, entry counts, and pagination. Initial results are rendered on the server and progressively enhanced with the WordPress Interactivity API. Author suggestions are requested only after a visitor types at least two characters, avoiding a large inline author list.
The plugin synchronizes every top-level item from the configured Zotero library or collection into a local WordPress index using resumable background batches. Search, filters, counts, and pagination use the local index. Creator names in the author-filter index are limited to 191 Unicode characters; hashes use the original names, and full names remain in publication data and search text.
During the first synchronization, already-indexed publications and controls remain available alongside an accessible progress indicator.
The initial synchronization screen reloads as soon as its first indexed publications are available, then displays the partial index while background synchronization continues. Frontend page rendering schedules synchronization without waiting for Zotero. New sources show a lightweight loading state until the background worker supplies the first publications; existing indexed results render immediately.
Scheduled workers process up to four pages per run. Each background Zotero request has a 20-second HTTP timeout. Connection failures automatically retry the same batch up to three times, after 60, 120, and 240 seconds, retaining indexed publications and progress.
After the final failure, the normal error state and five-minute retry eligibility apply. Automatic retries depend on WordPress Cron running. Editor previews and REST requests only read the local index: typing a source ID never starts or schedules a synchronization.
View the frontend page to initialize a new source. Library IDs must contain only digits; collection keys must be empty (the whole library) or exactly eight uppercase letters or digits.
Private API keys remain on the server and are never included in scheduled-event arguments, block markup, or REST responses. Public REST requests are limited to server-signed rendered block sources.
Features include:
- User libraries, group libraries, and individual collections.
- Complete-library background synchronization beyond Zotero’s 100-item response limit.
- Server-rendered initial results with Interactivity API enhancements.
- General search plus year, item-type, and author filters.
- Keyboard-accessible, on-demand author suggestions.
- DOI, source, Zotero, and citation-key links and metadata.
- Server-signed public REST requests that avoid arbitrary visitor-triggered source synchronization.
- A completed local index that avoids extra Zotero requests for visitor interactions.
- 100-item default pagination.
- Query-aligned database indexes for faster large-library display and filters.
- Plugin-owned data cleanup on uninstall.
External services
org to download publication metadata when a configured source synchronizes, including scheduled refreshes and administrator-triggered batches. Requests send the configured library type and ID, optional collection and item type, sorting and pagination parameters, API version, conditional library version when available, and API key when configured. Zotero also receives the WordPress server IP and HTTP client metadata.
Visitor search/filter terms are processed locally and are not sent to Zotero. Publication links may take visitors to Zotero, DOI, or publisher websites when clicked.
org/support/terms/terms_of_service
org/support/privacy
This plugin is independently developed and is not endorsed by Zotero.
Updating an existing installation after the rename
Deactivate the previous plugin before installing this renamed package. Install and activate Publications List Display for Zotero, then verify settings and existing bibliography blocks. The registered block, settings, database tables, and synchronization hooks retain their existing identifiers to preserve data.
Do not activate both copies together. Remove the old plugin folder through your file manager or SFTP only after verification; do not click Delete for the old plugin in WordPress, because its uninstall routine removes the shared settings and publication index. Back up the database before replacement.