=== Quotes llama ===
Contributors: oooorgle
Donate link: http://oooorgle.com/plugins/wp/quotes-llama/
Tags: Quote, Think, Share
Requires at least: 4.2.2
Tested up to: 6.1.1
Stable tag: 2.0.3
License: CopyHeart
License URI: http://oooorgle.com/copyheart
== Description ==
= Create a collection of quotes. Share the thoughts that mean the most... display your quotes in block, widget, page, template, gallery or post. =
* **Searchable**
* **Categories**
* **Floating Gallery**
* **Icons**
* **Backup/Restore**
* **... many options.**
== Frequently Asked Questions ==
= 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.
= 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 =
**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``
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.
= Next Quote Links =
You can configure the "next quote" link displayed in the options tab for widgets and wherever you place the shortcode `[quotes-llama]`.
Here are some examples:
* **Default**: *`…` (next quote)*
* **Plain Text**: *next quote >>*
* **Dash-Icon**: *next quote ``*
* **Unicode**: *next quote `»`*
You can also change how the link is displayed using CSS.
Some examples:
* `.quotes-llama-widget-random hr {display: none;}` This will remove the line between the quote and the link.
* `.quotes-llama-widget-next {text-align: left; font-style: normal;}` This will align to the left and remove the italic.
* You can include CSS to your theme to over-ride plugin styling... DO NOT directly edit any theme/plugin files as they are ALL overwritten when updating. One way is via Dashboard–>Appearance–>Customize–>Additional CSS.
= 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.
* **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.
== 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.
== Changelog ==
= Upgrade Notice / Changelog =
* New installs need take no action.
* If you are updating this plugin to the current version 2.0.3 you need to deactivate/activate the plugin for new settings to be enabled. There should be no impact other than you may notice the "next quote" link is missing until it is set in the options and enabled, or the plugin is deactivated/activated.
* Please deactivate/activate the plugin before submitting a support request.
= Version 2.0.3 =
* **Add** Shortcode [quotes-llama] will now display a "next quote" link if enabled in the options tab. (suggested by: mrtnthmsn)
* **Add** A link to the plugins translation page and a link tip to the dash-icons page.
* **Fix** Widget instance null producing "undefined array key" in error log. (identified by: fidoboy)
* **Change** Next quote link for widgets and random quotes can now be customized in the options tab. (suggested by: mrtnthmsn)
* **Change** Removed "lang" folder... dead code. Translations: https://translate.wordpress.org/projects/wp-plugins/quotes-llama/
= Version 2.0.2 =
* **Fix** Category "Object to string" fatal error on some environments when adding new quote. (identified & troubleshooted 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