<?php
/**
 * Plugin : AIFORYA Multi Author (aiforya-multi-author).
 *
 * Notification par courriel au changement de statut editorial.
 *
 * ⛔ POURQUOI CE FICHIER EXISTE — grief de la revue wordpress.org du 21/08/2026 :
 *
 *   « tabs/class-tab-settings.php:77 — The notification feature is only saved as a setting;
 *     no code sends email when workflow statuses change. »
 *   « tabs/class-tab-settings.php:82 — No email notification logic exists; the interface
 *     falsely states that status changes send emails to authors. »
 *
 * Le relecteur avait raison, et la mesure est pire que son constat : `notifications_enabled`
 * etait a `true` PAR DEFAUT (activator l. 77, db l. 41). L'utilisateur croyait donc que ses
 * auteurs etaient prevenus, sans qu'aucun `wp_mail` n'existe dans l'extension.
 *
 * ⭐ ET LA PRISE ETAIT DEJA LA, IGNOREE : `change_article_status()` emet depuis toujours
 * `do_action( 'aiforya_ma_status_changed', $post_id, $new_status, $assignment )`. Personne
 * ne l'ecoutait. C'est le motif deja rencontre deux fois — une capacite presente cote
 * donnees et le seul chemin qui l'emploie qui l'ignore.
 *
 * @package aiforya-multi-author
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

/**
 * Ecoute le changement de statut et previent les personnes concernees.
 */
class Aiforya_Multi_Author_Notifier {

	/**
	 * @var Aiforya_Multi_Author_Notifier|null
	 */
	private static $instance = null;

	public static function get_instance(): Aiforya_Multi_Author_Notifier {
		if ( null === self::$instance ) {
			self::$instance = new self();
		}
		return self::$instance;
	}

	public function register_hooks(): void {
		add_action( 'aiforya_ma_status_changed', array( $this, 'on_status_changed' ), 10, 3 );
	}

	/**
	 * Previent l'auteur assigne ET les co-auteurs declares.
	 *
	 * ⚠ « les personnes qui SUIVENT l'article », c'est ce que promet l'infobulle de l'onglet
	 * Reglages : l'auteur assigne seul ne suffirait pas a la tenir.
	 *
	 * @param int    $post_id    Article concerne.
	 * @param string $new_status Nouveau statut du flux editorial.
	 * @param object $assignment Ligne d'assignation AVANT le changement.
	 */
	public function on_status_changed( $post_id = 0, $new_status = '', $assignment = null ): void {
		$post_id = (int) $post_id;
		if ( $post_id <= 0 || '' === (string) $new_status ) {
			return;
		}

		$db = Aiforya_Multi_Author_Db::get_instance();

		$settings = $db->get_settings();
		if ( empty( $settings['notifications_enabled'] ) ) {
			return;
		}

		$post = get_post( $post_id );
		if ( ! $post ) {
			return;
		}

		/* Les destinataires : l'auteur assigne, puis les co-auteurs. On DEDOUBLONNE par
		 * identifiant avant de resoudre les adresses — un co-auteur peut etre l'assigne. */
		$user_ids = array();
		if ( is_object( $assignment ) && ! empty( $assignment->user_id ) ) {
			$user_ids[] = (int) $assignment->user_id;
		}
		foreach ( $db->get_coauthors_for_post( $post_id ) as $coauthor ) {
			if ( ! empty( $coauthor->user_id ) ) {
				$user_ids[] = (int) $coauthor->user_id;
			}
		}
		$user_ids = array_values( array_unique( array_filter( $user_ids ) ) );
		if ( empty( $user_ids ) ) {
			return;
		}

		$workflow = Aiforya_Multi_Author_Workflow::get_instance();
		$labels   = $workflow->get_status_labels();
		$label    = isset( $labels[ $new_status ] ) ? $labels[ $new_status ] : $new_status;

		$titre = get_the_title( $post_id );
		$lien  = get_edit_post_link( $post_id, 'raw' );

		/* translators: %s: post title. */
		$sujet = sprintf( __( 'Status updated: %s', 'aiforya-multi-author' ), $titre );

		foreach ( $user_ids as $user_id ) {
			$user = get_userdata( $user_id );
			if ( ! $user || empty( $user->user_email ) ) {
				continue;
			}

			$lignes = array(
				/* translators: %s: recipient display name. */
				sprintf( __( 'Hello %s,', 'aiforya-multi-author' ), $user->display_name ),
				'',
				/* translators: 1: post title, 2: new editorial status. */
				sprintf( __( 'The post "%1$s" has moved to the status "%2$s".', 'aiforya-multi-author' ), $titre, $label ),
			);
			if ( $lien ) {
				$lignes[] = '';
				$lignes[] = __( 'Open it here:', 'aiforya-multi-author' ) . ' ' . $lien;
			}
			$lignes[] = '';
			$lignes[] = __( 'You are receiving this because you are an author or co-author of this post.', 'aiforya-multi-author' );

			/* ⚠ `wp_mail` rend false sans lever : on n'en fait PAS un echec silencieux du
			 * changement de statut, qui lui a bien eu lieu. Le statut prime, la notification
			 * est un a-cote — l'inverse ferait qu'un serveur SMTP en panne bloque la redaction. */
			wp_mail( $user->user_email, $sujet, implode( "\n", $lignes ) );
		}
	}
}