=== Quotes Collection ===
Contributors: SriniG
Tags: quotes collection, quotes, quotations, random quote, sidebar, widget, ajax
Requires at least: 2.2
Tested up to: 3.0-RC1
Stable tag: trunk
Quotes Collection plugin with Ajax powered Random Quote sidebar widget helps you collect and display your favourite quotes on your WordPress blog.
== Description ==
Quotes Collection plugin with Ajax powered Random Quote sidebar widget helps you collect, manage and display your favourite quotations on your WordPress blog. All quotes or a set of quotes can also be displayed on a page using a `[quote]` tag.
Main features and notes:
* Random Quote sidebar widget with Ajax refresh feature -- you will be able to get another random quote on the same space without refreshing the web page. This refresh feature can be optionally turned off. The widget also comes with few other options in the widget control panel.
* A nice admin interface to add, edit and manage quotes.
* Additional information that can be provided along with the quote: quote author, source (e.g., a book, or a website URL), tags (keywords) and visibility.
* Quotes can be displayed in a page by placing a piece of code (quick tags) such as the ones below.
* Placing `[quote|all]` in the page displays all quotes.
* `[quote|author=Somebody]` displays quotes authored by Somebody.
* `[quote|source=Something]` displays quotes with source as ‘Something’
* `[quote|tags=sometag]` displays quotes tagged sometag
* `[quote|tags=tag1,tag2,tag3]` displays quotes tagged tag1 or tag2 or tag3, one or more or all of these
* `[quote|id=3]` displays quote with ID 3
* `[quote|random]` displays a random quote
* The template function `quotescollection_quote()` can be used to display a random quote in places other than sidebar. See [other notes](http://wordpress.org/extend/plugins/quotes-collection/other_notes/) for details.
* Support for Localization. As of version 1.3.7, translation is available in the following languages.
* Arabic
* Bulgarian
* Bosnian
* Belarusian
* Czech
* Danish
* German
* Spanish
* Persian
* Finnish
* French
* Hindi
* Croatian
* Hungarian
* Italian
* Japanese
* Lithuanian
* Latvian
* Dutch
* Polish
* Portugese
* Portugese (Brazilian)
* Russian
* Serbian
* Swedish
* Tamil
* Turkish
* Ukrainian
* Simplified Chinese
== Installation ==
1. Unzip and upload the `quotes-collection` directory to the `/wp-content/plugins/` directory
1. Go to `WP Admin » Plugins` and activate the ‘Quotes Collection’ plugin
1. To add and manage the quotes go to `WP Admin » Tools » Quotes Collection`
1. To display a random quote in the sidebar, go to `WP Admin » Appearance » Widgets`, drag ‘Random Quote’ widget into the sidebar
== Frequently Asked Questions ==
= How to get rid of the quotation marks that surround the random quote? =
Open the quotes-collection.css file that comes along with the plugin, scroll down and look towards the bottom.
= The 'Next quote »' link is not working. Why? =
You have to check a couple of things,
1. Make sure your theme’s header.php file has the code `` just before ``.
2. Make sure the plugin files are uploaded in the correct location. The files should be uploaded in a location as follows
wp-content/
|-- plugins/
|-- quotes-collection/
|-- quotes-collection.php
|-- quotes-collection.js
|-- quotes-collection.css
|-- quotes-collection-ajax.php
If you still experience the problem even after the above conditions are met, [contact](http://srinig.com/contact/) the plugin author.
= How to hide the 'Next quote »' link? =
You can do this by turning off the 'Ajax Refresh feature' in widget options.
= What are the parameters that can be passed on to `quotescollection_quote()` template function? =
Please refer [other notes](http://wordpress.org/extend/plugins/quotes-collection/other_notes/)
= How about a feature to backup/export/import the bulk of quotes in CSV/text format? =
Such a feature will be available in a future version of the plugin, though no promises can be made as to when it will be available!
= How to change the admin access level setting for the quotes collection admin page? =
Change the value of the variable `$quotescollection_admin_userlevel` on line 16 of the quotes-collection.php file. Refer [WordPress documentation](http://codex.wordpress.org/Roles_and_Capabilities) for more information about user roles and capabilities.
= I have a long list of quotes, and `[quote|all]` puts all of the quotes in a single page. Is there a way to introduce pagination and break the long list of quotes into different pages? =
Inbuilt pagination support may be introduced in a future version. As of now, you can separate different set of quotes based on author name `[quote|author=]` or tags `[quote|tags=]` and introduce a [``](http://codex.wordpress.org/Styling_Page-Links) in between.
== Screenshots ==
1. Admin interface (in WordPress 2.8)
2. ‘Random Quote’ widget options (WordPress 2.8)
3. An example of the random quote displayed on a sidebar
== The quotescollection_quote() template function ==
The quotescollection_quote() template function can be used to display a random quote in places other than sidebar.
Usage: ``
The list of parameters (arguments) that can be passed on to this function:
* **show_author** *(boolean)*
* To show/hide the author name
* 1 - shows the author name (default)
* 0 - hides the author name
* **show_source** *(boolean)*
* To show/hide the source field
* 1 - shows the source
* 0 - hides the source (default)
* **ajax_refresh** *(boolean)*
* To show/hide the 'Next quote' refresh link
* 1 - shows the refresh link (default)
* 0 - hides the hides the refresh link
* **tags** *(string)*
* Comma separated list of tags. Only quotes with one or more of these tags will be shown.
* **char_limit** *(integer)*
* Quotes with number of characters more than this value will be filtered out. This is useful if you don't want to display long quotes using this function. The default value is 500.
* **echo** *(boolean)*
* Toggles the display of the random quote or return the quote as an HTML text string to be used in PHP. The default value is 1 (display the quote). Valid values:
* 1 (true) - default
* 0 (false)
**Example usage:**
* ``
* Uses the default values for the parameters. Shows author, hides source, shows the 'Next quote' link, no tags filtering, no character limit, displays the quote.
* ``
* Hides author, shows source, only quotes tagged with 'fun' or 'fav' or both are shown. 'Next quote' link is shown (default) and no character limit (default).
* ``
* The 'Next quote' link is not shown, quotes with number of characters greater that 300 are left out.
==Changelog==
* **2010-06-06: Version 1.3.8**
* Fix for the backslashes issue.
* **2010-03-02: Version 1.3.7**
* Localization in Hindi added.
* **2009-11-10: Version 1.3.6**
* Localization in Bulgarian and Czech languages added.
* **2009-09-22: Version 1.3.5**
* Brazilian Portugese localization added.
* Modifications in quotes-collection.js (for better debugging in case of error)
* **2009-08-24: Version 1.3.4**
* Finnish localization added.
* FAQ updated.
* **2009-08-12: Version 1.3.3**
* Localization in Simplified Chinese added.
* **2009-06-12: Version 1.3.2**
* Latvian translation added. Hungarian translation updated.
* **2009-05-29: Version 1.3.1**
* Bug fix (URL parsing issue)
* Lithuanian translation added. Spanish and Russian updated
* **2009-05-28: Version 1.3**
* Uses jQuery instead of SACK library for the AJAX refresh functionality
* New widget option to filter based on tags
* New widget option to set character limit for the random quote
* Template function changed to `quotescollection_quote()`. The old function `quotescollection_display_randomquote()` will still work.
* Parameters now passed in string format in the template function
* Hungarian, Belarusian translations added. Swedish, Italian, Croatian, Turkish, Japanese, Persian, French and Tamil updated.
* If you insert a url in quote, author, source, it becomes clickable in the random quote and in quotes pages.
* Other minor improvements
* **2009-04-20: Version 1.2.8**
* Correcting a mistake in the previous update.
* **2009-04-20: Version 1.2.7**
* Added localization in Portugese language
* Fix to handle directory paths in windows servers
* **2009-04-14: Version 1.2.6**
* Added localization in Serbian, Bosnian, Dutch and Persian languages
* **2009-02-27: Version 1.2.5**
* Added localization in Swedish language
* Minor tweaks and fixes
* **2009-02-04: Version 1.2.4**
* Added translation in Danish, Croatian and Japanese languages
* Minor fixes
* FAQ section added in readme.txt to answer the frequently asked questions.
* **2008-11-08: Version 1.2.3**
* Added Ukrainian translation (thanks to Stas for the translation)
* Tested the plugin for the new admin interface that comes with WordPress 2.7 and a few tweaks. The plugin will work just fine in older WP versions
* **2008-10-06: Version 1.2.2**
* Security fix, HTML tidy fix, other fixes
* Updated Turkish trasnlation
* **2008-09-24: Version 1.2.1**
* Arabic translation added
* Minor fix (quotes-collection.js: errotext -> errortext)
* **2008-09-22: Version 1.2**
* All javascript code moved to quotes-collection.js. This makes the code neater.
* Translations for French, Polish and Turkish languages added.
* Italian and Russian translations updated.
* A few minor fixes and small improvements.
* **2008-07-02: Version 1.1.4**
* Bug fixes. The plugin was not handling properly apostrophes in author and source fields. This is fixed now.
* Other small fixes.
* **2008-06-05: Version 1.1.3.1**
* Added Spanish translation.
* Updated Italian translation.
* **2008-06-01: Version 1.1.3**
* Improvements
* Updated German translation
* Added Russian translation
* **2008-05-28: Version 1.1.2.1**
* VARCHAR(256) -> VARCHAR(255) (VARCHAR(256) doesnt work with MySQL 4.0)
* **2008-05-28: Version 1.1.2**
* Modifications in the automatic database update functionality
* Fixed problem with German translation
* Added Italian translation
* **2008-05-25: Version 1.1.1**
* security fix
* **2008-05-25: Version 1.1**
* Tagging feature
* Internationalization
* Fixes and improvements
* **2008-03-11: Version 1.0**
* Compatible with WordPress 2.5
* Bug fixes and various other improvements
* **2008-02-06: Version 0.9.5**
* Fixed problem with non English characters in author names while using the tag [quote|author=]
* **2008-01-16: Version 0.9.4**
* Support for utf-8 characters
* Fixed problem with linebreaks
* **2007-12-19: Version 0.9.3**
* Fixed a JavaScript issue
* Removed unnecessary tags above random quote when title field is left blank in widget control options. tags displayed only when there is a title.
* **2007-12-18: Version 0.9.2**
* Provision to add random quote anywhere in the template.
* **2007-12-16: Version 0.9.1**
* Bug fix
* **2007-12-15: Version 0.9**
* Initial release