carhop__dynamiques-theme__PROD-DEV/includes/utilities.php

<?php

/**
 * Récupère tous les auteurs uniques d'une revue
 * 
 * Cette fonction collecte tous les auteurs des articles liés à une revue spécifique.
 * Elle parcourt tous les articles publiés qui ont une relation avec la revue
 * et retourne un tableau d'IDs d'auteurs uniques.
 * 
 * @param int $revueID L'ID de la revue pour laquelle récupérer les auteurs
 * @return array Tableau d'IDs d'auteurs uniques
 */
function getRevueAuthors($revueID)
{
	$revueRelatedArticles = new WP_Query(array(
		'post_type' => 'articles',
		'posts_per_page' => -1,
		'post_status' => 'publish',
		'meta_query' => array(
			array(
				'key' => 'related_revue',
				'value' => $revueID,
				'compare' => '=',
			),
		),
	));
	$authors = array();

	foreach ($revueRelatedArticles->posts as $article) {
		$currentArticleAuthors = get_field('authors', $article->ID);

		if (empty($currentArticleAuthors) || !is_array($currentArticleAuthors)) continue;

		foreach ($currentArticleAuthors as $authorID) {
			$authors[] = $authorID;
		}
	}
	return array_unique($authors);
}

/**
 * Récupère tous les termes uniques d'une taxonomie pour une revue
 * 
 * Cette fonction collecte tous les termes d'une taxonomie spécifique
 * associés aux articles d'une revue. Elle parcourt tous les articles
 * liés à la revue et retourne les termes uniques de la taxonomie donnée.
 * 
 * @param int $revueID L'ID de la revue
 * @param string $taxonomy Le nom de la taxonomie (ex: 'etiquettes', 'category')
 * @return array Tableau d'objets de termes uniques
 */
function get_revue_terms($revueID, $taxonomy)
{
	$revueRelatedArticles = new WP_Query(array(
		'post_type' => 'articles',
		'posts_per_page' => -1,
		'post_status' => 'publish',
		'meta_query' => array(
			array(
				'key' => 'related_revue',
				'value' => $revueID,
				'compare' => '=',
			),
		),
	));
	$terms = array();

	foreach ($revueRelatedArticles->posts as $article) {
		$currentArticleTerms = get_the_terms($article->ID, $taxonomy);

		if (empty($currentArticleTerms) || !is_array($currentArticleTerms)) continue;

		foreach ($currentArticleTerms as $term) {
			$terms[] = $term->term_id;
		}
	}

	foreach (array_unique($terms) as $term) {
		$termObject = get_term($term, $taxonomy);
		$uniquesTermsArray[] = $termObject;
	}

	return $uniquesTermsArray;
}


function count_user_articles($userID, $postType)
{
	$args = array(
		'post_type' => $postType,
		'meta_query' => array(
			array(
				'key' => 'authors',
				'value' => '"' . $userID . '"',
				'compare' => 'LIKE',
			),
		),
	);
	$query = new WP_Query($args);
	return $query->found_posts;
}


/**
 * Génère un sommaire automatique à partir du contenu d'un post
 * 
 * Cette fonction analyse les blocs Gutenberg d'un post pour extraire
 * tous les titres de niveau 2 (h2) et créer un index de navigation.
 * Elle génère des ancres automatiques pour chaque titre.
 * 
 * @param int $postID L'ID du post à analyser
 * @return array Tableau associatif contenant les éléments du sommaire
 *               Chaque élément contient: title, anchor, level
 */
