=== Liberium Publisher ===
Contributors: liberium
Tags: ads, régie publicitaire, monétisation, widgets, placements
Requires at least: 5.0
Tested up to: 6.5
Stable tag: 1.0.0
License: GPLv2 or later

Affichez des publicités ciblées, créez des zones d'affichage et suivez vos gains Liberium directement depuis WordPress.

== Description ==

Le plugin **Liberium Publisher** permet aux éditeurs de connecter facilement leur site WordPress à la plateforme publicitaire Liberium. Une fois configuré avec votre clé API, vous pouvez créer de nouvelles zones de placement directement depuis votre tableau de bord WordPress et suivre vos rapports de performance.

= Fonctionnalités clés : =
* **Configuration API simple** : Connexion rapide à votre projet Liberium.
* **Gestion des Placements (Zones)** : Créez, listez et gérez vos espaces publicitaires directement depuis WordPress.
* **Widgets & Shortcodes** : Insérez vos bannières et annonces natives facilement dans vos pages ou vos barres latérales.
* **Tableau de bord de Statistiques** : Visualisez les impressions, clics et revenus en temps réel sans quitter WordPress.

== Installation ==

1. Téléchargez le fichier `liberium-publisher-wp.zip`.
2. Allez dans le panneau d'administration WordPress, puis sous **Extensions** > **Ajouter**.
3. Cliquez sur **Téléverser une extension**, sélectionnez le fichier zip et cliquez sur **Installer maintenant**.
4. Activez l'extension.
5. Accédez au menu **Liberium** apparu dans votre tableau de bord pour configurer votre clé API.

== OBTENIR UNE CLÉ API LIBERIUM ==

Pour utiliser ce plugin, vous devez disposer d'un compte sur Liberium.

1. **Inscription / Connexion** :
   Rendez-vous directement sur la page d'inscription de Liberium : [https://adserver.liberium.net/signup](https://adserver.liberium.net/signup).

2. **Accéder à la Sécurité** :
   Une fois connecté, rendez-vous dans la section de gestion de votre projet et cliquez sur l'onglet **Sécurité** (ou directement via la plateforme IAM sur `https://iam.liberium.net`).

3. **Créer une Clé API** :
   * Cliquez sur **Créer une clé API**.
   * Donnez un libellé à votre clé (ex. *Mon site WordPress*).
   * **IMPORTANT (Permissions/Sécurité) :** Cochez ou sélectionnez les permissions suivantes pour que la clé puisse interagir avec l'extension :
     - **Accès Éditeur** (`access_editor` ou `content:edit`) : Requis pour lister, créer des zones (placements) et récupérer les statistiques de revenus.
     - **Accès Annonces** (`access_ads` ou `ads:manage`) : Requis si vous souhaitez également administrer des campagnes et d'autres paramètres liés aux publicités.
   * Validez la création de la clé.

4. **Copier la clé** :
   Copiez la clé générée (elle commence par `sk_...`) et collez-la dans les réglages du plugin dans WordPress.

== FAQ ==

= Est-ce que ce plugin est gratuit ? =
Oui, le plugin WordPress est entièrement gratuit. Cependant, l'affichage de publicités requiert un compte validé sur la régie publicitaire Liberium.

= Les publicités ralentissent-elles mon site ? =
Non. Le script de chargement des publicités est asynchrone (`async`) et se charge en arrière-plan sans bloquer l'affichage de votre contenu.

= Puis-je créer des formats bannières personnalisés ? =
Oui, lors de la création d'une zone (placement), vous pouvez choisir le format **bannière** et définir manuellement sa largeur et sa hauteur.