=== Sanctus - Saint du jour ===
Contributors: saintdujoursanctus
Tags: saint du jour, saints, calendrier, catholique, spiritualite
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Displays the saint or saints celebrated each day in a responsive widget linked to their complete biographies on Sanctus.

== Description ==

Sanctus - Saint du jour permet d'ajouter facilement le calendrier quotidien des saints à un site WordPress.

L'encart affiche le portrait, le nom, la date et un extrait biographique. Lorsqu'il y a plusieurs saints, ils apparaissent successivement dans un carrousel discret. Chaque saint renvoie vers sa biographie complète sur Sanctus.

Deux méthodes d'intégration sont proposées :

* le bloc Gutenberg « Saint(e)s du jour - Sanctus » ;
* le shortcode `[sanctus_saint_du_jour]`.

Le thème peut suivre automatiquement les préférences du visiteur ou être forcé en mode clair ou sombre.

Un lien de soutien « Proposé par Sanctus » peut être activé dans Réglages > Sanctus. Il apparaît sous tous les widgets, directement dans le HTML de votre site et en dehors de l'iframe. Ce lien est désactivé par défaut et n'est jamais nécessaire au fonctionnement du widget.

Exemples de shortcode :

`[sanctus_saint_du_jour]`

`[sanctus_saint_du_jour theme="dark" max_width="720"]`

== External service ==

This plugin embeds the daily-saint widget provided by Sanctus at `https://www.sanctus-sanctus.fr/widget/saint-du-jour`.

The service is contacted only on pages where the site owner has added the Sanctus block or shortcode. As with any web request, the visitor's IP address, browser user agent and referring page may be transmitted to the Sanctus server. The widget displays data and images supplied by Sanctus and contains links to the corresponding saint biographies and to the Sanctus website.

Sanctus legal and privacy information: https://www.sanctus-sanctus.fr/mentions-legales

Service website: https://www.sanctus-sanctus.fr/

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/sanctus-saint-du-jour`, or install the ZIP from the WordPress Plugins screen.
2. Activate « Sanctus - Saint du jour ».
3. Add the « Saint(e)s du jour - Sanctus » block in the editor, or use `[sanctus_saint_du_jour]`.
4. Choose the automatic, light or dark theme and the maximum width in the block settings when needed.
5. Optionally enable the visible attribution link in Settings > Sanctus. This applies to existing blocks and shortcodes without editing their content.

== Frequently Asked Questions ==

= Does the content update automatically? =

Yes. The widget retrieves the current day's content directly from Sanctus. No daily action is required in WordPress.

= Can I use the widget with the classic editor? =

Yes. Add the shortcode `[sanctus_saint_du_jour]` to the page or article.

= Which themes are available? =

Use `auto`, `light` or `dark`. The default `auto` theme follows the visitor's system preference.

= Does the plugin store personal data in WordPress? =

No. The plugin does not create user accounts, store form submissions or write visitor data to the WordPress database. The embedded Sanctus service receives standard web-request information as explained in the External service section.

= How do I display a direct link to Sanctus below the widget? =

Open Settings > Sanctus, enable the optional "Proposé par Sanctus" link, and save. The link is rendered by WordPress outside the iframe, even when JavaScript is disabled. Existing blocks and shortcodes do not need to be edited. The link can be disabled at any time and does not guarantee any search-ranking benefit.

== Screenshots ==

1. Aperçu de l'extension WordPress et du widget quotidien Sanctus.

== Upgrade Notice ==

= 1.0.1 =

Adds an optional direct attribution link. After updating, enable it once in Settings > Sanctus if desired. Existing widget content and settings remain unchanged.

== Changelog ==

= 1.0.1 =

* Added an optional, server-rendered "Proposé par Sanctus" link below the iframe.
* Added Settings > Sanctus to enable or disable the link for all existing widgets.
* Added light, dark and automatic attribution styles and a keyboard focus indicator.

= 1.0.0 =

* Initial release with a Gutenberg block and shortcode.
* Automatic, light and dark themes.
* Responsive iframe resizing.
