=== Trouverunemesse ===
Contributors: trouverunemesse
Tags: catholic, mass, schedule, church, parish
Requires at least: 5.6
Tested up to: 7.0
Stable tag: 1.0.0
Requires PHP: 7.2
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Display your trouverunemesse.fr community Mass schedule on your WordPress site.

== Description ==

Trouverunemesse allows French-speaking Catholic parishes and communities to display their Mass schedule directly on their WordPress site.

Features:

* Gutenberg block and `[trouverunemesse]` shortcode to embed the schedule
* Schedule rendered server-side: Sunday Masses and weekday Masses are part of your page HTML, indexable by search engines (better SEO for your parish site)
* Same layout as trouverunemesse.fr: "Messes du dimanche" and "Messes en semaine" sections, with a "show more" disclosure for the full schedule
* Schedule cached for 6 hours, with an automatic fallback copy if the service is temporarily unreachable
* Customizable colors (primary, title, secondary)
* Compatible with WordPress 5.6 and above

**Note:** This plugin targets French Catholic parishes. The frontend interface is in French only.

= External service =

This plugin connects to the **trouverunemesse.fr** service to retrieve Mass schedules for your community.

* Data is fetched server-side from `https://trouverunemesse.fr/api/v1/` (schedules, community search, and the list of churches used to determine your town)
* No personal data from visitors is sent to the service

= Optional footer link =

The plugin can display a small "support" link at the bottom of the widget, pointing to the Mass schedules of your town on trouverunemesse.fr. **This link is disabled by default** and is only shown if you explicitly enable the "Soutenir trouverunemesse" option in the plugin settings.

Links:

* [trouverunemesse.fr website](https://trouverunemesse.fr)
* [Terms of service](https://trouverunemesse.fr/cgu)
* [Privacy policy](https://trouverunemesse.fr/politique-de-confidentialite)

== Installation ==

1. Upload the `trouverunemesse` folder to `/wp-content/plugins/`
2. Activate the plugin through the "Plugins" menu in WordPress
3. Go to "Settings > Trouverunemesse" to select your community
4. Add the "Trouverunemesse" block to your pages or use the `[trouverunemesse]` shortcode
5. Requires PHP 7.2 or later and WordPress 5.6 or later

== Frequently Asked Questions ==

= How do I find my community? =

In the plugin settings (Settings > Trouverunemesse), type at least 2 characters of your community name. The plugin will automatically search for matching communities on trouverunemesse.fr.

= Does the plugin work with older versions of WordPress? =

The plugin is compatible with WordPress 5.6 and above. If you use the classic editor instead of Gutenberg, the `[trouverunemesse]` shortcode is available instead of the block.

= Can I customize the colors? =

Yes, in the "Design" tab of the plugin settings, you can customize the primary color, title color, and secondary color.

= How fresh is the displayed schedule? =

The schedule is fetched from trouverunemesse.fr and cached for 6 hours. If the service is temporarily unreachable, the last known schedule is displayed instead.

== Development ==

The plugin ships its complete sources: the readable TypeScript/JavaScript sources live in the `src/` directory and the bundled assets in `build/`. To rebuild the assets from source:

1. `npm install`
2. `npm run build` (uses @wordpress/scripts and the bundled `webpack.config.js`)

== Changelog ==

= 1.0.0 =
* Initial release
