=== Saturne Démarches ===
Contributors: saturneinnovations
Tags: service-public, government, france, municipality, administration
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 4.3.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Display official French public service procedures on your municipality's website, sourced from the open data feeds of service-public.fr.

== Description ==

**Saturne Démarches** embeds official French administrative content into your WordPress site. Built for French municipalities, local authorities and web agencies, the plugin displays administrative procedure sheets for individuals and associations, with built-in search and your local service contact details.

**Disclaimer:** Saturne Démarches is an independent plugin published by Saturne Innovations. It is **not affiliated with, endorsed by, or sponsored by** the DILA (Direction de l'information légale et administrative), service-public.fr, or the French government. "Service-Public.fr" is a service of the French State; the name is used here solely to describe the origin of the open data displayed by this plugin.

The data is provided by the French government through service-public.fr (DILA) and published under the **Etalab Open Licence v2.0**, which allows reuse, including for commercial purposes, provided the source is credited. The plugin facilitates the display of this public data: it does not resell it, and the "Source: service-public.fr" notice is shown automatically.

= What the free version does =

* **Individuals procedures** — all official sheets: civil status, housing, family, employment, health, and more.
* **Associations procedures** — creation, management, grants, declarations, and more.
* **Built-in search** — full-text search across all downloaded sheets.
* **Local contact details** — display the address, PO box, phone number, spam-protected email and opening hours of your services, per section.
* **Life events** — an entry point per situation (birth, moving home, retirement, and so on).
* **France Services block** — highlight the France Services scheme.
* **Daily updates** — the data is refreshed automatically every day from the official feeds.

= Set up in minutes =

1. Install and activate the plugin.
2. Enter your municipality's name and INSEE code (for local contact details).
3. Download the data from the settings screen.
4. Paste the `[satdem]` shortcode on a page.

= Available shortcodes =

* `[satdem]` — summary of Individuals procedures (default).
* `[satdem categorie="asso"]` — Associations procedures.
* `[satdem fiche="F1905"]` — a single, specific procedure sheet.
* `[satdem_evenements]` — "Life events" widget.
* `[satdem_themes]` — "Main themes" widget.

= Companion plugin (optional) =

An optional companion plugin, distributed separately from WordPress.org on saturne.media, adds additional sections and presentation options. It is not required: this plugin is fully functional on its own, with no locked features.

== Frequently Asked Questions ==

= Where does the data come from? =

From service-public.fr, the official website of the French public administration, through the co-branding feeds published by the DILA. It is updated daily.

= Am I allowed to use this data? =

Yes. The data is published under the Etalab Open Licence v2.0, which explicitly allows reuse, including commercial reuse, provided the source is credited. The "Source: service-public.fr" notice is displayed automatically.

= Does the plugin work with my theme? =

Yes. The display inherits the font and text size from your theme. The plugin has been tested with the most common themes.

= Is the data stored on my server? =

Yes. The sheets are downloaded and stored locally in your WordPress installation, which ensures fast display and continued operation even if the source is temporarily unavailable.

= Does the plugin contact external servers? =

Yes — see the "External services" section below for full details.

== External services ==

This plugin relies on data published by the French public administration. It connects to the following external services:

**1. Service-Public.fr open data feeds (DILA)**

* What it is: the official open data distribution of French administrative procedure sheets, operated by the DILA (Direction de l'information légale et administrative).
* What it is used for: downloading the procedure sheets that the plugin displays on your site.
* Endpoints contacted: `https://lecomarquage.service-public.gouv.fr/` (data archives) and `https://www.service-public.gouv.fr/` (public news RSS feed).
* What data is sent: nothing but the HTTP request itself. No personal data, no site data, no user data is transmitted. The plugin only downloads public files.
* When: once a day, via WP-Cron, and when an administrator manually triggers a download from the plugin settings screen.
* Terms of use (CGU): https://www.service-public.gouv.fr/P10050
* Personal data and security: https://www.service-public.gouv.fr/P10001
* Legal notice: https://www.service-public.gouv.fr/P10025
* Open licence (Etalab v2.0): https://github.com/etalab/licence-ouverte/blob/master/LO.md

The plugin contacts no other external server. It sends no data to Saturne Innovations or to any third party.

== Screenshots ==

1. Summary of Individuals procedures displayed on a municipality's website.
2. Procedure sheet with the local contact details of the town hall.
3. Built-in search across the sheets.
4. The plugin settings screen.

== Data source and legal notice ==

The displayed sheets come from **service-public.fr**, published by the French Directorate of Legal and Administrative Information (DILA). They are distributed through the official co-branding feeds (lecomarquage.service-public.gouv.fr) under the **Etalab Open Licence v2.0**.

This licence allows the reuse of public information, including for commercial purposes, on the condition that the source and the date of last update are credited. Saturne Démarches automatically displays the "Source: service-public.fr" notice on the relevant content.

Saturne Démarches is an independent plugin published by Saturne Innovations. It is not affiliated with, endorsed by, or sponsored by the DILA, service-public.fr, or the French government.

== Changelog ==

= 4.3.0 =
* Output escaping hardened: every echoed value is escaped with core functions (wp_kses/esc_*), no suppression comments.
* Removed all residual references to sections that belong to the separate companion plugin; the free plugin is category-agnostic.
* Shortcodes now use the plugin's own prefix only.

= 4.2.0 =
* All built-in features are now free and fully functional (no locked features).
* Unique `satdem` prefix on all functions, classes, options and hooks to prevent conflicts.
* Admin CSS and JavaScript are now properly enqueued instead of printed inline.
* Configurable page URLs and targeted single-sheet display available to everyone.
* Settings from earlier versions are migrated automatically; the former shortcodes remain accepted as aliases.

= 4.0.0 =
* First public release on WordPress.org.
* Individuals and Associations sections, search, local contact details, life events, France Services block.
* Daily automatic update of the official data.

== Upgrade Notice ==

= 4.3.0 =
Compliance and security hardening. Your existing settings are migrated automatically. If you used the old [sp_demarches] shortcodes, replace them with [satdem].

= 4.2.0 =
Your existing settings are migrated automatically and existing shortcodes keep working.

= 4.0.0 =
First release published on WordPress.org.
