Kims le 10 juin 2026 à 20:43

2026-06-10T20:43:24Z

← Version précédente		Version du 10 juin 2026 à 22:43
Ligne 16 :		Ligne 16 :

	'''Public Announcement System''' (PAS) diffuse les modifications récentes du wiki vers un canal '''Discord''' sous forme d'annonces publiques : éditions, créations de pages, suppressions, renommages, téléversements, protections, blocages, créations de compte, etc.		'''Public Announcement System''' (PAS) diffuse les modifications récentes du wiki vers un canal '''Discord''' sous forme d'annonces publiques : éditions, créations de pages, suppressions, renommages, téléversements, protections, blocages, créations de compte, etc.
	f
	L'extension est conçue pour la performance et la fiabilité :		L'extension est conçue pour la performance et la fiabilité :
	* '''Zéro impact sur l'enregistrement des pages''' — aucun appel réseau dans le hook ; l'envoi est différé (POSTSEND) ou mis en file (JobQueue).		* '''Zéro impact sur l'enregistrement des pages''' — aucun appel réseau dans le hook ; l'envoi est différé (POSTSEND) ou mis en file (JobQueue).

Kims le 10 juin 2026 à 20:43

2026-06-10T20:43:10Z

← Version précédente		Version du 10 juin 2026 à 22:43
Ligne 16 :		Ligne 16 :

	'''Public Announcement System''' (PAS) diffuse les modifications récentes du wiki vers un canal '''Discord''' sous forme d'annonces publiques : éditions, créations de pages, suppressions, renommages, téléversements, protections, blocages, créations de compte, etc.		'''Public Announcement System''' (PAS) diffuse les modifications récentes du wiki vers un canal '''Discord''' sous forme d'annonces publiques : éditions, créations de pages, suppressions, renommages, téléversements, protections, blocages, créations de compte, etc.
			f
	L'extension est conçue pour la performance et la fiabilité :		L'extension est conçue pour la performance et la fiabilité :
	* '''Zéro impact sur l'enregistrement des pages''' — aucun appel réseau dans le hook ; l'envoi est différé (POSTSEND) ou mis en file (JobQueue).		* '''Zéro impact sur l'enregistrement des pages''' — aucun appel réseau dans le hook ; l'envoi est différé (POSTSEND) ou mis en file (JobQueue).

Kims le 10 juin 2026 à 20:31

2026-06-10T20:31:18Z

← Version précédente		Version du 10 juin 2026 à 22:31
Ligne 6 :		Ligne 6 :
	\| hook1 = RecentChange_save		\| hook1 = RecentChange_save
	\| description = Diffusion des modifications récentes du wiki vers Discord sous forme d'annonces publiques (éditions, créations, suppressions, renommages, blocages…), entièrement configurable via une page spéciale.		\| description = Diffusion des modifications récentes du wiki vers Discord sous forme d'annonces publiques (éditions, créations, suppressions, renommages, blocages…), entièrement configurable via une page spéciale.
	\| auteur = ~~Fallout Generation~~		\| auteur = Les Archives de Vault-Tec
	\| dernière version = 2.0.0		\| dernière version = 2.0.0
	\| licence = GPL-2.0-or-later		\| licence = GPL-2.0-or-later

