Extension:Événements de campagne
![]() É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) | Équipe de campagne |
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_participants ce_organizers ce_address ce_event_address ce_tracking_tools |
Licence | Licence publique générale GNU v2.0 ou supérieur |
Téléchargement | |
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 |
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 dossierextensions/
.
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 |
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 'production' , 'staging' ou null pour ne pas utiliser le tableau de bord.
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 ]
|
Liste des espaces de noms autorisés pour les inscriptions à des événements |
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. |