{"id":29323,"date":"2014-05-07T12:34:50","date_gmt":"2014-05-07T12:34:50","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/mg-quotes\/"},"modified":"2015-03-21T15:41:55","modified_gmt":"2015-03-21T15:41:55","slug":"mg-quotes","status":"publish","type":"plugin","link":"https:\/\/kir.wordpress.org\/plugins\/mg-quotes\/","author":7659509,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.1.5","stable_tag":"trunk","tested":"4.0.38","requires":"3.1","requires_php":"","requires_plugins":"","header_name":"mg Quotes","header_author":"Giulio 'mgiulio' Mainardi","header_description":"","assets_banners_color":"","last_updated":"2015-03-21 15:41:55","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"http:\/\/mgiulio.info\/projects\/mg-quotes\/","header_author_uri":"http:\/\/mgiulio.info","rating":4,"author_block_rating":0,"active_installs":100,"downloads":4868,"num_ratings":4,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":"1","2":0,"3":0,"4":0,"5":"3"},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1.3"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":"911541","resolution":"1","location":"assets"},"screenshot-2.png":{"filename":"screenshot-2.png","revision":"911541","resolution":"2","location":"assets"},"screenshot-3.png":{"filename":"screenshot-3.png","revision":"911541","resolution":"3","location":"assets"},"screenshot-4.png":{"filename":"screenshot-4.png","revision":"911541","resolution":"4","location":"assets"},"screenshot-5.png":{"filename":"screenshot-5.png","revision":"911541","resolution":"5","location":"assets"},"screenshot-6.png":{"filename":"screenshot-6.png","revision":"911541","resolution":"6","location":"assets"}},"screenshots":{"1":"Admin Menu","2":"List Table","3":"Quote Editor","4":"Author Page","5":"Categories Page","6":"Widgets"},"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[354,8437],"plugin_category":[],"plugin_contributors":[85357],"plugin_business_model":[],"class_list":["post-29323","plugin","type-plugin","status-publish","hentry","plugin_tags-quotes","plugin_tags-random-quotes","plugin_contributors-giuliom","plugin_committers-giuliom"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/mg-quotes.svg","icon_2x":false,"generated":true},"screenshots":[{"src":"https:\/\/ps.w.org\/mg-quotes\/assets\/screenshot-1.png?rev=911541","caption":"Admin Menu"},{"src":"https:\/\/ps.w.org\/mg-quotes\/assets\/screenshot-2.png?rev=911541","caption":"List Table"},{"src":"https:\/\/ps.w.org\/mg-quotes\/assets\/screenshot-3.png?rev=911541","caption":"Quote Editor"},{"src":"https:\/\/ps.w.org\/mg-quotes\/assets\/screenshot-4.png?rev=911541","caption":"Author Page"},{"src":"https:\/\/ps.w.org\/mg-quotes\/assets\/screenshot-5.png?rev=911541","caption":"Categories Page"},{"src":"https:\/\/ps.w.org\/mg-quotes\/assets\/screenshot-6.png?rev=911541","caption":"Widgets"}],"raw_content":"<!--section=description-->\n<p>This plugin adds a new custom post type to manage and publish your favorite quotes with WordPress.<\/p>\n\n<p>Quick features summary:<\/p>\n\n<ul>\n<li>Enter the quote content in a multiline editor<\/li>\n<li>Optionally assign an author to a quote, with autocompletion for already existent authors<\/li>\n<li>Optionally assign multiple hierarchical categories to the quote<\/li>\n<li>Optionally assign one or more custom fields: date, where, link, ...<\/li>\n<li>Autogeneration of quote titles<\/li>\n<li>Quickly browse through your quotes with author and\/or category filters and full text search<\/li>\n<li>Import\/Export of quotes between WordPress installations<\/li>\n<li>Publish quotes on the front end with widgets, shortcodes and template tags<\/li>\n<li>Restrict or allow access to the quotes and the relative operations in admin with fine grained access control <\/li>\n<li>Cleanup on uninstall<\/li>\n<\/ul>\n\n<p><strong>Manage the quotes<\/strong><\/p>\n\n<p>Start managing your quotes accessing the new top menu 'Quotes':<\/p>\n\n<p>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\none or more (hierarchical) categories.\nIt is possible to define a title for the quotes, mainly used in the quote listing; if it is not provided it will be autogenerated.\nIt 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, ...<\/p>\n\n<p>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.<\/p>\n\n<p>From the Quotes\/All quotes page there is the standard post list table WP user interface to browse through the quotes.\nThere is the full text search and two filters for the author and\/or the category.<\/p>\n\n<p><em>Restrict or allow access to the quotes and the relative operations in admin with fine grained access control<\/em><\/p>\n\n<p>The plugin defines and assigns at installation time the following primitive capabilities to the 'administrator' role:<\/p>\n\n<p>Category custom taxonomy:<\/p>\n\n<ul>\n<li>'manage_quote_categories'<\/li>\n<li>'edit_quote_categories'<\/li>\n<li>'delete_quote_categories'<\/li>\n<li>'assign_quote_categories'<\/li>\n<\/ul>\n\n<p>Author custom taxonomy:<\/p>\n\n<ul>\n<li>'manage_quote_authors'<\/li>\n<li>'edit_quote_authors'<\/li>\n<li>'delete_quote_authors'<\/li>\n<li>'assign_quote_authors'<\/li>\n<\/ul>\n\n<p>Quote custom post type:<\/p>\n\n<ul>\n<li>'edit_quotes'<\/li>\n<li>'edit_others_quotes'<\/li>\n<li>'publish_quotes'<\/li>\n<li>'read_private_quotes'<\/li>\n<li>'read'<\/li>\n<li>'delete_quotes'<\/li>\n<li>'delete_private_quotes'<\/li>\n<li>'delete_published_quotes'<\/li>\n<li>'delete_others_quotes'<\/li>\n<li>'edit_private_quotes'<\/li>\n<li>'edit_published_quotes'<\/li>\n<\/ul>\n\n<p>Their names should be self-explanatory.<\/p>\n\n<p>To customize the access control it is sufficient to grant\/revoke such caps with a role editing plugin, for example <a href=\"http:\/\/wordpress.org\/plugins\/user-role-editor\/\">User Role Editor<\/a>.<\/p>\n\n<p><em>Import\/Export<\/em><\/p>\n\n<p>To copy all the quotes from a WordPress instance to another just use the related tools provided by WordPress, accessible from the Tools menu.<\/p>\n\n<p><strong>Publish the quotes<\/strong><\/p>\n\n<p>Quotes can be published on the front end with three methods: widgets, shortcodes and template tags.<\/p>\n\n<p><em>Widgets<\/em><\/p>\n\n<p>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.<\/p>\n\n<p>The Selected Quote widget allows to display a specific quote. Just select it with the control that lists all quotes by their titles.<\/p>\n\n<p>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.<\/p>\n\n<p><em>Shortcodes<\/em><\/p>\n\n<p>Shortcodes can be used to display quotes in posts and pages.<\/p>\n\n<p>To display a quote in a post or page use the [quote] shortcode passing it the ID of the quote. \nQuote IDs can be easily read from the Quotes\/All Quotes page, hovering with the mouse on the relevant row of the quotes list table.\nSo, to display in a post a quote whose ID is 181 just enter [quote id=\"181] in the post content editor.<\/p>\n\n<p>To display a random quote from all the quotes or only from a category and\/or author there is the [rnd_quote] shortcode. \nCategory and author, when provided, must be identified by their name.\nExample:<\/p>\n\n<p>[rnd_quote] -&gt; random quote\n[rnd_quote author=\"Oscar Wilde\"] -&gt; a random quote from the author 'Oscar Wilde'\n[rnd_quote category=\"Art\"] -&gt; a random quote from the 'Art' category\n[rnd_quote category=\"Art\" author=\"Pablo Picasso\"] -&gt; a random quote in the 'Art' category and by the 'Pablo Picasso' author<\/p>\n\n<p><em>Template tags<\/em><\/p>\n\n<p>If you prefer to modify the theme templates, two template tags are available that mimic the behaviour of the widgets and shortcodes.<\/p>\n\n<ul>\n<li>mg_qt_get_quote($id) gets a single quote, specified by its ID<\/li>\n<li>mg_qt_get_rnd_quote($category = null, $author = null) Pick one random quote, optionally from the category and\/or the author specified(by they names)<\/li>\n<\/ul>\n\n<p>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) \ninstead directly output the markup.<\/p>\n\n<p><em>Quote markup customization<\/em><\/p>\n\n<p>By default the markup generated for a quote is something like this:<\/p>\n\n<pre><code>&lt;blockquote class=\"mg_qt_quote\"&gt;\n    &lt;p&gt;WordPress puts food on my table&lt;\/p&gt;\n    &lt;footer class=\"meta\"&gt;\n        &lt;cite class=\"author\"&gt;Mark Jaquith&lt;\/cite&gt;\n    &lt;\/footer&gt;\n&lt;\/blockquote&gt;\n<\/code><\/pre>\n\n<p>To modify this template the 'mg_qt_quote_markup' filter is available. It it invoked with two parameters:<\/p>\n\n<ol>\n<li>The generated html<\/li>\n<li>An associative array with the quote data. The available keys are: 'content', 'author', 'title', 'id'.<\/li>\n<\/ol>\n\n<p><strong><a href=\"https:\/\/www.pinterest.com\/pin\/119415827596386237\/\">Some additional info<\/a>.<\/strong><\/p>\n\n<p><strong>Source Code<\/strong><\/p>\n\n<p>The plugin source code is also availabe on <a href=\"https:\/\/github.com\/mgiulio\/mg-quotes\">GitHub<\/a>.<\/p>\n\n<!--section=installation-->\n<p>The standard procedures for WP plugins installation apply:<\/p>\n\n<ol>\n<li>Upload the plugin to your WordPress site<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<\/ol>\n\n<p>When the plugin is deleted it will remove all its data from the database.<\/p>\n\n<!--section=faq-->\n<p>No questions yet.<\/p>\n\n<!--section=changelog-->\n<h4>1.1.5<\/h4>\n\n<ul>\n<li>Fix: allow quote listing on front end with permalink \/quotes<\/li>\n<\/ul>\n\n<h4>1.1.4<\/h4>\n\n<ul>\n<li>Enhancement: Allow quote comments<\/li>\n<\/ul>\n\n<h4>1.1.3<\/h4>\n\n<ul>\n<li>Fix: Flush rewrite rules at plugin activation to avoid permalink problems<\/li>\n<\/ul>\n\n<h4>1.1.2<\/h4>\n\n<ul>\n<li>Enhancement: group widgets together in Available Widgets area<\/li>\n<\/ul>\n\n<h4>1.1.1<\/h4>\n\n<ul>\n<li>Bug fix: Fix syntax error for older PHP versions<\/li>\n<\/ul>\n\n<h4>1.1<\/h4>\n\n<ul>\n<li>Feature: Fine grained access control in admin<\/li>\n<li>Feature: Support of quote post author(the WP user that entered the quote)<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Fix: display post ID only on quote CPT list table<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Add screenshots<\/li>\n<li>readme.txt fixes and updates<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>First release<\/li>\n<\/ul>","raw_excerpt":"Manage and publish your favorite quotes with WordPress","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/29323","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=29323"}],"author":[{"embeddable":true,"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/giuliom"}],"wp:attachment":[{"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=29323"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=29323"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=29323"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=29323"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=29323"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/kir.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=29323"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}