Extension:Événements de campagne

**Manuel des extensions MediaWiki**
CampaignEvents; État de la version : stable
Implémentation	Page spéciale, Habillage
Description	Fonctionnalités pour les organisateurs/organisatrices d'événements et les participants/participantes
Auteur(s)	Connection Team
Politique de compatibilité	Versions ponctuelles alignées avec MediaWiki. Le master n'est pas compatible arrière.
Modifie la base; de données	Oui
Domaine virtuel	virtual-campaignevents
	Tables campaign_events; ; ce_address; ; ce_event_address; ; ce_event_questions; ; ce_event_topics; ; ce_event_wikis; ; ce_invitation_lists; ; ce_organizers; ; ce_participants; ; ce_question_aggregation; ; ce_question_answers; ; ce_tracking_tools; ; ce_worklist_articles;
	Paramètres $wgCampaignEventsEnableEventInvitation; $wgCampaignEventsProgramsAndEventsDashboardInstance; $wgCampaignEventsEnableEventGoals; $wgCampaignEventsProgramsAndEventsDashboardAPISecret; $wgCampaignEventsEnableWikimediaParticipantQuestions; $wgCampaignEventsContributionTrackingDisallowedCountries; $wgCampaignEventsEventNamespaces;
	Droits ajoutés campaignevents-enable-registration; campaignevents-delete-registration; campaignevents-organize-events; campaignevents-email-participants; campaignevents-view-private-participants; campaignevents-generate-invitation-lists;
	Accroches utilisées ArticleViewHeader; BeforeCreateEchoEvent; BeforePageDisplay; BlockIpComplete; CentralAuthAccountDeleted; CentralAuthUserVisibilityChanged; DeleteAccount; GetPreferences; LoadExtensionSchemaUpdates; RenameUserComplete; TitleMove; UnblockUserComplete; UserMergeAccountFields;
	Accroches fournies CampaignEventsGetAllEventsTabs; CampaignEventsGetPolicyMessageForRegistration; CampaignEventsGetPolicyMessageForRegistrationForm;
Licence	Licence publique générale GNU v2.0 ou ultérieur
Téléchargement	Télécharger l'extension ; Git [?]: parcourir le dépôt (GitHub); relecture Gerrit du code; historique Git des validations (commits); Télécharger le tarball source;
Aide	Help:Extension:CampaignEvents/fr
	Traduire l’extension CampaignEvents sur translatewiki.net si elle y est disponible
Problèmes	Tâches ouvertes · Signaler un bogue

This page is a translated version of the page Extension:CampaignEvents and the translation is 79% complete.

Outdated translations are marked like this.

CampaignEvents est une extension de MediaWiki, créée et maintenue par l'Equipe des campagnes de la Fondation Wikimedia, qui fournit des outils pour l'organisation et le déroulement d'événements, y compris l'inscription, la communication et un tableau de bord de l'organisateur. Voir Inscription pour plus d'informations.

Installation

Téléchargez et placez le(s) fichier(s) dans un répertoire appelé CampaignEvents dans votre dossier extensions/.
Les développeurs et les contributeurs au code doivent à la place installer l'extension à partir de Git en utilisant:
```
cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CampaignEvents
```
Ajoutez le code suivant à la fin de votre fichier LocalSettings.php :
```
wfLoadExtension( 'CampaignEvents' );
```
Exécutez le script de mise à jour qui va créer automatiquement les tables de base de données dont cette extension a besoin.
Install the CLDR extension. This is a hard dependency but cannot be declared as such due to a bug in the MediaWiki installer.
Programmez une tâche cron qui exécute le #script pour mettre à jour les fuseaux horaires (optionnel), et un autre pour le #script pour agréger les réponses des participants.
Fait – Accédez à Special:Version sur votre wiki pour vérifier que l'extension a bien été installée.

Configuration

Droits utilisateurs

Droit	Description
campaignevents-enable-registration	Activer les inscriptions aux événements
campaignevents-delete-registration	Supprimer les inscriptions aux événements
campaignevents-organize-events	Organiser des événements
campaignevents-email-participants	Envoyer des courriels aux participants à un événement
campaignevents-view-private-participants	Afficher les participants à l'événement privé

Paramètres