Kims : Page créée avec « {{Infobox_Extension | nom = Public Announcement System | état = stable | type1 = notification | type2 = page spéciale | hook1 = RecentChange_save | description = Diffusion des modifications récentes du wiki vers Discord sous forme d'annonces publiques (éditions, créations, suppressions, renommages, blocages…), entièrement configurable via une page spéciale. | auteur = Fallout Genera... »

2026-06-10T20:29:21Z

Page créée avec « {{Infobox_Extension | nom = Public Announcement System | état = stable | type1 = notification | type2 = page spéciale | hook1 = RecentChange_save | description = Diffusion des modifications récentes du wiki vers Discord sous forme d'annonces publiques (éditions, créations, suppressions, renommages, blocages…), entièrement configurable via une page spéciale. | auteur = Fallout Genera... »

Nouvelle page

{{Infobox_Extension
| nom = Public Announcement System
| état = stable
| type1 = notification
| type2 = page spéciale
| hook1 = RecentChange_save
| description = Diffusion des modifications récentes du wiki vers Discord sous forme d'annonces publiques (éditions, créations, suppressions, renommages, blocages…), entièrement configurable via une page spéciale.
| auteur = Fallout Generation
| dernière version = 2.0.0
| licence = GPL-2.0-or-later
| download = https://github.com/GenerationFallout/Public-Announcement-System
| mediawiki = ≥ 1.43
| php = ≥ 8.1
| exemple = https://fallout-wiki.com
}}

'''Public Announcement System''' (PAS) diffuse les modifications récentes du wiki vers un canal '''Discord''' sous forme d'annonces publiques : éditions, créations de pages, suppressions, renommages, téléversements, protections, blocages, créations de compte, etc.

L'extension est conçue pour la performance et la fiabilité :
* '''Zéro impact sur l'enregistrement des pages''' — aucun appel réseau dans le hook ; l'envoi est différé (POSTSEND) ou mis en file (JobQueue).
* '''Respect du rate limit Discord''' — les réponses HTTP 429 sont honorées via le <code>Retry-After</code> de Discord, avec re-programmation automatique (plafonnée à 5 tentatives).
* '''Entièrement localisable et personnalisable''' — chaque phrase envoyée vers Discord provient du système i18n et peut être réécrite directement sur le wiki ; icônes, couleurs, éléments affichés et routage sont configurables.

== Fonctionnalités ==
* Deux formats de message : '''ligne compacte''' (défaut) ou '''embed riche''' avec champs (taille, drapeaux, résumé, liens).
* Deux modes d'envoi : '''immédiat''' (latence < 1 s) ou '''file de jobs''' (retries automatiques).
* '''Configuration graphique''' via [[Special:PASystemConfig]] — sans toucher à <code>LocalSettings.php</code>.
* '''Routage multi-canaux''' : chaque type d'action (suppression, blocage…) peut partir vers son propre webhook.
* '''Filtrage fin''' : bots, modifications mineures, namespaces (liste blanche ou exclusions), utilisateurs, types de log, taille minimale du diff.
* '''Plafond anti-flood''' configurable (annonces/minute) avec avis unique de forte activité.
* Masquage des résumés auto-générés par MediaWiki (détection multilingue via les messages <code>autosumm-*</code> du core).
* Sécurité : mentions désactivées (<code>allowed_mentions</code>), aperçus supprimés, échappement du markdown (anti-hameçonnage par liens masqués), webhook HTTPS obligatoire.

== Installation ==
# Clonez le dépôt dans le répertoire <code>extensions/</code> :
#: <syntaxhighlight lang="bash">
cd extensions
git clone https://github.com/GenerationFallout/Public-Announcement-System.git PublicAnnouncementSystem
</syntaxhighlight>
# Ajoutez dans votre <code>LocalSettings.php</code> :
#: <syntaxhighlight lang="php">
wfLoadExtension( 'PublicAnnouncementSystem' );
$wgPASystemWebhookUrl = 'https://discord.com/api/webhooks/…/…';
</syntaxhighlight>
# Vérifiez sur [[Special:Version]] que l'extension est chargée, puis diffusez une annonce d'essai depuis [[Special:PASystemTest]].

L'extension reste '''désactivée''' tant que <code>$wgPASystemWebhookUrl</code> est vide.

== Configuration ==

=== Via le wiki (recommandé) ===
Presque tout se configure depuis '''[[Special:PASystemConfig]]''' (droit <code>pasystem-admin</code>, sysops par défaut) : format, mode d'envoi, identité du bot, filtres, plafond anti-flood, éléments d'affichage, icônes et couleurs.

Les réglages sont stockés dans [[MediaWiki:PASystemConfig.json]] — versionnés et révocables comme toute page du wiki — et '''prennent le pas sur <code>LocalSettings.php</code>'''. Les valeurs invalides sont ignorées sans risque. Pour revenir aux valeurs de <code>LocalSettings.php</code>, supprimez cette page.

'''Exception :''' les URL de webhook (<code>$wgPASystemWebhookUrl</code>, <code>$wgPASystemWebhookRoutes</code>) ne se définissent '''que''' dans <code>LocalSettings.php</code> — les pages du wiki sont publiques et ces URL contiennent un jeton secret.

=== Via LocalSettings.php ===
{| class="wikitable"
! Réglage !! Défaut !! Description
|-
| <code>$wgPASystemWebhookUrl</code> || <code>''</code> || URL du webhook Discord (HTTPS obligatoire). Vide = extension désactivée.
|-
| <code>$wgPASystemWebhookRoutes</code> || <code>{}</code> || Routage par type d'action : <code>edit</code>, <code>new</code>, <code>upload</code>, <code>delete</code>, <code>restore</code>, <code>move</code>, <code>protect</code>, <code>unprotect</code>, <code>block</code>, <code>unblock</code>, <code>newuser</code>, <code>rights</code>, <code>log</code>, <code>flood</code>. Les types sans route utilisent le webhook principal.
|-
| <code>$wgPASystemBotName</code> || <code>''</code> || Nom affiché du bot. Vide = nom du wiki.
|-
| <code>$wgPASystemBotAvatarUrl</code> || <code>''</code> || URL de l'avatar du bot (optionnel).
|-
| <code>$wgPASystemDeliveryMode</code> || <code>immediate</code> || <code>immediate</code> (latence < 1 s, sans retry) ou <code>job</code> (retries via JobQueue).
|-
| <code>$wgPASystemFormat</code> || <code>line</code> || <code>line</code> (compact) ou <code>embed</code> (riche).
|-
| <code>$wgPASystemMaxPerMinute</code> || <code>0</code> || Plafond d'annonces par minute. 0 = illimité.
|-
| <code>$wgPASystemNotifyBots</code> || <code>false</code> || Annoncer les modifications des bots.
|-
| <code>$wgPASystemNotifyMinor</code> || <code>true</code> || Annoncer les modifications mineures.
|-
| <code>$wgPASystemNotifyCategorization</code> || <code>false</code> || Annoncer les changements de catégorisation.
|-
| <code>$wgPASystemNotifyExternal</code> || <code>false</code> || Annoncer les changements externes (ex. Wikidata).
|-
| <code>$wgPASystemIncludedNamespaces</code> || <code>[]</code> || Liste blanche de namespaces (vide = tous).
|-
| <code>$wgPASystemExcludedNamespaces</code> || <code>[]</code> || Namespaces exclus, ex. <code>[ 2, 3 ]</code>.
|-
| <code>$wgPASystemExcludedUsers</code> || <code>[]</code> || Utilisateurs jamais annoncés.
|-
| <code>$wgPASystemExcludedLogTypes</code> || <code>[]</code> || Types de log ignorés, ex. <code>[ 'patrol', 'thanks' ]</code>.
|-
| <code>$wgPASystemMinDiffSize</code> || <code>0</code> || Taille minimale du diff (octets) pour annoncer une édition.
|-
| <code>$wgPASystemStripAutoSummaries</code> || <code>true</code> || Masquer les résumés auto-générés par MediaWiki.
|-
| <code>$wgPASystemDisplay</code> || <code>{}</code> || Interrupteurs d'affichage : <code>icons</code>, <code>delta</code>, <code>summary</code>, <code>diffLink</code>, <code>links</code>, <code>flags</code>, <code>footer</code>, <code>timestamp</code>.
|-
| <code>$wgPASystemActionIcons</code> || <code>{}</code> || Emoji par type d'action (fusionné avec les défauts).
|-
| <code>$wgPASystemEmbedColors</code> || ''(défauts)'' || Couleur RGB décimale par type d'action (format embed).
|-
| <code>$wgPASystemWikiBaseUrl</code> || <code>''</code> || URL de base pour les liens. Vide = déduite de <code>$wgServer</code>.
|-
| <code>$wgPASystemDebug</code> || <code>false</code> || Journalisation verbeuse (canal <code>PublicAnnouncementSystem</code>).
|}

== Personnalisation des textes ==
Chaque phrase envoyée vers Discord est un message i18n rendu dans la langue de contenu du wiki. On peut réécrire n'importe laquelle en modifiant la page <code>MediaWiki:Pasystem-…</code> correspondante (droit <code>editinterface</code>), sans toucher au code. Le markdown Discord est autorisé.

Exemple — rendre les annonces d'édition plus enthousiastes en modifiant [[MediaWiki:Pasystem-line-edit/fr]] :
<pre>$1 $2 vient d'améliorer $3$4$5$6 🎉</pre>

La liste complète des messages et de leurs paramètres figure dans le [https://github.com/GenerationFallout/Public-Announcement-System/blob/main/README.fr.md README].

== Pages spéciales ==
* '''[[Special:PASystemConfig]]''' — configuration graphique.
* '''[[Special:PASystemTest]]''' — diffuse une annonce de test vers le webhook.
Les deux exigent le droit <code>pasystem-admin</code> (sysops par défaut).

== Limites et confidentialité ==
* Les annonces sont '''permanentes côté Discord''' : une révision masquée a posteriori sur le wiki (RevisionDelete, oversight) reste visible dans le canal. Pensez à exclure les namespaces sensibles.
* Le plafond anti-flood utilise une fenêtre fixe d'une minute, pas une fenêtre glissante.
* En mode <code>immediate</code>, pas de retry sur les erreurs réseau ; utilisez le mode <code>job</code> pour une livraison garantie.

== Dépannage ==
* '''Rien n'arrive dans Discord''' — vérifiez <code>$wgPASystemWebhookUrl</code> puis utilisez [[Special:PASystemTest]]. En mode <code>job</code>, vérifiez que la JobQueue tourne.
* '''Annonces en retard''' — mode <code>job</code> avec runner en cron : passez en <code>immediate</code> ou exécutez le JobRunner plus souvent.
* Journal détaillé : <syntaxhighlight lang="php">
$wgDebugLogGroups['PublicAnnouncementSystem'] = '/var/log/mediawiki/pasystem.log';
$wgPASystemDebug = true;
</syntaxhighlight>

== Voir aussi ==
* [https://github.com/GenerationFallout/Public-Announcement-System Dépôt GitHub] — code source, [https://github.com/GenerationFallout/Public-Announcement-System/blob/main/CHANGELOG.md changelog], suivi des bugs
* [https://support.discord.com/hc/fr/articles/228383668 Créer un webhook Discord]

[[Catégorie:Extensions]]

Extension:PublicAnnouncementSystem - Historique des versions

Kims le 10 juin 2026 à 20:43

Kims le 10 juin 2026 à 20:43

Kims le 10 juin 2026 à 20:31