Manage and publish your favorite quotes with WordPress
This plugin adds a new custom post type to manage and publish your favorite quotes with WordPress.
Quick features summary:
Manage the quotes
Start managing your quotes accessing the new top menu 'Quotes':
In the quote editor enter the quote content and optionally, its author(if you have already added it before just type a part of its name to get an autocompletion) and one or more (hierarchical) categories. It is possible to define a title for the quotes, mainly used in the quote listing; if it is not provided it will be autogenerated. It is also possible to define some custom fields, for example to assign further informations about the quote, such as a date, a link, a place, ...
The authors are implemented with a custom taxonomy, so from the Quotes/Authors page it is possible to manage them with the standard WP interface.
From the Quotes/All quotes page there is the standard post list table WP user interface to browse through the quotes. There is the full text search and two filters for the author and/or the category.
Restrict or allow access to the quotes and the relative operations in admin with fine grained access control
The plugin defines and assigns at installation time the following primitive capabilities to the 'administrator' role:
Category custom taxonomy:
Author custom taxonomy:
Quote custom post type:
Their names should be self-explanatory.
To customize the access control it is sufficient to grant/revoke such caps with a role editing plugin, for example User Role Editor.
To copy all the quotes from a WordPress instance to another just use the related tools provided by WordPress, accessible from the Tools menu.
Publish the quotes
Quotes can be published on the front end with three methods: widgets, shortcodes and template tags.
The Selected Quote and the Random Quote widgets can be used to to display one single quote in the widget areas provided by the used theme.
The Selected Quote widget allows to display a specific quote. Just select it with the control that lists all quotes by their titles.
The random quote displayed by the homonymous widget can be optionally limited to the quotes by an author and/or a category using the provided controls.
Shortcodes can be used to display quotes in posts and pages.
To display a quote in a post or page use the [quote] shortcode passing it the ID of the quote. Quote IDs can be easily read from the Quotes/All Quotes page, hovering with the mouse on the relevant row of the quotes list table. So, to display in a post a quote whose ID is 181 just enter [quote id="181] in the post content editor.
To display a random quote from all the quotes or only from a category and/or author there is the [rnd_quote] shortcode. Category and author, when provided, must be identified by their name. Example:
[rnd_quote] -> random quote [rnd_quote author="Oscar Wilde"] -> a random quote from the author 'Oscar Wilde' [rnd_quote category="Art"] -> a random quote from the 'Art' category [rnd_quote category="Art" author="Pablo Picasso"] -> a random quote in the 'Art' category and by the 'Pablo Picasso' author
If you prefer to modify the theme templates, two template tags are available that mimic the behaviour of the widgets and shortcodes.
These two functions return a string with the HTML markup for the picked quote; mg_qt_quote($id) and mg_qt_rnd_quote($category = null, $author = null) instead directly output the markup.
Quote markup customization
By default the markup generated for a quote is something like this:
<blockquote class="mg_qt_quote"> <p>WordPress puts food on my table</p> <footer class="meta"> <cite class="author">Mark Jaquith</cite> </footer> </blockquote>
To modify this template the 'mg_qt_quote_markup' filter is available. It it invoked with two parameters:
The plugin source code is also availabe on GitHub.