Variable nom	Valeur par défaut	Description
`$wgCampaignEventsProgramsAndEventsDashboardInstance`	`null`	Détermine l'instance du Tableau de bord P&E à utiliser, le cas échéant. Les valeurs prises en charge sont $2, $3 ou $4 pour ne pas utiliser le tableau de bord. Supported values are `'production'`, `'staging'`, or `null` to not use the dashboard. Notez que ce paramètre doit utiliser la même valeur pour tous les wikis partageant la même base de données centrale pour les événements : sinon, l'application risque de planter ou d'afficher des données incohérentes lors de la visualisation d'un événement créé sur un autre wiki.
`$wgCampaignEventsProgramsAndEventsDashboardAPISecret`	`null`	API secret à utiliser avec l'instance de tableau de bord P&E sélectionnée. Doit être configuré si vous avez l'intention d'utiliser le tableau de bord P&E.
`$wgCampaignEventsEnableWikimediaParticipantQuestions`	`true`	L'activation ou non des questions spécifiques à Wikimedia qui peuvent être posées aux participants/participantes, par exemple s'ils/elles appartiennent à une organisation affiliée à Wikimedia.
`$wgCampaignEventsEventNamespaces`	`[ NS_EVENT, NS_PROJECT ]`	Liste des espaces de noms autorisés pour les inscriptions à des événements
`$wgCampaignEventsCountrySchemaMigrationStage`	`MIGRATION_OLD`	Migration stage of the country code migration, one of the `MIGRATION_*` constants.
`$wgCampaignEventsContributionTrackingDisallowedCountries`	`[]`	Map of countries for which in-person or hybrid events cannot use contribution tracking (e.g. for legal reasons, see the Wikimedia Foundation Country and Territory Protection List). This maps CLDR country codes to English country names, but only the former are used; the names are included for convenience, and are assumed to be correct.

L'extension peut être configurée pour stocker les données dans une base de données autre que la base de données principale du wiki. Pour ce faire, vous devez configurer le domaine virtual-campaignevents, voir Manual:$wgVirtualDomainsMapping . Par exemple :

$wgVirtualDomainsMapping['virtual-campaignevents'] = [ 'db' => 'my_central_db' ];

Ceci est particulièrement utile en combinaison avec une base de données centrale qui stocke les événements pour toute une famille de wikis. Notez, si vous le faites, que la batterie de wikis doit utiliser identifiants centraux .

API

Documentation de tous les points de terminaison de l'API est disponible.

Scripts de maintenance

Script de mise à jour des fuseaux horaires

The extension stores the local time and timezone for each event, to guarantee that the local time remains accurate even if time zone rules change. However,internally it also stores UTC timestamps so that certain operations like sorting are possible. The UTC timestamps may go out of sync with the local ones if time zone rules change, which happens more commonly than you may think. Vous pouvez lire plus de détails. Pour pallier ce problème, l'extension fournit un script de maintenance qui recalcule les horodatages UTC de tous les événements en fonction des dernières règles de fuseau horaire, et les réintègre dans la base de données.

In order for this to work, you have to make sure that PHP has access to the latest version of the tz database. Le manuel de PHP fournit un peu de contexte à ce sujet. La solution la plus simple est d'installer le paquetage timezonedb PECL et de s'assurer qu'il est à jour.

En supposant que PHP ait accès aux dernières règles de fuseau horaire, vous pouvez exécuter le script avec :

$ php maintenance/run.php ./extensions/CampaignEvents/maintenance/UpdateUTCTimestamps.php

Le script prend également un paramètre optionnel --timezone dans lequel vous pouvez spécifier le nom d'un fuseau horaire dont les règles ont été modifiées ; ce paramètre peut être répété plusieurs fois. Si cette option est activée, le script ne mettra à jour que les événements dont le fuseau horaire correspond à l'un des fuseaux horaires spécifiés dans ce paramètre.

Si vous mettez à jour la base de données des fuseaux horaires automatiquement (par exemple, avec une tâche cron), vous pouvez faire en sorte que cette tâche exécute également ce script, de sorte que vous n'ayez pas à le faire manuellement à chaque fois que vous mettez à jour la base de données des fuseaux horaires. Sinon, vous pouvez exécuter manuellement le script après avoir mis à jour les informations relatives au fuseau horaire, ou le faire exécuter selon un calendrier fixe (une fois par jour, par exemple).

Script pour agréger les réponses des participants/participantes

L'extension fournit un script de maintenance qui regroupe les réponses des participants/participantes après une période de 90 jours. Le script peut être exécuté avec :

$ php maintenance/run.php ./extensions/CampaignEvents/maintenance/AggregateParticipantAnswers.php

Le script doit être configuré pour s'exécuter automatiquement (par exemple, en tant que tâche cron horaire) afin de s'assurer que les IIP ne sont pas conservées plus longtemps que nécessaire.

Voir aussi

Vue d'ensemble du projet sur meta
Extension:WikimediaCampaignEvents - fournit des modules complémentaires spécifiques à Wikimedia

Cette extension est utilisée par au moins un des projets Wikimédia. Cela signifie probablement que l’extension est assez stable et fonctionnelle pour être utilisée sur des sites à fort trafic. Recherchez le nom de cette extension dans le CommonSettings.php de Wikimédia et dans le fichier de configuration InitialiseSettings.php pour situer les endroits où elle est installée. Une liste complète des extensions installées sur un Wiki donné peut être visualisée sur la page Special:Version de ce wiki.