=== 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.1.1
Stable tag: 2.0.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.
* Categories.
* Gallery slideshow.
* Icons: dash-icons or add your own.
* 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 from a category.*
**[quotes-llama cat='category']**

*Display a dynamically positioned gallery. - (auto-refresh)*
**[quotes-llama mode="gallery"]**

*Display a dynamically positioned gallery from a category. - (auto-refresh)*
**[quotes-llama mode='gallery' cat='category']**

*Display a indexed and searchable page of quote Authors.*
**[quotes-llama mode="page"]**

*Display a indexed and searchable page of quote Authors.*
**[quotes-llama mode='page' cat='category']**

*Display a random quote that will auto-refresh.*
**[quotes-llama mode="auto"]**

*Display a random quote from a category that will auto-refresh.*
**[quotes-llama mode='auto' cat='category']**

*Display static quotes.*
**[quotes-llama id="#,#,#"]**

*Display all quotes by id, random, ascending, or descending.*
**[quotes-llama all="id"]**
**[quotes-llama all="random"]**
**[quotes-llama all="ascend"]**
**[quotes-llama all="descend"]**

**To include this plugin in a Template File:**
*Display a random quote.*
**do_shortcode( "[quotes-llama]" );**

*Display a random quote from a category.*
**do_shortcode( "[quotes-llama cat='category']" );**

*Display a dynamically positioned gallery. - (auto-refresh)*
**do_shortcode( "[quotes-llama mode='gallery']" );**

*Display a dynamically positioned gallery from a category. - (auto-refresh)*
**do_shortcode( "[quotes-llama mode='gallery' cat='category']" );**

*Display an indexed and searchable page of quote Authors.*
**do_shortcode( "[quotes-llama mode='page']" );**

*Display an indexed and searchable page of quote Authors by category.*
**do_shortcode( "[quotes-llama mode='page' cat='category']" );**

*Display a random quote that will auto-refresh.*
**do_shortcode( "[quotes-llama mode='auto']" );**

*Display a random quote from a category that will auto-refresh.*
**do_shortcode( "[quotes-llama mode='auto' cat='category']" );**

*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, bmp, svg) can be copied to the "wp-content/uploads/quotes-llama/" directory.

= 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*) - `<a href="http://example.com" target="_blank" rel="nofollow" class="class" title="example">example</a>`
* **b** - `<b>`**Bold text**`</b>`
* **br** (*clear*) - `<br clear="left">`
* **del** - `<del>`This text will have a line through it.`</del>`
* **em** - `<em>`*Emphasized text.*`</em>`
* **i** - `<i>`*Italic text.*`</i>`
* **mark** - `<mark>`Highlight text`</mark>`
* **small** - `<small>`Small text`</small>`
* **strong** - `<strong>`**This text is important!**`</strong>`
* **sub** - `<sub>`Subscripted text`</sub>`
* **sup** - `<sup>`Superscripted text`</sup>`
* **u** - `<u>`Underlined text`</u>`

= Security =
Be aware that external linking of sites and images creates the possibility of a (broken link attack) security risk.

= Troubleshooting, Known Bugs, ToDo =
* **Troubleshooting** 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.
* **ToDo** Method for uploading icons from within the options page.
* **ToDo** A page of all categories which link to individual category page of quotes. [quotes-llama mode='page' cat='*'] => [quotes-llama mode='page' cat='category']
* **Bug** Quote timer (setInterval) on gallery and auto quotes becomes out of sync when left for long periods of time.
* **Bug** Widget and auto mode timers nested in quote instead of quote-box as in gallery mode.

= Beta Testing =
Some features or specific parts of this plugin may still be in testing mode. Assistance identifying hidden bugs is needed and encouraged. If you would like to help beta test this plugin, please contact the author using the link provided in the plugin shortcodes tab.

== 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 2.0.2 =
* **Fix** Category "Object to string" fatal error on some environments when adding new quote. (identified by: Lomig Unger)

= Version 2.0.1 =
* **Add** Quotes can now be filtered by multiple categories at once.
* **Fix** Category column not styled in admin quotes tab.
* **Change** Categories now use textbox and checkbox lists instead of a datalist.

