Erweiterung:CampaignEvents

Nicht zu verwechseln mit: Extension:Campaigns.

MediaWiki-Erweiterungen

CampaignEvents Freigabestatus: stabil
Einbindung	Spezialseite , Benutzeroberfläche
Beschreibung	Bietet Funktionen für Eventveranstalter:innen und Teilnehmer:innen
Autor(en)	Verbindungsteam
Kompatibilitätspolitik	Snapshots werden zusammen mit MediaWiki veröffentlicht. Der Master ist nicht abwärtskompatibel.
Datenbankänderungen	Ja
Virtual domain	virtual-campaignevents
Tabellen 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
Parameter $wgCampaignEventsEnableEventInvitation $wgCampaignEventsProgramsAndEventsDashboardInstance $wgCampaignEventsEnableEventGoals $wgCampaignEventsProgramsAndEventsDashboardAPISecret $wgCampaignEventsEnableWikimediaParticipantQuestions $wgCampaignEventsContributionTrackingDisallowedCountries $wgCampaignEventsEventNamespaces
Hinzugefügte Rechte campaignevents-enable-registration campaignevents-delete-registration campaignevents-organize-events campaignevents-email-participants campaignevents-view-private-participants campaignevents-generate-invitation-lists
Verwendete Hooks ArticleViewHeader BeforeCreateEchoEvent BeforePageDisplay BlockIpComplete CentralAuthAccountDeleted CentralAuthUserVisibilityChanged DeleteAccount GetPreferences LoadExtensionSchemaUpdates RenameUserComplete TitleMove UnblockUserComplete UserMergeAccountFields
Bereitgestellte Hooks CampaignEventsGetAllEventsTabs CampaignEventsGetPolicyMessageForRegistration CampaignEventsGetPolicyMessageForRegistrationForm
Lizenz	GNU General Public License 2.0 oder neuer
Herunterladen	Erweiterung herunterladen Git [?]: Repository durchsuchen (GitHub) Code-Review Ergänzungen und Änderungen Download source tarball
Übersetze die CampaignEvents-Erweiterung, wenn sie auf translatewiki.net verfügbar ist
Probleme	Offene Aufgaben · Einen Fehler melden

CampaignEvents ist eine vom der Wikimedia Foundation Verbindungsteam erstellte und gepflegte MediaWiki-Erweiterung, die Werkzeuge zum Organisieren und Abhalten von Veranstaltungen, inklusive Registrierung, Kommunikation und einer Organisations-Übersicht. Für weitere Informationen siehe Help:Extension:CampaignEvents und Registrierung.

Installation

• Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens CampaignEvents im Ordner extensions/ ablegen.
  Entwickler und Code-Beitragende sollten stattdessen die Erweiterung von Git installieren, mit:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CampaignEvents
  

• Folgenden Code am Ende deiner LocalSettings.php -Datei einfügen:

  wfLoadExtension( 'CampaignEvents' );
  

• Führe das Aktualisierungsskript aus, welches automatisch die notwendigen Datenbanktabellen erstellt, die diese Erweiterung braucht.
• Installiere die CLDR -Erweiterung This is a hard dependency but cannot be declared as such due to a bug in the MediaWiki installer.
• Schedule a cronjob that runs the #script to update timezones (optional), and one for the #script to aggregate participant answers.
• Erledigt – Navigiere zu Special:Version in deinem Wiki, um zu überprüfen, ob die Erweiterung erfolgreich installiert wurde.

Konfiguration

Benutzerrechte

Recht	Beschreibung
campaignevents-enable-registration	Veranstaltungsanmeldungen ermöglichen
campaignevents-delete-registration	Veranstaltungsanmeldungen löschen
campaignevents-organize-events	Veranstaltungen organisieren
campaignevents-email-participants	E-Mail an Veranstaltungsteilnehmer
campaignevents-view-private-participants	Teilnehmer privater Veranstaltungen anzeigen

Parameter

Variablenname	Standardwert	Beschreibung
$wgCampaignEventsProgramsAndEventsDashboardInstance	null	Determines which instance of the P&E Dashboard should be used, if any. Supported values are 'production', 'staging', or null to not use the dashboard. Note that this setting should use the same value for all wikis sharing the same central database for events: otherwise, the application might crash or show inconsistent data when viewing an event created on another wiki.
$wgCampaignEventsProgramsAndEventsDashboardAPISecret	null	API secret to use with the selected P&E Dashboard instance. Muss konfiguriert sein, wenn das P&E-Dashboard verwendet werden soll.
$wgCampaignEventsEnableWikimediaParticipantQuestions	true	Whether to enable Wikimedia-specific questions that can be asked to participants, such as whether they belong to a Wikimedia affiliate.
$wgCampaignEventsEventNamespaces	[ NS_EVENT, NS_PROJECT ]	Liste der zugelassenen Namesräume zur Eventregistrierung
$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.

Die Erweiterung kann so konfiguriert werden, dass die Daten in einer anderen Datenbank gespeichert werden als die Hauptdatenbank. You do so by configuring the virtual-campaignevents domain, see Manual:$wgVirtualDomainsMapping . Zum Beispiel:

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

Dies ist insbesondere in Kombination mit einer zentralen Datenbank, die alle Veranstaltungen einer ganzen Wiki-Familie speichert, hilfreich. Beachte, dass die Wiki-Farm dafür zentrale Benutzer-IDs verwenden muss.

API

Eine Dokumentation aller API-Endpunkte ist hier verfügbar.

Wartungsskripte

Skript, um die Zeitzonen zu aktualisieren

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. Du kannst hier weitere Details lesen. In order to mitigate that, the extension provides a maintenance script that recomputes the UTC timestamps for all events according to the latest timezone rules, and stores them back into the database.

In order for this to work, you have to make sure that PHP has access to the latest version of the tz database. Das PHP-Handbuch bietet Kontext dazu. Die einfachste Lösung ist, das timezonedb-PECL Packet zu installieren und sicherzustellen, dies aktuell zu halten.

Angenommen, dass PHP Zugriff auf die neusten Zeitzonenregeln hat, kann das Skript wie folgende ausgeführt werden:

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

The script also takes an optional --timezone parameter where you can specify the name of a time zone whose rules changed; this parameter can be repeated multiple times. If passed, the script will only update events whose timezone matches one of the timezones specified via this parameter.

If you upgrade the time zone database automatically (e.g., with a cronjob), you can make that job also execute this script, so that you don't have to do it manually every time you upgrade the time zone database. Otherwise, you can manually run the script after you update the time zone info, or just have it run on a fixed schedule (like once a day).

Script, was die Antworten der Teilnehmer:innen aggregiert

The extension provides a maintenance script that aggregates participant answers after a 90 day period. The script can be run with:

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

The script should be configured to run automatically (e.g., as an hourly cronjob) to make sure that PII isn't retained for longer than it needs to.

Siehe auch

• High-level project overview on meta
• Erweiterung:WikimediaCampaignEvents - bietet Wikimedia-spezifische Addons