function build_sommaire_from_content($postID)
{
	$blocks = parse_blocks(get_the_content($postID));
	$titleBlocks = array_filter(
		$blocks,
		function ($block) {
			// Vérifier si c'est un bloc heading
			if ($block['blockName'] !== 'core/heading') {
				return false;
			}

			// Extraire le niveau depuis le HTML si les attributs sont vides
			if (empty($block['attrs']['level'])) {
				// Chercher seulement h2 dans le HTML
				if (preg_match('/<h2[^>]*>/i', $block['innerHTML'], $matches)) {
					return true;
				}
				return false;
			}

			// Utiliser le niveau des attributs s'il existe
			return $block['attrs']['level'] === 2;
		}
	);

	$outputIndex = [];

	foreach ($titleBlocks as $block) {
		$title = strip_tags($block['innerHTML']);

		// Extraire le niveau depuis le HTML ou les attributs
		$level = $block['attrs']['level'] ?? null;
		if (!$level && preg_match('/<h2[^>]*>/i', $block['innerHTML'], $matches)) {
			$level = 2;
		}

		if ($level !== 2) continue;

		$anchor = $block['attrs']['idName'] ?? sanitize_title($title);

		// Ajouter un préfixe si l'ancre commence par un chiffre
		if (!empty($anchor) && preg_match('/^[0-9]/', $anchor)) {
			$anchor = 'anchor-' . $anchor;
		}


		$outputIndex[] = [
			'title' => $title,
			'anchor' => $anchor,
			'level' => $level,
		];
	}

	return $outputIndex;
}


/**
 * Construit un index des notes de bas de page à partir du contenu HTML
 * 
 * Cette fonction analyse le contenu HTML pour détecter les liens de notes
 * de bas de page (avec classe 'footnote-reference') et extrait leur contenu
 * pour créer un index numéroté des notes.
 * 
 * @param string $content Le contenu HTML à analyser
 * @return array Tableau des notes de bas de page avec clé, ancre et contenu
 */
function build_footnotes_index_from_content($content)
{
	if (empty($content)) {
		return [];
	}

	$footnotes = [];
	// Trouve les balises <a> avec classe footnote-reference ET attribut footnote-content (ordre flexible)
	$pattern = '/<a[^>]*class="[^"]*footnote-reference[^"]*"[^>]*footnote-content="([^"]*)"[^>]*>|<a[^>]*footnote-content="([^"]*)"[^>]*class="[^"]*footnote-reference[^"]*"[^>]*>/i';
	$has_footnotes = preg_match_all($pattern, $content, $matches, PREG_SET_ORDER);

	if ($has_footnotes) {
		foreach ($matches as $index => $match) {

			// Le contenu peut être dans match[1] ou match[2] selon l'ordre des attributs
			$footnote_content = !empty($match[1]) ? $match[1] : $match[2];
			if (!empty($footnote_content)) {
				$footnotes[] = array(
					'key' => $index + 1,
					'anchorID' => $index + 1,
					'content' => $footnote_content
				);
			}
		}
	}

	return $footnotes;
}


/**
 * Ajoute des identifiants uniques aux liens de notes de bas de page dans le contenu
 * 
 * Cette fonction parcourt le contenu HTML et ajoute un attribut id unique
 * à chaque lien ayant la classe "footnote-reference". Cela permet de créer
 * des ancres de navigation pour les notes de bas de page.
 * 
 * @param string $content Le contenu HTML à traiter
 * @return string Le contenu modifié avec les IDs ajoutés aux notes de bas de page
 */
function apply_footnotes_urls_to_content($content)
{
	$post_type = get_post_type();
	if ($post_type !== 'articles' && !is_admin()) return $content;

	// Compter les références de notes de bas de page
	$footnote_count = 0;

	// Utiliser preg_replace_callback pour traiter chaque occurrence individuellement
	$content = preg_replace_callback(
		'/<a([^>]*class="[^"]*footnote-reference[^"]*"[^>]*)>/i',
		function ($matches) use (&$footnote_count) {
			$footnote_count++;
			return '<a id="footnote-' . $footnote_count . '" ' . $matches[1] . '>';
		},
		$content
	);

	return $content;
}
add_filter('the_content', 'apply_footnotes_urls_to_content', 10);