- Displays your up-to-date individual and group Zotero items through in-text citations, bibliographies, and searchable libraries
- Supports thumbnail images through WordPress’s Featured Image
- Supports selective CSS styling via IDs and classes
- Provides a range of additional features, such as allowing visitors to cite and download citations
- And more!
Compatible with Firefox, Safari, Chrome, and IE9. Made with jQuery, jQuery UI, jQuery doTimeout, Live Query, OAuth, and Open Library.
Special thanks to Joe Alberts for substantial contributions to the code, comprehensive testing, and design ideation. Thanks also to contributors Christopher Cheung and Jason S. for their development support and advice. Finally, my sincere gratitude goes out to all who have donated in support of this plugin.
jQuery included in your theme (Zotpress will do this for you if it isn’t already included), and an HTTP request method supported by WordPress enabled on your server: cURL, fopen with Streams (PHP 5), or fsockopen. In your server config file, X-Frame-Options should be set to SAMEORIGIN. Optional: OAuth enabled on your server.
- Upload the folder
- Activate the plugin through the ‘Plugins’ menu in WordPress.
- Add the Zotero API information for each account you’d like to use.
- On the Browse page, look up the keys of the items, collections or tags you wish to display. Or, use the Zotpress Reference Widget to generate shortcodes.
- Place the shortcodes in your blog post or page, or enable the Zotpress sidebar widget.
You can display your Zotero citations in a number of ways. To display a list of five citations from the collection with the key “ZKDTKM3X”, use this shortcode:
[zotpress collection=”ZKDTKM3X” limit=”5″]
You can also use in-text citations:
This shortcode will display the following in-text citation for the citation with the key “U9Z5JTKC”: (Seaborn, 2011, p. 36). The full citation can be displayed in an auto-generated bibliography using the [zotpressInTextBib] shortcode.
Check out the “Help” page on your installation of Zotpress for more information and a full listing of parameters for all shortcodes.
The F.A.Q. can be found on the “Help” page of every Zotpress installation. If you have a question that isn’t answered there, feel free to post a message in the forums.
I searched all over for a decent way to publish my endnote library on my wordpress site. I gave up and exported it into zotero so I could use this plugin!
This is one of the best wordpress plugins I have used, and does exactly what I need. It works very well in displaying my zotero library, and the documentation is excellent. The support forum is also very useful and answered every question I had. When a problem recently emerged due to a conflict with a WP core change, the developer, Katie Seaborn, fixed it very quickly. As a result, I plan to donate toward its support and development.
I am still wondering how I can integrate reference with footnotes and how to use a collection and to suppress another collection within the same Zotero library
Not much to say except it’s brilliant.
This plugin is absolutely fantastic, I have wanted something like this forever. Thank you so, so much.
Contributors & Developers
“Zotpress” is open source software. The following people have contributed to this plugin.Contributors
- Fixed wp_remote_retrieve_headers issue (WP core change) that limited total results.
- Removed Google Fonts for quicker admin-side loading.
- Fixed author sort in Chrome.
- Fixed urlwrap for chicago-author-date (using ireplace).
- Case applied for author filtering when single field is used instead of double field even though first/last structure exists.
- Fixes and extensions made to the “urlwrap” feature for titles, esp. quotes.
- Fixed security issue with zp_get_account().
- New! “style” attribute for searchbar.
- Updated widget account selection and fixed retrieval error.
- Minor image and code style updates.
- Applied more cases for URL wrapping.
- Fix for encyclopedia author/editor cases for in-text citations.
- Fix for authors who are also editors for in-text citations.
- Fixed in-text number-based sorting for 50+ items.
- Better in-text error handling.
- Applied secondary year sorting for author sort.
- Fixed default ordering for number-based in-text citations.
- Fixed erroneous fix for in-text editors of books.
- Fixed dropdown update bug for collections.
- Migrated Options AJAX to WP AJAX; fixed Default Style option.
- Updated cURL request approach.
- Fixed title wrap issues related to mdashes and quotes in titles.
- Fixed chicago style DOI linking issue.
- Minor style updates.
- Quicker load times through more effective use of cache.
- New! “urlwrap” attribute for wrapping titles and images with the citation URL.
- New! “highlight” attribute for highlighting text in a citation.
- New! Can now use showimage=”openlib” to display book covers from the Open Library.
- In-text citations will no longer erroneously display editors.
- Order for In-Text Bib sort fixed.
- Browse navigation for multiple accounts fixed.
- Fixed “target” attribute for in-text bibliography DOI links.
- Now auto-detects https for Google Fonts links.
- Fixed multiple tags unique ID issue.
- Minor style updates.
- New way of selecting in-text citations without relying on post IDs as HTML IDs or classes.
- The “items” and “collections” parameters in bib and in-text shortcodes are now flexible around extra spaces.
- Fixed Zotpress In-Text Bibliography non-unique ID issue.
- Fixed parenthesis formatting issue for number-based in-text citations.
- Number-based in-text citations now have bibliographic details on mouse hover.
- Re-added item keys on Browse page.
- Set withCredentials attribute to true for AJAX requests.
- Fixed Zotpress Bibliography unique identifier bug.
- Fixed default sorting for in-text citations.
- Fixed in-text format (superscript).
- Re-added bib info as title for non-number-based in-text citation anchors.
- New! Can now use &, + and / with in-text page numbers.
- Fixed inclusive=”no” bug for tags.
- Fixed pagination for searchbar.
- Fixed non-English characters bug for the Zotpress Reference widget.
- Fixed sidebar widget issues.
- Fixed in-text bug that assumed id rather than class for posts/pages.
- Fixed various in-text formatting bugs.
- Fixed multiple terms bug for searchbar.
- Fixed non-English characters bug for searchbar.
- Fixed sortby/order for searchbars.
- Fixed style value “default” bug.
- Pagination for searchbars now hidden on search and no items found.
- Fixed “limit” attribute bug for the Zotpress Bibliography Shortcode.
- Fixed single item bug for the Zotpress In-Text Shortcode.
- New! Auto-updating/syncing through realtime data access with cURL and AJAX.
- Now using Zotero API version 3.
- Retired Zotpress Bibliography Shortcode attribute “linkedlist”/”link”; use Zotpress Library Shortcode instead.
- Retired Zotpress Bibliography Shortcode attribute “datatype”; use Zotpress Library Shortcode instead.
- Modified Zotpress Bibliography Shortcode attribute “inclusive”; use with multiple authors only.
- Zotpress Reference widget refined; now uses WP AJAX.
- Fixed “cite” bug for the Library shortcode.
- Shortcode parameter “searchby” for the Library SearchBar is now limited to items and tags.
- Updated deprecated code to WP 4.3 standards.
- Minor bug fixes and updates throughout.
- Bug fix for searchbar filters.
- Minor update to date formatting.
- Searchbar links are now hyperlinked.
- Updated searchbar labels.
- Browse page bug fixed.
- Added “download” attribute to Library shortcode (dropdown-only).
- Added support for “cite” to Library shortcode (dropdown-only).
- Fixed “target” attribute for DOI links.
- Updated styles for download and cite links.
- Default style option label clarified for importing.
- Fixed ampersand error for tags (must re-import).
- Fixed author filter error with same last name. New format: (last, first)
- New! Autocomplete search bar option for “zotpressLib” shortcode.
- Updated DOI hyperlinking function.
- Fixed item import bugs related to quotes and empty queries.
- Thanks to @mlwk for a thorough, 2+ level nested collections fix.
- Thanks to Joe Alberts for fixing the permission denied error reporting.
- Added support for “month-month year” format to zp_date_format.
- Fixed code-breaking error that occurred for some users.
- Fixed display bug for single libraries on Browse page.
- Set nonce lifetime to 12 hours.
- New! “zotpressLib” shortcode for displaying your library on the front-end of your website.
- Fixed “set image” bug for single-account setups.
- Fixed “remove image” bug.
- Optimized nested collections display.
- Optimized notes with display for single notes and anchors.
- Better error messages.
- Table updates now check for existence of table first.
- Corrected HTML for nested lists of collections and validation.
- Security enhancements for import script.
- Fixed minor shortcode and import bugs and warnings throughout.
- Fixed custom tags interference issue.
- Added plugin icons.
- New “brackets” in-text citation shortcode attribute.
- Re-structured import and admin scripts.
- Expanded in-text formatting.
- Added submenu to admin sidebar.
- Added ability to set default accounts on Browse and Accounts and selectively import on Browse.
- Applied fix for array_multisort warning.
- Minor style updates throughout.
- Added support for multiple last names to author filtering.
- Removed survey link.
- Minor style updates to the metabox.
- Fixed minor sort error for in-text bibliographies.
- Author attribute is now strict, e.g. “Gret” will not return “Gretel.”
- Sort attribute now understands most common date formats.
- Added “nick” version of “nickname” attribute to in-text shortcode.
- Fixed widget display issues for new posts.
- Fixed zp_get_year warning messages.
- Fixed in-text bibliography sorting errors.
- Fixed in-text citation display for no authors and no dates.
- Fixed image table issue that caused collection and/or item display bugs.
- Updated add account form labels.
- Added notice of research survey.
- Fixed inclusive filtering bug for multiple collections.
- Fixed prepare issues with metabox.
- Fixed import bug related authors with one name / full name meta.
- Fixed import bug related to non-English characters for in-text citations.
- Fixed abstract percent sign display bug.
- Added longer delay to in-text anchor highlight effect.
- Confirmed that Zotpress works with WP 4.0.
- New! “forcenumber” attribute numbers bibliographies, even when the style doesn’t.
- New! Clicking in-text anchors highlights the corresponding entry in the bibliography.
- New! DOIs are automatically hyperlinked.
- New! Authors (and below) can only see Browse and Help pages.
- Notice: Database update to fix overwriting images during selective import.
- Fixed in-text citation title formatting issues.
- Fixed incorrect duplicates for items cited in-text.
- Fixed broken image URLs.
- Fixed displayed duplicates generated by multiple download links.
- Removed old code.
- Minor content and style updates on the Help page.
- Fixed selective import bugs related to duplicate items.
- Updated table structure to optimize script.
- IMPORTANT! You must re-import your Zotero library/libraries in Zotpress when you install this version or your shortcodes will not display correctly.
- Fixed selective import bug for libraries with more than 50 top-level collections.
- Optimized import script and enforced Zotero API Version 2.
- Increased time length before timeout for import scripts.
- Fixed database updating bug and sort/order bug.
- Zotpress now requires version 3.5 of WordPress.
- New! In-text citation attributes “and” and “separator” for greater flexibility in format and style.
- New! Bibliography shortcode attributes “showtags” for displaying a citation’s tags and “target” for HTML5 compliance.
- New! Enable or disable Zotpress Reference Widget for specific post types.
- Updated import script, including compliance testing and friendly error messages.
- Updated style names, e.g. mla is now modern-language-association.
- Updated look and feel to match WordPress 3.8+.
- Multiple bug fixes.
- Fixed display issue for multiple in-text citations per shortcode.
- Updated the Help/FAQ page.
- Restructured request class and enforced Zotoro API Version 1.
- Fixed style update errors related to undefined variables.
- Added “citeable” as an alternate for the “cite” attribute.
- Fixed incorrect abstracts issue.
- Fixed “years”, “authors” and “nick” shortcode attributes.
- Help information for finding Group IDs has been updated.
- Lowercase style names enforced.
- New! Import functionality check added.
- New! Reset Zotpress feature on Options page.
- New! Added security measures to prevent direct access.
- New! Import items, collections and tags separately.
- Updated import script; sessions removed.
- Fixed minor shortcode bugs.
- Removed extraneous code.
- Minor style updates.
- New! Import script now uses WordPress functionality for improved compatibility.
- New! “Link” attribute for tag and collection lists.
- Updated help page to include how to use in-text brackets.
- In-text format updates, including new “etal” attribute.
- URLs are now converted two-ways to account for prior encoding.
- Updated styles for a more consistent look.
- Fixed incompatibility bugs with jQuery UI; some style updates, too.
- Fixed “abstract” attribute bug.
- Fixed in-text %num% numbering bug.
- In-text shortcodes are now unique to posts.
- Fixed hyperlink bug for special characters.
- Fixed search when no default account set.
- New! In-text citations are now hyperlinked to the generated bibliography.
- New! Can now display abstracts using the “abstract” parameter.
- Blank author fields now filled with other author (e.g. editor) information.
- Added support for %num% formatting option (in-text).
- Fixed front-end style update script for large (50+) items.
- Fixed “datatype” filtering error.
- Fixed typos in the Help page.
- Added default account constraint to Zotpress Reference results.
- Fixed table install, update and uninstall issues.
- New import and sync scripts for large libraries.
- Zotpress admin now accessible to Editors.
- Styles updated and Help page shortcode documentation redesigned.
- Fixed import and sync for large libraries.
- Removed autoupdate feature. Please use the sync feature for the time being.
- Fixed metabox widget error.
- Minor bug fixes.
- Fixed display of styles with numbered lists, e.g. IEEE, nature, etc.
- Fixed critical in-text citation bug when multiple accounts are synced.
- Long URLs in citations will now wrap.
- Critical patch for case-sensitive tables and import functionality.
- Happy new year! Zotpress is now optimized for WordPress 3.5.
- Near-complete rewrite of the code for greater loading speeds across the board.
- Revamped Browse page and Reference Widget with autocomplete and a new shortcode builder.
- Expanded Zotpress In-Text capabilities, including multiple items and formatting.
- New shortcode parameters, including ones for filtering and providing RIS links for citing.
- Greater shortcode flexibility, including support for multiple items and new sort options.
- Many more additions and bug fixes. Explore and enjoy the new Zotpress!
- Fixed “downloadable” bug.
- Updated Help page.
- Styles for metabox tabs added.
- In-Text Bibliography fixed (for real this time).
- New! Options page to set blog-wide defaults (more settings coming).
- New(ish)! Post-specific style defaults.
- In-Text Bibliography display fixed AGAIN!
- In-Text Bibliography display fixed (or, made better).
- New! Set default citation style (for all posts, via Zotpress Reference Metabox Widget).
- New: Shortcode Creator in the Zotpress Reference Metabox Widget.
- “Show Image” and “Sort” bugs fixed.
- Security fix!
- A number of security measures added.
- Fixed “Help” page shortcode for in-text citations and private vs. public groups: oops!
- The Zotpress shortcode now accepts lists for these parameters: collection, item.
- Notes can now be shown, if made publicly available through Zotero.
- Zotpress Reference should now show up on custom post type writing/editing pages.
- Zotpress Reference now working with the latest versions of Chrome and Safari.
- Introducing “Zotpress InText”, a new shortcode that let’s you add in-text citations, and then auto-generates a bibliography for you. jQuery must be enabled. Only supports APA style; requests can be made in the forums. Use information can be found in your Zotpress installation’s “Help” page.
- Recaching and auto-checking for new or updated Zotero data back in action.
- The “collection” shortcode parameter now working.
- Zotero XML data gathering functions optimized.
- Tags with spaces are now working again for the “tag” shortcode parameter.
- Tag shortcode parameter now accepts nonexistent tags.
- Error display error fixed.
- Fixed bullet image issue.
- Fixed sidebar issue: having an author is no longer required.
- Fixed sidebar widget error and display issue.
- Added more information to and sorting of citations listed in the Zotpress Reference widget.
- More friendly XML error messages, including ability to (at least try) repeating the Zotero request.
- Spite-ified most images for quicker display.
- Citation images can now be deleted.
- Bugfix: Typo!
- Bugfix: Limit issue resolved.
- Bugfix: Styles now working again.
- Bugfix: Now only grabbing top level items.
- Bugfix: Sidebar widget working again.
- Metabox widget refined: Limit removed, account info integrated, and tags and collections alphabetized.
- Bugfix: Can now sort by ASC or DESC order.
- Bugfixes: Filtering by author and date reinstated.
- New: Titles by year. (New parameter: title)
- Switched method of requesting from jQuery to PHP. Should mean a speed increase (particularly for Firefox users).
- Many shortcode parameters have been changed; these parameters are now deprecated: api_user_id (now userid), item_key (now item), tag_name (now tag), data_type (now datatype), collection_id (now collection), download (now downloadable), image (now showimage).
- New shortcode parameter “sortby” allows you to sort by “author” (first author) and “date” (publication date). By default, citations are sorted by latest added.
- Temporary fix for web servers that don’t support long URLs. Unfortunately no special caching for these folks. New solution in the works.
- Added backwards compatibility measure with respect to the new api_user_id / nickname requirement.
- Fixed citation display positioning bugs.
- Applied new caching method to sidebar widget.
- Fix: Sidebar widget bug.
- New way of caching requests. Speed increase for requests that have already been cached.
- No more multiple accounts per shortcode. A “user_api_id” or “nickname” must be set.
- No more collection titles. You can use the Zotero Reference meta box to find and add this information above collection shortcode calls.
- Fixed display images issue.
- Separated out sidebar widget code from main file.
- Groups accounts citation display fixed.
- Meta box fixed in IE and Safari.
- Styles fixed in IE and Safari.
- Sidebar widget fixed.
- Styles in IE refined.
- Conditional OAuth messages implemented.
- New “Zotpress Reference” widget, meant to speed up the process of adding shortcodes to your posts and pages by allowing you to selectively search for ids directly on the add and edit pages.
- OAuth is now supported, which means that you don’t have to go out of your way to generate the required private key for your Zotero account anymore (unless your server doesn’t support OAuth, of course).
- I’ve changed the way Zotpress’s admin splash page loads. Before, the page would hang until finished loading the latest citations from Zotero. This is a friendlier way of letting you know what Zotpress is up to.
- Manual re-caching and clear cache options added, for those who desire to refresh the cache at their leisure.
- Citations that have URLs will now have their URLs automatically hyperlinked.
- More IDs and classes added for greater CSS styling possibilities.
- Improved handling of multiple Zotpress shortcode calls on a single page.
- Code reduced and refined plugin-wide, which should equal an overall performance improvement.
- “Order” parameter no longer available, at least for now; see http://www.zotero.org/support/dev/server_api
- “Forcing cURL” option abandoned. If your server supports it, cURL will be used; otherwise, Zotpress will resort to file_get_contents().
- Can now give group accounts a public key.
- Downloads can now be accessed by anyone (assuming you’ve enabled downloading).
- Download option added to Widget.
- Proper download links for PDFs implemented.
- Fixed image display for author/year citations.
- Fixed single citation display bug.
- Re-wrote display code.
- Fixed update table code.
- Can now display by year.
- New option to display download links, should they be available.
- Fixed Group “invalid key” error.
- Fixed CURLOPT_FOLLOWLOCATION error.
- Now cURL-friendly again.
- Zotpress completely restructured.
- Most requests now made through PHP. Shortcode requests made through PHP/jQuery combo for user-friendliness on the front-end.
- Cross-user caching implemented. Updates request data every 10 minutes and only if request made.
- Can now filter by Tag in admin.
- Critical request method issue fixed.
- Groups citation style issue fixed.
- Caching enabled, which should speed things up a bit.
- Added cURL, which is (maybe?) quicker, (definitely?) safer, and (more likely to be?) supported. Requests default to cURL first now.
- Fixed up the readme.txt. Added a friendly redirect for new users. Made IE8-compliant. Moved some JS calls to footer. Now selectively loads some JS. Made tags and collections into lists for easier formatting.
- Zotpress makes its debut.