Srini’s WordPress Laboratory

Latest version: 1.3.2 (Updated on 12 June 2009)
Download | Screenshots | Installation | FAQ | Localization | Changelog | Comments

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. The plugin is similar, and uses ideas from (though not based on) the wp quotes plugin by Dustin Barnes.

Main features

• 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. You can check it right here on the sidebar. This refresh feature can be optionally turned off in the widget control panel. 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 using one of the code (quick tags) below.
  • The tag [quote|all] 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 (new with 1.1)
  • [quote|tags=tag1,tag2,tag3] displays quotes tagged tag1 or tag2 or tag3, one or more or all of these (new with 1.1)
  • [quote|id=3] displays quote with ID 3
  • [quote|random] displays a random quote
• The PHP code <?php quotescollection_quote() ?> can be used to display a random quote in places other than sidebar. (Notes about parameters that can be passed on to this function)
• Support for localization.

Screenshots

Download

Latest version: 1.3.2 (changelog)

Requires atleast WordPress version 2.2. Tested upto WordPress 2.8

The plugin can be downloaded from the WordPress plugin repository.

Released for free under the GPL.

Installation

1. Unzip and upload the `quotes-collection` directory to the `/wp-content/plugins/` directory
2. Go to `WP Admin » Plugins` and activate the ‘Quotes Collection’ plugin
3. To add and manage the quotes go to `WP Admin » Tools » Quotes Collection` (or `WP Admin » Manage » Quotes Collection` depending on the WP version you are using).
4. To display a random quote in the sidebar, go to `WP Admin » Appearance » Widgets` (or `WP Admin » Presentation » 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 <?php wp_head(); ?> just before </head>.
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_display_randomquote() template function?

Refer 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 http://codex.wordpress.org/Roles_and_Capabilities for more information about user roles and capabilities.

Localization

Versions 1.1 and greater support localization. As of 1.3.2, localization is available in the following languages.

Code	Language	Translator
ar	Arabic	Ahmed Alharfi
bs_BA	Bosnian	Vukasin Stojkov
by_BY	Belarusian	Илья
da_DK	Danish	Rune Clausen
de_DE	German	Tobias Koch
es_ES	Spanish	Germán L. Martínez (Gershu)
fa_IR	Persian	Ehsan SH
fr_FR	French	psykotik
hr_HR	Croatian	1984da
hu_HU	Hungarian	KOOS, Tamas
it_IT	Italian	Gianni Diurno (aka gidibao)
ja	Japanese	Urepko Asaba
lt_LT	Lithuanian	Lulilo
lv_LV	Latvian	Maris Svirksts
nl_NL	Dutch	Kristof Vercruyssen
pl_PL	Polish	Marcin Gucia
pt_PT	Portugese	Djamilo Jacinto
ru_RU	Russian	Andrew Malarchuk
sr_RS	Serbian	Vukasin Stojkov
sv_SE	Swedish	Julian Kommunikation
ta_IN	Tamil	Srini
tr_TR	Turkish	Gürkan Gür
uk_UA	Ukrainian	Stas

If you can translate the plugin in your language, please do, and please send me the localized file so that I can add to the next version of the plugin. The localization template file (quotes-collection.pot) can be found in the ‘languages’ folder of the plugin. If you want to translate the plugin in your language, but are not sure how to go about doing it, contact me, I’ll help you out.

Feedback

Please report any defects you may find with this plugin using the contact form or as a comment here. All feedback and suggestions welcome.

Change Log

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 <h2></h2> tags above random quote when title field is left blank in widget control options. <h2> 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