=== DS-Web Random Quotes for Kaamelott ===
Contributors: dsweb73
Tags: quotes, random quote, block, shortcode, kaamelott
Requires at least: 6.3
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display a random quote from the French TV series Kaamelott, with its character, book and episode, using a block or the [rep-kaa] shortcode.

== Description ==

In the spirit of Hello Dolly, this plugin displays a random line from Kaamelott on your site.

* A "Kaamelott quote" block, with filters by book or character.
* A `[rep-kaa]` shortcode with its own settings page and built-in documentation.
* Three display templates: full (quote, character, book, episode), character only, quote only.
* Optional "Another quote" button, refreshed without reloading the page.
* Page-cache friendly mode (quote picked in the browser).
* Fonts bundled and served locally (no Google Fonts request): MedievalSharp, Uncial Antiqua and Luciole, a typeface designed for visually impaired readers. Papyrus is used when installed on the visitor's device.
* CSV import with duplicate detection.

**No quotes are included.** Add your own quotes manually or import them from a CSV file (see `exemple-import.csv`).

This is an unofficial fan plugin made by DS-Web. It is not affiliated with, endorsed or sponsored by Alexandre Astier, CALT Production or the rights holders of Kaamelott.

== Installation ==

1. Install and activate the plugin.
2. Go to Kaamelott Quotes > Import (CSV) to import your quotes, or Kaamelott Quotes > Add quote to add them one by one.
3. Insert the "Kaamelott quote" block, or use the `[rep-kaa]` shortcode (settings and parameters under Kaamelott Quotes > Settings).

== Frequently Asked Questions ==

= What CSV format is expected? =

A header row `replique;personnage;livre;episode` (quote, character, book, episode), separator `;` or `,`, UTF-8 or Windows-1252. The book can be written "Livre II", "Book II", "II", "2" or "Premier volet".

= Which shortcode parameters are available? =

`police` (medievalsharp, uncial, papyrus, luciole), `modele` (complet, personnage, replique), `bouton` (oui, non), `livre`, `personnage`, `navigateur` (oui, non). Example: `[rep-kaa modele="personnage" bouton="non"]`.

= Why does Papyrus not show up? =

Papyrus is a commercial font and cannot be bundled. It is only displayed on devices where it is already installed (Windows, macOS); other visitors see MedievalSharp.

== Screenshots ==

1. The quote block on the front end.
2. The shortcode settings page.

== Changelog ==

= 1.0.0 =
* First release.

== Credits ==

* MedievalSharp by wmk69 – SIL Open Font License 1.1
* Uncial Antiqua by Astigmatic – SIL Open Font License 1.1
* Luciole by Laurent Bourcellier & Jonathan Perez – Creative Commons Attribution 4.0
