=== Plugin Name ===
Contributors: kseaborn
Plugin Name: Zotpress
Plugin URI: http://katieseaborn.com/plugins/
Tags: zotero, zotpress, citation manager, citations, citation, bibliography, bibliographies, reference, references, reference list, reference manager, academic, academia, scholar, scholarly, cv, curriculum vitae, resume
Author URI: http://katieseaborn.com/
Author: Katie Seaborn
Requires at least: 3.0.4
Tested up to: 3.0.5
Stable tag: 2.5.1

Zotpress displays your Zotero citations on Wordpress.

== Description ==

[Zotpress](http://katieseaborn.com/plugins/ "Zotpress for WordPress") displays your [Zotero](http://zotero.org/ "Zotero") citations on Wordpress. It also extends Zotero's meta functionality by allowing you to add thumbnail images to your citations.

Zotero is a community-based cross-platform citation manager that integrates with your browser and word processor.

= Features =
* Display your Zotero citations on your blog
* Display citations, collections, or tags
* Sort by a variety of options, including: author, year, collection, tag, and more.
* Add both user and group Zotero accounts
* Add thumbnail images to your citations
* And more!

Tested in Firefox 3 (Mac/Win), IE7 and IE8.

= Requirements =
cUrl [preferably] or file_get_contents 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

= Shortcode =
You can display your Zotero citations in a number of ways. To display a complete list of citations for all accounts in the default bibliography style (APA), simply use this shortcode:

[zotpress]

= Shortcode Parameters: =
Here's a list of parameters you can use to display projects in different ways:

* `api_user_id` display a list of citations from a particular user or group.
* `nickname` display a list of citations by a particular nickname.
* `author` display a list of citations from a particular author. Format as follows: "Firstname+Lastname", e.g. "Carl+Sagan". Note: "C. Sagan", "C Sagan", "Carl E. Sagan", "Carl E Sagan" and "Carl Edward Sagan" are not the same as "Carl Sagan".
* `year` display a list of citations from a particular year. Format as follows: "2009". Note: You can display by Author and Year together!
* `data_type` display a list of a particular data type. Options: items [default], tags, collections
* `collection_id` id of the collection to draw citations from.
* `item_key` item key for a single item.
* `tag_name` name of the tag to draw citations from. Note: make sure you replace all spaces with a + sign, e.g. the tag "electric fish" becomes "electric+fish".
* `content` format of citation display. Options: html, bib [default]
* `style` citation style. Options: chicago-note-bibliography, harvard1, mhra, mla, nature, vancouver, apsa, asa, apa [default]. Note: Support for more styles coming; see Zotero Style Repository for details.
* `order` order by a certain field. Options: itemType, language, conferenceName, volume, issue, place, publisher, date, series, seriesTitle, dateModified, dateAdded [default]. Potentially many more; see Zotero Data Model.
* `sort` sort direction of the order field. Options: asc, desc [default]
* `limit` limit the item list to a certain amount. Options: numbers between 1-99 [default: 50]
* `image` whether or not to display the citation's image, if there is one. Options: yes, no [default]
* `download` whether or not to display the citation's download URL, if there is one. Options: yes, no [default]
* `curl` force cURL Options: yes [default], no

= An Example =
An example of the shortcode using parameters is:

[zotpress collection="ZKDTKM3X" limit="5"]

This shortcode will display a list of five citations from the collection with the key "ZKDTKM3X". 

== Screenshots ==

1. Display and filter your Zotero citations
2. Manage your Zotero accounts

== Changelog ==

= 1.0 =
* Zotpress makes its debut.

= 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.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.3 =
* Added cURL, which is (maybe?) quicker, (definitely?) safer, and (more likely to be?) supported. Requests default to cURL first now.

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

= 1.5 =
* Groups citation style issue fixed.

= 1.6 =
* Critical request method issue fixed.

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

= 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.
* New option to display download links, should they be available.

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

= 2.5.1 =
* Fixed single citation display bug.

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