Extension:AutoSitemap

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	Télécharger un instantané de la branche master GitHub: page du projet URL du dépôt git [aide ] historique des validations Note : Aucune mise à jour de localisation n'est fournie par translatewiki.net . README
Exemple	plan du site généré
Paramètres $wgAutoSitemap
Accroches utilisées AfterImportPage PageDeleteComplete ArticleUndelete PageMoveComplete ArticleMergeComplete UploadComplete RevisionUndeleted RevisionRecordInserted PageSaveComplete

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

• w:Sitemaps - Wikipedia à propos des plan de site
• Google sur les plans de sites