=== Avis des Pros - Collecte d'avis gratuit ===
Contributors: bfcservices
Tags: customer reviews, reputation, business, trust badge, qr code
Requires at least: 5.8
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.1.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Connect Avis des Pros to WordPress, display your reputation, and collect customer reviews for free with badges and QR codes.

== Description ==

Avis des Pros connects a WordPress website to a claimed company profile on Avis des Pros.

The plugin helps French companies collect reviews for free and turn their reputation into visible trust signals. It can support local visibility, reassure prospects and direct visitors to the company's review form.

It provides:

* an official reputation badge with a direct review link;
* a trust card displaying the reliability score and recommendations;
* a branded QR code opening the company's review form;
* a tracked review collection URL for text, buttons and email campaigns;
* Gutenberg blocks, classic widgets and shortcodes;
* local style settings for text and link sizes and colours;
* attributed traffic counters in the Avis des Pros dashboard.

Public pages use a secure local WordPress cache. Visitors never trigger API requests, so the plugin does not add a remote request to page rendering.

The current plugin interface is available in French only. The service is currently intended for companies registered in France.

== Installation ==

1. Install and activate the plugin.
2. Click `Configure` below the plugin name or open `Settings > Avis des Pros`.
3. Review the technical requirements shown on the setup screen.
4. If required, create a free Avis des Pros account and find the company profile.
5. Claim the company profile from its public page.
6. Open the WordPress section of the Avis des Pros company dashboard.
7. Register the exact HTTPS WordPress URL and generate a pairing code.
8. Enter the code in WordPress and add a block, widget or shortcode.

The pairing code expires after one hour and can only be used once. The encrypted pairing remains available after WordPress and plugin updates.

== Usage ==

The `Avis des Pros` Gutenberg block works with modern themes, including themes without widget areas.

Available shortcodes:

* `[avis_des_pros type="badge"]`
* `[avis_des_pros type="card"]`
* `[avis_des_pros type="qr"]`

The optional `title` attribute changes the block title.

The settings page also provides the tracked review collection URL with a copy button.

Direct-distribution builds can display a manual download notice when a new version is available. WordPress.org builds use the standard WordPress.org update system instead.

== Cache and availability ==

* Standard local cache lifetime: 12 hours.
* Automatic synchronisation: twice daily through WP-Cron.
* Manual synchronisation from the settings page.
* Last valid profile retained for up to seven days during a temporary service outage.

== Security and privacy ==

The plugin requires HTTPS and OpenSSL with AES-256-GCM support.

The installation token is encrypted in the WordPress database and is never included in public HTML. API requests use TLS verification, are bound to the registered site URL and WordPress instance, and reject remote redirects.

Only required technical information is sent: site URL, WordPress version, PHP version, plugin version, locale, multisite status, synchronisation events and attributed visits. The plugin does not collect WordPress content, passwords or personal visitor data.

== External service ==

This plugin connects to the Avis des Pros API during pairing, automatic or manual synchronisation, and disconnection. This service is required to associate the company profile and retrieve the score, counters, links and version information stored in the local WordPress cache.

The plugin sends the site URL, a technical installation identifier, WordPress, PHP and plugin versions, locale and multisite status. When a visitor voluntarily clicks a badge, card or QR code, the destination URL includes the public installation identifier and placement type to measure attributed traffic.

Service provided by Avis des Pros: https://www.avis-des-pros.com/

Privacy policy: https://www.avis-des-pros.com/legal/privacy

Terms of service: https://www.avis-des-pros.com/legal/cgu

== Frequently Asked Questions ==

= Is an Avis des Pros account required? =

Yes. A free account and a claimed French company profile are required to pair the WordPress site securely.

= Does the plugin call the API on every visit? =

No. Public visitors only read data stored in the local WordPress cache.

= Can I use it without a widget area? =

Yes. Use the Avis des Pros Gutenberg block or a shortcode in any page or post.

= Are public links crawlable? =

Yes. Public links are standard links, open in a new tab and do not include a `nofollow` attribute.

= Does it support companies outside France? =

Not currently. The plugin and the Avis des Pros company database are currently designed for companies registered in France.

== Changelog ==

= 1.1.2 =
* Adopted a unique plugin-wide prefix for WordPress hooks, stored data, classes and assets.
* Preserved existing connections and display settings through an automatic data migration.

= 1.1.1 =
* Added onboarding links for account creation, company search and profile claiming.
* Improved the pairing tutorial displayed after installation.
* Added a dedicated WordPress.org build using the native update channel.
* Updated the public readme and external-service disclosure for WordPress.org.

= 1.1.0 =
* Added a review collection link below the badge and in plugin settings.
* Added text and link size and colour settings.
* Added the Avis des Pros account plan to the API profile for future Standard and Pro features.
* Added new-version detection for direct-distribution builds.
