Modèle:Archivage par bot

 Documentation[voir] [modifier] [historique] [purger]

Ce modèle permet l'archivage automatique d'une page de discussion. Les sections dont le contenu n'a pas été modifié depuis plus de n jours sont déplacées vers des sous-pages d'archive par un bot. Actuellement, cette tâche est accomplie par OrlodrimBot (d · c · b) une fois par jour, vers 23 h.

L'inclusion de ce modèle n'a aucun effet visible. Il existe d'autres modèles pour signaler que l'archivage automatique est en place ou afficher des liens vers les pages d'archives (voir #Modèles complémentaires).

ExemplesModifier

L'archivage avec incrémentModifier

Insérez le modèle suivant au début de la page de discussion :

{{Archivage par bot
 | algo = old(15d)
 | archive = /Archive %(counter)d
 | maxarchivesize = 250K
 | counter = 
}}

Effet : si le modèle est placé sur Discussion utilisateur:Exemple, les discussions non modifiées depuis 15 jours seront archivées vers Discussion utilisateur:Exemple/Archive 1. Lorsque cette archive dépassera 250 Ko, le bot passera à Discussion:Exemple/Archive 2, puis Discussion:Exemple/Archive 3, etc. Le bot ne s'activera que s'il y a au moins deux sections à archiver et laissera toujours au moins cinq sections.

S'il existe déjà des pages d'archives numérotées avant la mise en place de l'archivage automatique, le bot détermine automatiquement la valeur du compteur pour que l'archivage commence sur la dernière page.

L'archivage statiqueModifier

{{Archivage par bot
 | algo = old(7d)
 | archive = /Archive
}}

Si le modèle est installé dans la page de discussion de l'utilisateur unexemple, le bot archivera les fils de discussions de Discussion utilisateur:unexemple vers Discussion utilisateur:unexemple/Archive tous les sept jours (à partir de la dernière intervention). À moins de modifier manuellement le paramètre archive, l'archive augmentera indéfiniment.

L'archivage basé sur la dateModifier

{{Archivage par bot
 | algo = old(5d)
 | archive = /Archives/%(year)d/%(monthname)s
}}

Avec ces options, le bot transférera les fils de discussion plus vieux de 5 jours dans l'archive correspondant à la date du dernier message du fil.

Syntaxe complèteModifier

Vous devez inclure le modèle :

  1. dans la page, avant le premier == Deuxième niveau ==
  2. directement dans la page de discussion, il ne doit pas être importé d'un autre modèle.
{{Archivage par bot
 | archive = 
 | algo = 
 | counter = 
 | maxarchivesize = 
 | minthreadsleft = 
 | minthreadstoarchive = 
 | archiveheader = 
}}

ParamètresModifier

paramètre signification
archive Nom de l'archive où les discussions doivent être déplacées. Si le nom commence par /, le bot considère qu'il s'agit du nom d'une sous-page. On peut utiliser des variables afin de créer des noms d'archives dynamiques.
algo Algorithme d'achivage. Trois formats sont acceptés :
  • old(...)... signifie l'âge maximum en jours (d) (5d, 21d, etc.). Dans ce cas les fils de discussion sont archivés sans condition après le délai indiqué.
  • checked+old(...)... signifie l'âge maximum en jours. Seuls les fils de discussion dont le titre contient l'un des modèles {{Fait}}, {{Pas fait}}, {{Oui}}, {{Non}}, {{Croix3}} ou {{Déplacée}} sont archivés après le délai indiqué (ce mécanisme est principalement destiné aux pages de requêtes telles que Projet:Infobox/Demandes).
  • FdN(...)... signifie l'âge maximum en jours. Seuls les fils de discussion contenant {{Réponse FdN|oui}}, {{Réponse FdN|attente}}, {{Réponse FdN|encours}} ou l'un des modèles listés sur Utilisateur:OrlodrimBot/Modèles de réponse sont archivés après le délai indiqué.
  • eraseold(...)... signifie l'âge maximum en jours. Efface sans archiver les messages après le délai indiqué.
  • erasenewsletters(...)... signifie l'âge maximum en jours. Efface sans archiver les messages distribués par MediaWiki message delivery correspondant à une liste de publications périodiques connues.

Les algorithmes peuvent être combinés en les séparant par des virgules, par exemple erasenewsletters(7d),old(7d) efface les newsletters après 7 jours et archive les autres messages.

counter La valeur actuelle du compteur. Si l'option %(counter)d n'est pas utilisée, la valeur est ignorée. Le bot la mettra à jour si nécessaire.
maxarchivesize La grosseur maximum de l'archive avant l'incrément du compteur. Si l'option du compteur n'est pas utilisée, celle-ci est ignorée. Les valeurs utilisées doivent être de la forme #K (K en majuscule). Par exemple : maxarchivesize=250K.
minthreadsleft Le nombre minimum de fils de discussion à laisser dans la page de discussion afin d'éviter le blanchiment. Par défaut, cette valeur est fixée à 5.
minthreadstoarchive Le nombre minimum de fils de discussion à archiver à la fois. Cette option est utilisée pour diminuer la fréquence d'intervention. Le bot n'archivera pas les fils de discussion, si leurs nombres sont inférieurs à la valeur de ce paramètre. Par défaut, la valeur est fixée à 2.
archiveheader Contenu à placer comme entête dans les nouvelles pages d'archive. Par défaut, la valeur est fixée à {{Archive de discussion}}

VariablesModifier

variable... explication
%(counter)d la valeur actuelle du compteur counter
%(year)d année du fil archivé
%(quarter)d trimestre (nombre de 1 à 4) du fil archivé
%(month)d mois (nombre de 1 à 12) du fil archivé
%(monthname)s Nom du mois
%(monthnameshort)s trois premières lettres du mois

Limitations techniquesModifier

  • Le bot archive les sections de niveau 2 (c'est-à-dire de la forme « == Titre == »). Les sections de niveau 1 (« = Titre = ») ne sont jamais archivées. Les sections de niveau 3 (« === Titre === ») situées avant la première section de niveau 2 non plus. Si une boîte déroulante s'étend sur plusieurs sections, elle peut être cassée lors de l'archivage.
  • %(counter)d est incompatible avec les autres paramètres (par exemple, « /%(year)d/%(counter)d » n'est pas une page d'archive valide).
  • L'archivage ne fonctionne que si la page d'archive est une sous-page de la page archivée (si vous avez une bonne raison de vouloir faire autrement, contactez Orlodrim (d · c · b))
  • L'archivage ne fonctionne pas si la page archivée est une sous-page dont le titre contient "Archive". Le but de cette restriction est d'éviter des problèmes si le modèle d'archivage est déplacé par erreur vers la page d'archive.

Modèles complémentairesModifier

Il est possible d'ajouter un bandeau afin d'indiquer l'emplacement des archives.

Si vous utilisez la méthode avec incrément (/Archive 1, /Archive 2, etc.), le bandeau {{Archives auto}} repérera automatiquement ces pages pour les afficher.

Il est également possible d'informer par un bandeau que la page est automatiquement archivée.

Filing cabinet icon.svg Cette page est automatiquement archivée par OrlodrimBot. Les sections n'ayant aucune activité depuis 7 jours sont automatiquement déplacées.

Pour qu'une section ne soit jamais archivée, placez-y le modèle {{Ne pas archiver}}.

Ce modèle peut archiver les sections produites par {{Utilisateur:OrlodrimBot/Suivi catégorie}} (voir la documentation de l'autre modèle pour les détails).