View source for User:AccountManager/Optimisation SEO et corrections MediaWiki

= Rapport technique - Optimisation SEO et corrections MediaWiki =

'''Date''' : 5 janvier 2026<br>
'''Version MediaWiki''' : 1.43.0<br>
'''Environnement''' : /xxxx/xxxxxxxx/public_html/mw19/

----

== 1. Objectifs ==

=== 1.1 Objectif principal ===
Empêcher l'indexation par les moteurs de recherche (Google, Bing, etc.) des pages traduites automatiquement, tout en permettant aux robots de suivre les liens présents sur ces pages.

=== 1.2 Objectifs secondaires ===
* Corriger les erreurs et avertissements PHP affichés sur les pages traduites
* Améliorer la robustesse des extensions installées
* Assurer la compatibilité avec MediaWiki 1.43
* Mettre à jour le code déprécié de l'extension Analytics

=== 1.3 Justification ===
Les traductions automatiques, bien qu'utiles pour les utilisateurs, peuvent nuire au référencement du site si elles sont indexées. La directive <code>noindex,follow</code> permet de :
* Exclure ces pages des résultats de recherche
* Maintenir la transmission du "link juice" SEO via les liens
* Conserver une navigation fluide pour les robots d'indexation

----

== 2. Modifications effectuées ==

=== 2.1 LocalSettings.php ===

==== 2.1.1 Configuration HTMLPurifier ====
'''Emplacement''' : Avant le chargement de l'extension HTMLPurifier<br>
'''Problème identifié''' : Variable <code>$wgHTMLPurifierConfig</code> non définie, causant une erreur <code>foreach()</code> sur <code>null</code>

'''Code ajouté''' :
<syntaxhighlight lang="php">
# Configuration pour HTMLPurifier
$wgHTMLPurifierConfig = [];

# Charger l'extension HTMLPurifier
wfLoadExtension( 'HTMLPurifier' );
</syntaxhighlight>

'''Résultat''' : Élimination de l'erreur <code>foreach() argument must be of type array|object, null given</code>

----

==== 2.1.2 Hook pour noindex sur traductions automatiques ====
'''Emplacement''' : Dans la section des hooks personnalisés<br>
'''Hook utilisé''' : <code>BeforePageDisplay</code>

'''Code implémenté''' :
<syntaxhighlight lang="php">
# Hook no index & no follow pour traductions automatiques
$wgHooks['BeforePageDisplay'][] = function ( $out, $skin ) {
    $title = $out->getTitle();
    
    if ( $title && $title->exists() ) {
        $categories = $title->getParentCategories();
        
        if ( is_array( $categories ) ) {
            foreach ( $categories as $category => $sortKey ) {
                // Extraire le nom de la catégorie
                $catName = str_replace( 'Category:', '', $category );
                
                if ( $catName === 'Automatic_translations' || $catName === 'Automatic translations' ) {
                    $out->setRobotPolicy( 'noindex,follow' );
                    break;
                }
            }
        }
    }
    
    return true;
};
</syntaxhighlight>

'''Fonctionnement''' :
# Intercepte chaque page avant l'affichage
# Vérifie si la page appartient à la catégorie "Automatic_translations"
# Applique la politique robots <code>noindex,follow</code> si c'est le cas
# Gère les deux variantes du nom de catégorie (avec espace ou underscore)

'''Résultat''' : Ajout automatique du meta tag <code><meta name="robots" content="noindex,follow"></code> dans le <code><head></code> de toutes les pages traduites automatiquement

----

=== 2.2 HTMLPurifierHooks.php (optionnel) ===

'''Fichier''' : <code>/xxxx/xxxxxxxx/public_html/mw19/extensions/HTMLPurifier/HTMLPurifierHooks.php</code><br>
'''Lignes modifiées''' : 19-22

'''Code original''' :
<syntaxhighlight lang="php">
$config = HTMLPurifier_Config::createDefault();
foreach ( $wgHTMLPurifierConfig as $key => $value ) {
    $config->set( $key, $value );
}
</syntaxhighlight>

'''Code corrigé''' (recommandé) :
<syntaxhighlight lang="php">
$config = HTMLPurifier_Config::createDefault();
if ( isset( $wgHTMLPurifierConfig ) && is_array( $wgHTMLPurifierConfig ) ) {
    foreach ( $wgHTMLPurifierConfig as $key => $value ) {
        $config->set( $key, $value );
    }
}
</syntaxhighlight>

'''Justification''' : Ajout de vérifications pour éviter les erreurs si la variable globale n'est pas définie

----

=== 2.3 Analytics.php ===

'''Fichier''' : <code>/xxxx/xxxxxxxx/public_html/mw19/extensions/Analytics/includes/Analytics.php</code><br>
'''Ligne modifiée''' : 64<br>
'''Problème identifié''' : Utilisation de la méthode dépréciée <code>getConnectionRef()</code> (statut "deprecated" depuis MediaWiki 1.39)

