=== Quotes llama ===
Contributors: oooorgle
Donate link: http://oooorgle.com/plugins/wp/quotes-llama/
Tags: Quotes, Quote, Share
Requires at least: 4.2.2
Tested up to: 6.0.2
Stable tag: 1.3.2
License: CopyHeart
License URI: http://copyheart.org
Share the thoughts that mean the most... display your quotes in block, widget, page, template, gallery or post.
== Description ==
= Create a collection of quotes. =
* Include quotes in blocks, widgets, pages, templates, galleries or posts.
* Searchable.
* Rotating gallery.
* Icons: dash-icons and add your own icons.
* Backup and Restore: **(.json)** and **(.csv)** formats.
* Other options for how your quotes are displayed.
== Installation ==
= How to install via Dashboard =
* Go to *Plugins* -> *Add New*.
* Search for *quotes-llama*.
* Click *Install Now*.
* Activate the plugin through the *Plugins* menu in the Dashboard.
= How to install via .zip file =
* After downloading, in the dashboard, go to *Plugins* -> *Add New* -> *Upload Plugin*.
* Click *Browse* and select the quotes-llama.zip file.
* Click *Install Now*.
* Activate the plugin through the *Plugins* menu in the Dashboard.
* You can also extract the .zip file. Then copy the *quotes-llama* folder to the */wp-content/plugins/* directory.
= How to install via FTP =
* After downloading and extracting the quotes-llama.zip file. Upload the *quotes-llama* folder to the */wp-content/plugins/* directory.
* Activate the plugin through the *Plugins* menu in the Dashboard.
= Shortcodes =
Use the plugin by including a shortcode or by including the widget in the desired location:
**To include this plugin in a Block, Page or Post:**
*Display a random quote.*
**[quotes-llama]**
*Display a random quote that will auto-refresh.*
**[quotes-llama mode="auto"]**
*Display a dynamically positioned gallery. - (auto-refresh)*
**[quotes-llama mode="gallery"]**
*Display a indexed and searchable page of quote Authors.*
**[quotes-llama mode="page"]**
*Display static quotes.*
**[quotes-llama id="#,#,#"]**
**To include this plugin in a Template File:**
*Display a random quote.*
**do_shortcode( "[quotes-llama]" );**
*Display a random quote that will auto-refresh.*
**do_shortcode( "[quotes-llama mode='auto']" );**
*Display a dynamically positioned gallery. - (auto-refresh)*
**do_shortcode( "[quotes-llama mode='gallery']" );**
*Display an indexed and searchable page of quote Authors.*
**do_shortcode( "[quotes-llama mode='page']" );**
*Display static quotes.*
**do_shortcode( "[quotes-llama id='#,#,#']" );**
*To include this plugin in a Widget:*
*Drag-and-drop the Quotes llama widget located in the Widgets Page to the desired location.
== Frequently Asked Questions ==
= Icons =
* The WordPress Dash-Icons set is included by default.
* Custom image icons (png, gif, jpg, svg) can be copied to the "inc/icons" directory located in the plugin folder.
* Be sure to backup your custom icons! Currently working to fix a known bug where the images in the icons folder are deleted when upgrading the plugin. Re-uploading the images is then required.
= Basic Formatting =
* Create a link by entering the url in any text field. It will display the protocol ("Display http") if enabled in the options. It will always show the top level domain (.com, .net, etc).
* Create a new line in the quotes field with (enter) or (shift+enter).
= Advanced Formatting =
* Remember to add closing tags for your HTML elements. Anything that follows an opening tag in the HTML code will become nested until a closing tag is found. Missing closing tags apply to the rest of that element.
* Text fields are limited to 255 characters.
* Html links display just the text given and are not affected by the "Display http" option.
* **Tag** (*attribute*) - 'example'
* **a** (*href*, *target*, *rel*, *class*, *title*) - `example`
* **b** - ``**Bold text**``
* **br** (*clear*) - `
`
* **del** - ``This text will have a line through it.``
* **em** - ``*Emphasized text.*``
* **i** - ``*Italic text.*``
* **mark** - ``Highlight text``
* **small** - ``Small text``
* **strong** - ``**This text is important!**``
* **sub** - ``Subscripted text``
* **sup** - ``Superscripted text``
* **u** - ``Underlined text``
= Security =
Be aware that external linking of sites and images creates the possibility of a (broken link attack) security risk.
= Known Bugs =
Images in the "inc/icons" folder are removed when upgrading plugin.
== Changelog ==
* You may need to deactive/active the plugin to initialize new options. If you encounter any errors, please uninstall/re-install the plugin before submitting a support request.
= Version 1.3.2 =
* **Fix** Upgrade not properly comparing versions.
= Version 1.3.1 =
* **Add** Support for images as icons. Icons can be created by placing (png, jpg, gif, svg) images in the (inc/icons) folder.
* **Add** Admin panel quotes tab now displays the current icon for each quote.
* **Fix** Admin panel quotes tab search not including default icon.
* **Fix** Admin panel quotes tab image alt text has the url before the name, it should only be the name.
* **Fix** Admin panel quotes tab fields overlap with smaller displays. Update css for admin panel.
* **Fix** Bulk delete not passing paged parameter so it returns to first page instead of current page.
* **Fix** Removed misplaced jQuery in dash-icons.js. dead code.
* **Fix** The "rotate" dash-icon is not properly named.
* **Change** Upgrade method table fields VARCHAR( 50 ) to VARCHAR( 255 ).
* **Change** Icons lists changed to array instead of html.
* **Change** Fully merged WP_List_table into the QuotesLlama_Table class.
* **Change** Remove QuotesLlama_List_Table class... dead code.
= Version 1.3.0 =
* **Add** WordPress Dashicons for author and source. Icons can now be set per individual quote, with a default set in the options.
* **Add** Database table column "author_icon" and "source_icon".
* **Add** Update upgrade function for backwards compatiblity to create table columns.
* **Fix** Source elements not aligning to the right when using comma seperator.
* **Fix** A space is inserted in place of title when ommitting title from an author. (identified by: gendji)
* **Fix** If no database, raw error messages are being displayed in shortcodes. Message "Database table cannot be found!" instead.
* **Fix** When editing a quote, url edit params passing to other tabs which prevents loading of the quote tab.
* **Fix** http displaying in javascript generated text links even though disabled in options.
* **Fix** Admin panel quotes tab not paginating correctly.
* **Fix** Searches, edits, and pagination in the admin panel quotes tab are resetting search results.
* **Fix** Manually entering a page number in the admin panel quotes tab doesn't load the page.
* **Fix** Admin page hover applying to all tabs tr elements. Should apply only to quotes tab.
* **Change** Admin panel quotes tab page selector icons changed from &lsaquo to dashicons.
* **Change** Re-format quotes page search form.
= Version 1.2.0 =
* **Add** A "title" form field to better integrate name titles into the quotes page. (suggested by: gendji)
* **Add** Database table column "title_name".
* **Add** Upgrade function for backwards compatiblity to create table column.
* **Fix** Cache setting check is ommitting the quotes page when disabled.
* **Fix** Import function generating response text into header instead of return. Moved to return.
* **Fix** Import functions encoding/decoding needs rework.
* **Fix** Page authors list, authors quotes, and search results not correctly sorting.
* **Change* Re-enable link for quotes gallery and mode="auto" changed from "<<" to "dashicons-controls-forward".
= Version 1.1.2 =
* **Add** Include a set of text html formatting tags for the quote and source fields. (suggested by: gendji)
* **Add** Check html formatting for closing tags so to not bleed out onto other content.
* **Add** Include links created using the html 'a' tag for the quote and source fields. (suggested by: gendji)
* **Fix** Make_Clickable is opening links in the same window. Set target element to "_blank".
* **Fix** Bulk delete not showing count of quotes deleted.
* **Change** "Display http" option text changed to differentiate between "text link" and "href link".
= Version 1.1.1 =
* **Fix** Since last update, the source arrow icon is displaying in the author field when there is no source. (identified by: gendji)
* **Fix** Debug warning 'characters in header' when importing quotes. Moved echo into return.
* **Add** Expand the use of make_clickable to filter URL protocols from displaying in text links. (suggested by: gendji)
* **Add** Options setting to omit/display URL protocols in text links.
= Version 1.1.0 =
* **Fix** Incorrect escaping of html in the quotes and source fields. (identified by: gendji)
* **Fix** New lines (Shift+Enter) in the quote field are not rendering in display. (identified by: gendji)
* **Fix** Debug warning when no quote exists.
* **Add** Expand the use of make_clickable to all form fields.
= Version 1.0.4 =
* **Fix** A reference to a null plugin setting causing 'characters in header' warnings upon activating plugin. Removed unused variable. "36-43, 136 of class-quotesllama.php"
* **Change** Considering _POST parameter 'random' to be unsafe. Changed 'quote_llama_random' to prevent conflicts with other plugins and modules that may use the 'random' parameter.
= Version 1.0.3 =
* **Fix** stripslashes() on .json export causing errors in export file. Removed stripslashes(). "225-229, 236 of class-quotesllama-backup.php"
= Version 1.0.2 =
* **Fix** Bulk action nonce needs isset() check or causes error in other modules bulk actions. "618 of class-quotesllama.php"
* **Fix** Variable "$quotes_ids" should be "$quote_ids". "2716 of class-quotesllama.php"
= Version 1.0.1 =
* **Fix** Unnecessary option. Function call with a required parameter after an optional parameter. "738 of class-quotesllama-list-table.php" (identified by: fidoboy)
* **Fix** Ommitted quotes. $_server environment entries are not quoted. (identified by: fidoboy)
= Version 1.0.0 =
* **Fix** Security fixes and coding standards update. (phpcs.php - WordPress coding standards)
* **Change** Versioning changed to Semantic Versioning. (Major.Minor.Patch)
* **Add** WordPress Caching on larger datasets. Enable/disable in options.
= Version 0.7 =
* **Fix** Having multiple galleries on a page was displaying the same quote and timer in all. Galleries now support multiple instances on a single page. (identified by: logologics)
* **Fix** Having multiple widgets on a page would only display content in the first widget. Widgets now support multiple instances on a single page. (identified by: soheilshadi)
* **Fix** Clicking on the seconds remaining in the gallery was starting conflicting timer instances.
* **Add** Widget and short-code now support more than one quote ID. e.g. [quotes-llama id="1,2,3"]
* **Add** Short-code [quotes-llama mode="auto"] that will auto-refresh the default [quote-llama] in pages, posts and templates.
= Version 0.6.5 =
* **Add** Next/Previous author buttons in the page view. (suggested by: Salvatore)
* **Fix** Limting the length of the quote now excludes the image path when determining quote length.
* **Fix** Moved styling for the quote "source" fields to their respective css files for better access to these elements. (identified by: spinhead)
= Version 0.6.4 =
* **Fix** html text entered into quotes was not decoding properly. (identified by: quote101)
* **Fix** The admin edit form was incorrectly displaying this same html text.
* **Fix** Gallery/Widget should not display \' or \" anymore. Stripslashes() on javascript generated quotes. (identified by: arnomuhren)
* **Fix** make_clickable() function was not being applied to all php generated quote fields.
* **Change** CSS styling split into separate files. Only relevant styles will be loaded on a page instead of all styles. This will improve page load time. (suggested by: Salvatore)
* **Change** Selecting an image from the library will now retrieve the image thumbnail instead of the full size image. This will greatly improve page load time for those using large images. (suggested by: Salvatore)
= Version 0.6.3 =
* **Add** Option to hide the countdown timer that displays in gallery and widgets. (suggested by: arnomuhren)
= Version 0.6.2 =
* **Fix** Bad path to translations folder. They should mostly now work with some exceptions still being worked on.
* **Fix** Add and Save Quote buttons not saving if language set to something other than English.
= Version 0.6.1 =
* **Fix** Prefix $_REQUEST variables "submit, import, export" with "quotes_llama_" to prevent nonce (Are you sure you want to do this?) conflict when using Tools import/export in dashboard. (identified by: m7csat)
* **Fix** Removed some redundant styling. (identified by: Salvatore)
= Version 0.6 =
* **Fix** Some translatable texts missing 'text domain' parameter causing their translations to fail. (identified by: sfbarth)
* **Fix** Authors links back button was not working. (code contributed by: Salvatore)
* **Fix** Authors and search print button was not working. (code contributed by: Salvatore)
* **Fix** Search button improvements and now works with keyboard 'enter' key. (code contributed by: Salvatore)
* **Change** Removed image filter from front-end and admin search forms. (suggested by: Salvatore)
* **Change** Replaced cite tags with small, em. (suggested by: Salvatore)
* **Change** Default author/source separator changed to br. (suggested by: Salvatore)
* **Add** Icons before the authors name and source. (code contributed by: Salvatore)
* **Add** Option to enable/disable icons before the authors name and source.
* **Add** Option to enable/disable search form between all visitors or just logged in users. (suggested by: Salvatore)
* **Add** Some responsive styling for better display on hand-held devices. (code contributed by: Salvatore)
* **Add** Quotes page and searches now display individual images instead of just the first image. (suggested by: Salvatore)
* **Add** Translation .po and .mo files for it_IT Italian. (provided by Salvatore)
= Version 0.5.1 =
* **Fix** replaced $_REQUEST variable "s" with "quotes_llama_s" to prevent nonce (Are you sure you want to do this?) conflict when using bulk actions in other administration pages. (identified by: fabiobcosta)
* **Add** Translation .po and .mo files for es_ES Spanish. (provided by David Busto from http://alfabetadigital.com)
= Version 0.5 =
* **Fix** Shortcodes not rendering in the order of page design but at the top of page. (identified by: dennisxrich)
* **Add** Option to show or hide the 'next quote' link in widgets. (suggested by: philait)
= Version 0.4.4 =
* **Fix** Incorrect open php declaration ( to quote." becomes unsearchable by the keyword "quote".
* **Add** Option to limit the number of characters displayed in quotes, with a "read more/read less" link. (suggested by: skhanna55)
= Version 0.3 =
* **Fix** Quotes with no image no longer display an image missing icon. (code contribued by: Salvatore)
* **Fix** Search bar width. (contribued by: Salvatore)
* **Fix** Style for the quotes container updated to inline-block to format nested quotes correctly.
* **Add** Option to display a static quote by ID.
= Version 0.2.1 =
* **Fix** Plugin now registers the sidebar widget using class function instead of create_function().
* **Fix** Moved "url is too long" _wp_http_referer filter from init hook to search $_REQUEST where it is used, as to not run on every page load.
* **Fix** Updated the widget class's parent constructor with a static name instead of having the function generate one.
= Version 0.2 =
* **Fix** Quotes table, links getting "url is too long" error. Filtering _wp_http_referer from url.
* **Fix** Quotes table, links sending incorrect $_REQUEST data.
* **Fix** Nonce conflict that prevented editing options pages in dashboard.
* **Add** Auto-refresh option added to the Quotes llama widget.
= Version 0.1.2 =
* **Fix** Nonce conflict that prevented saving options pages in dashboard.
= Version 0.1.1 =
* **Fix** Widgets no longer omits closing div.
= Version 0.1 =
* Initial Release
== Screenshots ==
1. Admin
2. Gallery
3. Widget
4. Page