Extension:AutoSitemap

This page is a translated version of the page Extension:AutoSitemap and the translation is 100% complete.
Manuel des extensions MediaWiki
AutoSitemap
État de la version : stable
Implémentation MyWiki , Action de page
Description Crée et met à jour un fichier Sitemap automatiquement dès qu'une page du site est modifiée.
Auteur(s) Dolfinus, François Boutines-Vignard, Jehy, Thomas
Dernière version 1.8.2 (2024-10-29)
MediaWiki 1.28+
Modifie la base
de données
Non
Licence Licence publique générale GNU v3.0 ou supérieur
Téléchargement
README
Exemple plan du site généré
$wgAutoSitemap

L'extension AutoSitemap crée automatiquement un fichier "sitemap.xml" à chaque création/édition/effacement de page. Le fichier Sitemap aide les moteurs de recherche à observer les pages de votre site. Cette extension est basée sur l'extension ManualSitemap .

Principe

Je n'ai pas la possibilité de mettre à jour mon sitemap à l'aide d'une tâche périodique (comme cron) du fait du serveur hôte, et je ne veux pas le mettre à jour manuellement.

J'ai donc modifié une extension existante pour mettre à jour le plan du site par lui-même suite à tout événement de création, de suppression, de renommage, de téléchargement, de page ...

Remarque

Cette extension peut être utilisée sur de petites instances de MediaWiki (jusqu'à 10 000 pages). Si votre instance comporte plus de 50 000 pages, vous devriez utiliser GenerateSitemap.php à la place car elle prend en charge le fichier d'index du plan du site, peut créer des fichiers séparés pour chaque espace de noms, compresser les fichiers du plan du site et est également conçu pour être exécuté dans le calendrier au lieu d'être déclenché après chaque modification de page.

Installer

  • Télécharger et placez le(s) fichier(s) dans un répertoire appelé AutoSitemap dans votre dossier extensions/.
  • Ajoutez le code suivant à la fin de votre fichier LocalSettings.php  :
    wfLoadExtension( 'AutoSitemap' );
    
  • Faites des modifications à l'une de vos pages wiki, par exemple créez une page ou mettez à jour une page existante
  • Le fichier du plan du site sera généré automatiquement
  •   Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Configurer

Il y a quelques paramètres optionnels qui modifient la génération du plan du site. Vous pouvez les régler dans votre LocalSettings.php.

Nom de fichier

Vous pouvez définir le nom du fichier du plan du site en définissant:

$wgAutoSitemap["filename"] = "sitemap.xml"; //default value

Définir l'URL de base

Par défaut, toutes les URL du plan du site utilisent $wgCanonicalServer (ou $wgServer, s'il n'est pas défini) comme préfixe de domaine. Si vous voulez le définir avec un autre, vous pouvez le changer manuellement en définissant:

$wgAutoSitemap["server"] = "https://your-site.com";

Exclure certains de types de pages du plan du site

Vous pouvez exclure les espaces de noms ou les pages exactes de leur inclusion sur le plan du site:

$wgAutoSitemap["exclude_namespaces"] = [
    NS_TALK,
    NS_USER,   
    NS_USER_TALK,
    NS_PROJECT_TALK,
    NS_FILE_TALK,
    NS_MEDIAWIKI,   
    NS_MEDIAWIKI_TALK,
    NS_TEMPLATE,
    NS_TEMPLATE_TALK,
    NS_HELP,   
    NS_HELP_TALK,
    NS_CATEGORY_TALK
]; //default values

$wgAutoSitemap["exclude_pages"] = ['page title to exclude', 'other one'];

Si vous devez exclure l'espace de noms personnalisé du plan du site, passez ici l'ID de l'espace de noms (un nombre entier) au lieu du nom de la constante.


Définir la féquence de mise à jour de la page

Vous pouvez spécifier manuellement la fréquence recommandée avec laquelle tous les adresses seront vérifiées par le moteur de recherche:

$wgAutoSitemap["freq"] = "daily"; //default

La valeurs permises sont :

hourly
daily
weekly
monthly
yearly
adjust - for automatic determination of frequency based on page edits count

Définir la priorité de la page

Vous pouvez spécifier manuellement la priorité pour certaines pages ou espaces de noms:

$wgAutoSitemap["priority"] = 0.7;

ou

$wgAutoSitemap["priority"][NS_MAIN] = 1;
$wgAutoSitemap["priority"][NS_CATEGORY] = 0.8;

ou bien

$wgAutoSitemap["priority"]['Main page'] = 1;
$wgAutoSitemap["priority"]['Other page'] = 0.8;

Fréquence limitée de recréation du plan du site

Pour les wikis avec de nombreuses pages, la génération du plan du site peut consommer des ressources importantes, vous ne voudrez peut-être pas que cela se produise trop souvent. Avec cette option, vous pouvez spécifier que le plan u site ne doit être recréé que si il date d'au moins un certain nombre de secondes.

$wgAutoSitemap["min_age"] = 3600; // 1 hour, default 0 (no rate-limit)

Utilisation

Page blanche après l'installation de l'extension

Veuillez suivre l'instruction Comment déboguer pour obtenir le message d'exception qui interrompt le processus de rendu de la page. Habituellement, cela est lié au passage d'une constante indéfinie à $wgAutoSitemap["exclude_namespaces"].

Droits

Votre dossier MediaWiki doit posséder les opérations d'écriture (chmod +w avec chown apache ou chown nginx).

Htaccess, Nginx

Si vous souhaitez voir un plan de site lisible par l'homme, autorisez l'accès à la lecture pour le fichier sitemap.xsl dans votre configuration de site (fichier .htaccess ou autre).

Voir aussi