'''Code original''' :
<syntaxhighlight lang="php">
$dbr = $lb->getConnectionRef( DB_REPLICA );
</syntaxhighlight>

'''Code corrigé''' :
<syntaxhighlight lang="php">
$dbr = $lb->getConnection( DB_REPLICA );
</syntaxhighlight>

'''Justification''' : 
* <code>getConnectionRef()</code> est déprécié depuis MediaWiki 1.39
* <code>getConnection()</code> est la méthode recommandée pour MediaWiki 1.43
* Cette modification élimine l'avertissement : <code>Use of Wikimedia\Rdbms\LoadBalancer::getConnectionRef was deprecated</code>

'''Impact''' : Élimination complète de l'avertissement PHP affiché sur toutes les pages du wiki

----

== 3. Résultats et validation ==

=== 3.1 Tests effectués ===
* ✅ Accès à une page traduite automatiquement
* ✅ Vérification du code source HTML
* ✅ Confirmation de la présence du meta tag robots
* ✅ Vérification de l'absence d'erreurs PHP

=== 3.2 Résultat observé ===
Dans le <code><head></code> des pages de la catégorie "Automatic_translations" :
<syntaxhighlight lang="html">
<meta name="robots" content="noindex,follow,max-image-preview:standard">
</syntaxhighlight>

'''Composition du meta tag''' :
* <code>noindex</code> : ajouté par notre hook (empêche l'indexation)
* <code>follow</code> : ajouté par notre hook (autorise le suivi des liens)
* <code>max-image-preview:standard</code> : ajouté par MediaWiki par défaut

=== 3.3 Impact SEO ===
* Les pages traduites automatiquement n'apparaîtront plus dans les résultats de recherche
* Les liens présents sur ces pages continuent de transmettre leur valeur SEO
* Les pages originales (non traduites) conservent leur indexation normale

=== 3.4 Corrections des erreurs ===
* ✅ Erreur HTMLPurifier : <code>foreach() argument must be of type array|object, null given</code> - '''CORRIGÉE'''
* ✅ Avertissement Analytics : <code>Use of getConnectionRef was deprecated</code> - '''CORRIGÉ'''
* ✅ Erreur fatale LocalSettings.php : <code>Cannot use temporary expression in write context</code> - '''CORRIGÉE'''

----

== 4. Récapitulatif des fichiers modifiés ==

{| class="wikitable"
! Fichier !! Type de modification !! Statut !! Critique
|-
| LocalSettings.php || Ajout de configuration et hook || ✅ Implémenté ||✅ Oui
|-
| HTMLPurifierHooks.php || Correction défensive || ✅ Implémenté || ⚠️ Recommandé
|-
| Analytics.php || Mise à jour API dépréciée || ✅ Implémenté || ✅ Oui
|}

----

== 5. Recommandations ==

=== 5.1 Surveillance ===
* Vérifier périodiquement que les nouvelles pages traduites reçoivent bien le meta tag <code>noindex</code>
* Surveiller Google Search Console pour confirmer la désindexation progressive des pages traduites
* Vérifier l'absence d'erreurs PHP dans les logs après chaque mise à jour de MediaWiki

=== 5.2 Extensions ===
* Maintenir l'extension '''HTMLPurifier''' à jour pour éviter les problèmes de compatibilité
* Surveiller les futures mises à jour de l'extension '''Analytics'''
* Documenter toute modification manuelle des extensions pour faciliter les futures mises à jour

=== 5.3 Documentation ===
* Documenter que toute page ajoutée à la catégorie "Automatic_translations" sera automatiquement exclue de l'indexation
* Former les contributeurs à l'utilisation correcte de cette catégorie
* Conserver ce rapport technique comme référence pour les futures interventions

=== 5.4 Bonnes pratiques ===
* Toujours tester les modifications dans un environnement de développement si possible
* Sauvegarder les fichiers avant modification
* Documenter chaque intervention dans le carnet technique

----

== 6. Conclusion ==

L'objectif principal a été atteint avec succès. Les pages traduites automatiquement sont désormais protégées de l'indexation par les moteurs de recherche tout en maintenant une structure de liens saine pour le SEO. 

'''Améliorations apportées''' :
* ✅ Implémentation du système noindex pour les traductions automatiques
* ✅ Correction de l'erreur HTMLPurifier
* ✅ Mise à jour du code déprécié dans Analytics
* ✅ Élimination de toutes les erreurs et avertissements PHP

'''Statut final''' : ✅ '''Implémentation réussie et fonctionnelle'''

Toutes les pages traduites automatiquement sont maintenant correctement marquées avec <code>noindex,follow</code>, et le Semantic MediaWiki ne génère plus d'erreurs ou d'avertissements PHP visibles.

----

[[Category:Technical documentation]]
[[Category:MediaWiki maintenance]]