Manuel:$wgRCFeeds

From mediawiki.org
This page is a translated version of the page Manual:$wgRCFeeds and the translation is 100% complete.
Dernières modifications, nouvelles pages, liste de suivi et historique: $wgRCFeeds
Configuration pour l'envoi de mises à jour des changements récents.
Introduit dans la version :1.22.0 (Gerrit change 52922; git #2961884b)
Retiré dans la version :Encore utilisé
Valeurs autorisées :Non renseigné
Valeur par défaut :[]

Détails

Cette variable est pour configurer où MediaWiki va envoyer des mises à jour réseau pour les changements récents. Ceci est appelé après que les informations de changements récents aient été insérés dans le tableau recentchanges .

Définir un flux nécessite l'extension PHP sockets. Si l'extension n'est pas activée, des actions comme des modifications, des déplacements, etc peuvent marcher, mais l'action peut ne pas être enregistrée dans les changements récents du tout (tâche T185428).

Utilisation

MédiaWiki supporte l'envoi de mises à jour des changements récents à n'importe quel nombre de destinataires. Cette variable est donc un tableau, avec chaque entrée étant un descripteur de où et quand envoyer les données.

Chaque descripteur est un tableau associé avec les clés suivantes:

formatter
Le nom de classe pleinement qualifié pour la classe qui va formater les données à envoyer sur le réseau. Il doit hériter l'interface RCFeedFormatter.
uri
URI pour envoyer les données vers (le protocole indique quel moteur est utilisé pour envoyer les données).
omit_bots
Vrai ou faux pour ignorer les modifications de bots
omit_anon
Vrai ou faux pour ignorer les modifications anonymes
omit_user
Vrai ou faux pour ignorer les utilisateurs enregistrés
omit_minor
Vrai ou faux pour ignorer les modifications mineures
omit_patrolled
Vrai ou faux pour ignorer les modifications patrouillées

Comme mentionné, la clé formatter spécifie quelle classe sera utilisée pour formater les données, et le protocole de l'URI spécifie comment actuellement envoyer les données.

Les formateurs

Un formateur doit être spécifié pour que les données soit bien transmises avant d'aller sur le réseau. MédiaWiki a les classes de formateur intégrées suivantes:

JSONRCFeedFormatter
Sort l'information RC dans un dictionnaire JSON
XMLRCFeedFormatter
Sort l'information RC sous in format XML
IRCColourfulRCFeedFormatter
Sort une ligne IRC avec des codes de couleur pour une diffusion à un serveur IRC
Paramètres personnalisés:
add_interwiki_prefix
Vrai ou faux pour ajouter le préfix interwiki aux données ($wgLocalInterwikis ). Ne fonctionne que avec le formateur IRCColourfulRCFeedFormatter.

Moteurs

Les moteurs sont les méthodes par lesquelles les notifications de changements récents sont envoyées. MédiaWiki a les moteurs intégrées suivantes:

UDPRCFeedEngine
Envoie via un paquet UDP
RedisPubSubFeedEngine
Envoie via Redis Pub/Sub

Voir $wgRCEngines pour comment configurer le mappage des protocoles aux moteurs.

Exemple

Voici quelques exemples de configurations :

$wgRCFeeds['example'] = [
	'class' => UDPRCFeedEngine::class,
	'uri' => 'udp://localhost:1336',
	'formatter' => JSONRCFeedFormatter::class,
	'omit_bots' => true,
];

$wgRCFeeds['example'] = [
	'class' => ExampleRCFeed::class,
];

Voir aussi