=== HKC Publishing Report ===
Contributors: hkabla
Plugin URI: https://plugins.hervekabla.com/
Tags: statistics, posts, comments, archives, admin
Requires at least: 5.6
Tested up to: 6.6
Requires PHP: 7.2
Stable tag: 1.4.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Une page d'administration qui fait le bilan des publications et des commentaires, année par année et mois par mois.

== Description ==

L'extension ajoute une page « Bilan » dans le menu de l'administration, avec deux onglets.

**Vue d'ensemble** — toute la période d'un seul coup d'œil :

* deux graphiques d'évolution : publications par an, commentaires par an ;
* le tableau de toutes les années : publications, commentaires, évolution d'une année sur l'autre et ratio commentaires/publication ;
* le nombre de publications d'une année est un lien vers l'archive de l'année sur le site, l'année elle-même renvoie vers l'onglet Détail.

**Détail** — une année au choix dans une liste déroulante :

* un tableau unique des douze mois : nombre de publications et nombre de commentaires, chacun suivi de ses évolutions ;
* chaque mois est comparé au **même mois de l'année précédente et de l'année suivante**, avec l'évolution en pourcentage ;
* les nombres de publications sont des liens vers l'archive du mois correspondante ;
* les mois sans données (à venir, ou antérieurs à la première publication) restent vides.

Tout est produit côté serveur en PHP : les filtres sont de simples formulaires GET et les graphiques du SVG généré à la volée. Aucun JavaScript, aucune ressource externe.

**Export CSV**

Chaque onglet dispose d'un bouton « Exporter en CSV » (UTF-8 avec BOM, séparateur `;`, ouverture directe dans Excel).

**Décompte des commentaires**

Deux lectures sont possibles, au choix dans les deux onglets :

* **à la date du billet** : les commentaires rattachés aux billets publiés cette période-là ;
* **à la date du commentaire** : les commentaires déposés cette période-là, quelle que soit la date du billet.

Seuls les billets publiés et les commentaires approuvés (hors pings et rétroliens) sont comptabilisés.

== Installation ==

1. Téléverser `bilan-publications.zip` depuis Extensions › Ajouter › Téléverser une extension.
2. Activer l'extension.
3. Ouvrir le menu « Bilan » dans la colonne de gauche.

L'accès à la page requiert la capacité `edit_posts`.

== Frequently Asked Questions ==

= Peut-on analyser d'autres types de contenu que les articles ? =

Oui, via le filtre `bilan_publications_post_types` :

`add_filter( 'bilan_publications_post_types', function ( $types ) {
	return array( 'post', 'page' );
} );`

== Changelog ==

= 1.4.2 =
* Les mises à jour apparaissent dans l'heure qui suit leur mise en ligne, au lieu d'attendre jusqu'à une demi-journée : le manifeste du site éditeur n'est plus gardé que soixante minutes, la cadence à laquelle WordPress redemande de lui-même.

= 1.4.1 =
* Consultation sur téléphone : les tableaux défilent horizontalement en gardant leurs en-têtes, au lieu d'empiler leurs cellules sans libellé.

= 1.4.0 =
* Renommée en anglais : « HKC Publishing Report » (identifiant hkc-publishing-report). Les réglages et les données sont conservés ; réinstaller l'extension depuis plugins.hervekabla.com.

= 1.3.0 =
* Mises à jour automatiques depuis plugins.hervekabla.com : les nouvelles versions apparaissent dans l'écran des extensions.

= 1.2.0 =
* Les mois hors période (à venir, ou antérieurs à la première publication) restent vides au lieu d'afficher un zéro trompeur.
* Les listes déroulantes se valident au changement, sans passer par le bouton (le bouton reste disponible sans JavaScript).

= 1.1.1 =
* Détail : un tableau unique regroupant, pour chaque mois, le nombre de publications et de commentaires et leurs évolutions.

= 1.1.0 =
* Abandon de la page publique : l'extension se concentre sur l'administration.
* Vue d'ensemble : toute la période, avec l'évolution d'une année sur l'autre.
* Détail : une année comparée à l'année précédente et à l'année suivante, mois par mois.

= 1.0.0 =
* Version initiale.