= Version 2.0.0 =
* **Add** CATEGORIES!!! Table column "category".
* **Add** Category column to quotes list tab.
* **Add** Category <datalist> field to New and Edit quote forms.
* **Add** Category shortcodes and a widgets category <select> field.
* **Add** Link to the Widgets page in the Shortcode tab.
* **Fix** Icons display in shortcode "all" for author/source when there is no author/source.
* **Fix** Galleries z-index causing hover over other content, escpecially site headings.
* **Fix** Widgets quote ID and title settings fields not populating values after updating.
* **Fix** Titles still display when "show authors" is disabled in options.
* **Fix** When author and image are disabled in widget, clicking next quote displays the author and image.
* **Change** Javascript variables defined to reflect appropriate scope. (var/let)

= Version 1.3.6 =
* **Fix** After updating default [quotes-llama] shortcode no longer working. (identified by: hawkeeye)

= Version 1.3.5 =
* **Add** Shortcode to display all quotes in a single page by (id, random, ascending, or descending.) (suggested by: eventfotografi)
* **Fix** Widgets still display timer when global timer setting is disabled. (identified by: John P)
* **Change** Updated Shortcodes tab.

= Version 1.3.4 =
* **Add** Bitmap (bmp) images supported as icons.
* **Add** Button to remove the quotes table from the database added to the import/export tab... Administrators only.
* **Fix** More extensive image validation.
* **Fix** .wp-list-table overwriting global WordPress admin table style. (identified by: efishinsea)
* **Change** Update author link in shortcodes tab.
* **Change** $_REQUESTs changed to $_GET and $_POST globals.

= Version 1.3.3 =
* **Fix** Icons folder should not be in plugin folder as it gets overwritten when updating the plugin.
* **Change** Changed icons folder to "wp-content/uploads/quotes-llama/".

= Version 1.3.2 =
* **Fix** Upgrade not properly comparing versions.

= Version 1.3.1 =
* **Add** IMAGE-ICONS!!! Support for images as icons. Icons can be created by placing (png, jpg, gif, svg) images in the (wp-content/uploads/quotes-llama/) 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** DASH-ICONS!!! 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** TITLES!!! 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** HTML!!! 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 =
* **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.
* **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.

= Version 1.1.0 =
* **Add** Expand the use of make_clickable to all form fields.
* **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.

= 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 =
* **Add** WordPress Caching on larger datasets. Enable/disable in options.
* **Fix** Security fixes and coding standards update. (phpcs.php - WordPress coding standards) 
* **Change** Versioning changed to Semantic Versioning. (Major.Minor.Patch)

= Version 0.7 =
* **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.
* **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.

= 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 =
* **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)
* **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)

= Version 0.5.1 =
* **Add** Translation .po and .mo files for es_ES Spanish. (provided by David Busto from http://alfabetadigital.com)
* **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)

= Version 0.5 =
* **Add** Option to show or hide the 'next quote' link in widgets. (suggested by: philait)
* **Fix** Shortcodes not rendering in the order of page design but at the top of page. (identified by: dennisxrich)

= Version 0.4.4 =
* **Fix** Incorrect open php declaration (<? to <?php) on line 3449 which causes unexpected 'public' (T_PUBLIC) error in sites with php short tags disabled. (identified by: begna112)

= Version 0.4.3 =
* **Add** Button to select image from the media library when adding a new or editing an existing quote. (suggested by: Arleen)
* **Change** Reorder hooks and actions separating admin and front-end scripts so they are only called on their relevant pages.
* **Change** Updated links in the shortcodes tab.

= Version 0.4.2 =
* **Add** Option to display the source on a "new line" or use a "comma" to separate it from the author. (suggested by: Arleen)
* **Fix** Comma was still showing in gallery and auto-refresh. 

= Version 0.4.1 =
* **Fix** Comma showing between author and source when author is set to not be displayed. (identified by: Arleen)

= Version 0.4 =
* **Add** Option to limit the number of characters displayed in quotes, with a "read more/read less" link. (suggested by: skhanna55)
* **Fix** Safe HTML elements and attributes can now occur in quotes on the front-end. (identified by: ddragon123)

= Version 0.3 =
* **Add** Option to display a static quote by ID.
* **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.

= 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 =
* **Add** Auto-refresh option added to the Quotes llama widget.
* **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.

= 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