=== Plugin Name ===
Contributors: kseaborn
Plugin Name: Zotpress
Plugin URI: http://katieseaborn.com/plugins/
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=5HQ8FXAXS9MUQ
Tags: zotero, zotpress, citation manager, citations, citation, cite, citing, bibliography, bibliographies, reference, referencing, references, reference list, reference manager, academic, academia, scholar, scholarly, cv, curriculum vitae, resume, publish, publications
Author URI: http://katieseaborn.com/
Author: Katie Seaborn
Requires at least: 3.5
Tested up to: 3.9.1
Stable tag: 5.2
License: Apache2.0

Zotpress displays your Zotero citations on WordPress.

== Description ==

[Zotpress](http://katieseaborn.com/plugins/ "Zotpress for WordPress") brings scholarly blogging to WordPress. This plugin displays your [Zotero](http://zotero.org/ "Zotero") citations on your WordPress blog. [Zotero](http://zotero.org/ "Zotero") is a free, cross-platform reference manager that integrates with your browser and word processor.

= Features =
* Displays your individual and group Zotero items through in-text citations and bibliographies
* Leverages WordPress Custom Content Types for greater integration and flexibility
* Provides citation insertion features similiar to those offered by Zotero for word processors
* 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, IE7, IE8, and IE9. Made with jQuery, jQuery UI, jQuery doTimeout, and Live Query.

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.

= Requirements =
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. Optional: OAuth enabled on your server.

== Installation ==

1. Upload the folder `zotpress` to the `/wp-content/plugins/` directory.
1. Activate the plugin through the 'Plugins' menu in WordPress.
1. Place the `[zotpress]` shortcode in your blog entry or enable the Zotpress sidebar widget.

= Shortcode =
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:

[zotpressInText item="{U9Z5JTKC,36-45}"]

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.

== Frequently Asked Questions ==

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](http://wordpress.org/tags/zotpress "Zotero forums on Wordpress.com").

== Screenshots ==

1. Browse your Zotero citations by account, collection or tag. Add custom images to citations. Special characters are supported.
2. Search for items and build bibliography and in-text shortcodes using the "Zotpress Reference" meta box widget.
3. Display your Zotero items on your blog. Write scholarly posts with in-text citations and autogenerated bibliographies.

== Changelog ==

= 5.2 =

* 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.

= 5.1 =

* 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.

= 5.0.10 =

* 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.

= 5.0.9 =

* Fixed incorrect abstracts issue.
* Fixed "years", "authors" and "nick" shortcode attributes.
* Help information for finding Group IDs has been updated.
* Lowercase style names enforced.

= 5.0.8 =

* 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.

= 5.0.7 =

* 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.

= 5.0.6 =

* 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.

= 5.0.5 =

* 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.

= 5.0.4 =

* 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.

= 5.0.3 =

* 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.

= 5.02 =

* 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.

= 5.01 =

* Critical patch for case-sensitive tables and import functionality.

= 5.0 =

* 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!

= 4.5.4 =
* Fixed "downloadable" bug.
* Updated Help page.

= 4.5.3 =
* Styles for metabox tabs added.
* In-Text Bibliography fixed (for real this time).

= 4.5.2 =
* New! Options page to set blog-wide defaults (more settings coming).
* New(ish)! Post-specific style defaults.
* In-Text Bibliography display fixed AGAIN!

= 4.5.1 =
* In-Text Bibliography display fixed (or, made better).
* New! Set default citation style (for all posts, via Zotpress Reference Metabox Widget).

= 4.5 =
* New: Shortcode Creator in the Zotpress Reference Metabox Widget.
* "Show Image" and "Sort" bugs fixed.

= 4.4.1 =
* Security fix!

= 4.4 =
* 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.

= 4.3 =
* 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.

= 4.2.7 =
* Error display error fixed.

= 4.2.6 =
* Fixed bullet image issue.

= 4.2.5 =
* Fixed sidebar issue: having an author is no longer required.

= 4.2.4 =
* Fixed sidebar widget error and display issue.
* Added more information to and sorting of citations listed in the Zotpress Reference widget.

= 4.2.3 =
* 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.

= 4.2.2 =
* Bugfix: Typo!

= 4.2.1 =
* Bugfix: Limit issue resolved.

= 4.2 =
* 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.

= 4.1.1 =
* Bugfix: Can now sort by ASC or DESC order.

= 4.1 =
* Bugfixes: Filtering by author and date reinstated.
* New: Titles by year. (New parameter: title)

= 4.0 =
* 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.

= 3.1.3 =
* Temporary fix for web servers that don't support long URLs. Unfortunately no special caching for these folks. New solution in the works.

= 3.1.2 =
* 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.

= 3.1.1 =
* Fix: Sidebar widget bug.

= 3.1 =
* 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.

= 3.0.4 =
* Fixed display images issue.
* Separated out sidebar widget code from main file.

= 3.0.3 =
* Groups accounts citation display fixed.

= 3.0.2 =
* Meta box fixed in IE and Safari.
* Styles fixed in IE and Safari.

= 3.0.1 =
* Sidebar widget fixed.
* Styles in IE refined.
* Conditional OAuth messages implemented.

= 3.0 =
* 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(). 

= 2.6.1 =
* Can now give group accounts a public key.
* Downloads can now be accessed by anyone (assuming you've enabled downloading).

= 2.6 =
* Important: Reduced multiple instantiations of JavaScript.
* Download option added to Widget.
* Proper download links for PDFs implemented.

= 2.5.2 =
* Fixed image display for author/year citations.

= 2.5.1 =
* Fixed single citation display bug.

= 2.5 =
* Re-wrote display code.
* Tidied up JavaScript.
* Fixed update table code.

= 2.4 =
* Can now display by year.
* New option to display download links, should they be available.

= 2.3 =
* Fixed Group "invalid key" error.

= 2.2 =
* Fixed CURLOPT_FOLLOWLOCATION error.

= 2.1 =
* Now cURL-friendly again.

= 2.0 =
* 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.
* Increased security now that private keys are no longer exposed through JavaScript.
* Can now filter by Tag in admin.

= 1.6 =
* Critical request method issue fixed.

= 1.5 =
* Groups citation style issue fixed.

= 1.4 =
* Caching enabled, which should speed things up a bit.

= 1.3 =
* Added cURL, which is (maybe?) quicker, (definitely?) safer, and (more likely to be?) supported. Requests default to cURL first now.

= 1.2 =
* Optimized JavaScript functions. Fixed some grammatical errors on the Help page. More selective loading of JavaScript. And most importantly ... added a Zotpress widget option. This also means you can have more than one Zotpress call on a single page.

= 1.1 =
* 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.

= 1.0 =
* Zotpress makes its debut.

== Upgrade Notice ==

= 1.2 =
Lots of little issues fixed. Plus, you can now use a Zotpress widget instead of shortcode.

= 1.3 =
Implemented cURL, which should help those having read/write issues on their server.

= 1.4 =
Speed increase with newly added caching feature.

= 1.5 =
Important: Groups citation style issue fixed.

= 1.6 =
Critical request method issue fixed.

= 2.0 =
Zotpress overhaul. Security and performance increases.

= 2.1 =
Now cURL-friendly again.

= 2.2 =
Fixed CURLOPT_FOLLOWLOCATION error.

= 2.3 =
Fixed Group "invalid key" error.

= 2.4 =
Can now display by year. Option to display download links.

= 2.5 =
Re-wrote display code and tidied up JavaScript. Fixed update table code.

= 2.5.1 =
Fixed single citation display bug.

= 2.6 =
Important: JavaScript reductions; download option added to Widget; proper PDF download links.

= 2.6.1 =
Downloads can now be accessed by anyone.

= 3.0 =
Major release! OAuth, convenient "Zotpress Reference" meta box, friendly lag handling, numerous bug fixes, and more!

= 3.0.1 =
Sidebar widget fixed.

= 3.0.2 =
Meta box now working in IE and Safari!

= 3.0.3 =
Groups accounts citation display fixed.

= 3.0.4 =
Fixed display images issue.

= 3.1 =
Speed increase and a new way of caching. No more multiple accounts per shortcode. No more auto-display of collection title.

= 3.1.1 =
Fixed Sidebar widget bug.

= 3.1.2 =
Bug fixes and clean up.

= 3.1.3 =
Bug fixes.

= 4.0 =
Requests now processed by PHP instead of jQuery. Shortcode parameters re-envisioned (but backwards-compatible). Can now sort by author and date.

= 4.1 =
Bugfixes: Filtering by year and author reinstated. New: Titles for year.

= 4.1.1 =
Bugfix: Can now sort by ASC or DESC order.

= 4.2 =
Bugfixes and metabox widget refinements.

= 4.2.1 =
Bugfix: Limit issue resolved.

= 4.2.2 =
Bugfix: Typo!

= 4.2.3 =
Friendly XML error messages, spite-ified images, and ability to delete citation images.

= 4.2.4 =
Fixed sidebar widget. Refined Zotpress Reference widget.

= 4.2.5 =
Fixed sidebar widget issue.

= 4.2.6 =
Fixed bullet image issue.

= 4.2.7 =
Error display error fixed.

= 4.3 =
Zotpress InText and various fixes.

= 4.4 =
Security measures added. Fixed "Help" page info. Zotpress shortcode now accepts lists for these parameters: collection, item. Notes can now be shown. Zotpress Reference on custom post type writing/editing pages and working with the latest versions of Chrome and Safari.

= 4.4.1 =
Security fix!

= 4.5 =
Shortcode Creator. "Show Image" and "Sort" bugs fixed.

= 4.5.1 =
In-Text Bibliography display fixed. Set default citation style.

= 4.5.2 =
Options page to set blog-wide style defaults (more coming). Post-specific style defaults. In-Text Bibliography display fixed AGAIN!

= 4.5.3 =
Styles for metabox tabs added. In-Text Bibliography fixed (I promise).

= 4.5.4 =
Fixed "downloadable" bug. Updated Help page.

= 4.6 =
* New! Context menu (aka right-click menu) insert citation function for CKEditor-enabled blogs.

= 5.0 =
* Fixed for Wordpress 3.5! Many new and improved features.

= 5.01 =

* Critical patch for case-sensitive tables and import functionality.

= 5.02 =

* 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.

= 5.0.3 =

* 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.

= 5.0.4 =

* 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.

= 5.0.5 =

* 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.

= 5.0.6 =

* 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.

= 5.0.7 =

* 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.

= 5.0.8 =

* 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.

= 5.0.9 =

* Fixed incorrect abstracts issue.
* Fixed "years", "authors" and "nick" shortcode attributes.
* Help information for finding Group IDs has been updated.
* Lowercase style names enforced.

= 5.0.10 =

* 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.