Extension:CampaignEvents/ja

**MediaWiki 拡張機能マニュアル**
CampaignEvents; リリースの状態: 安定
実装	特別ページ, 外装
説明	Provides features for event organizers and participants
作者	Connection Team
互換性の方針	スナップショットが MediaWiki とともにリリースされます。 master には後方互換性がありません。
データベースの変更	はい
仮想ドメイン	virtual-campaignevents
	テーブル 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;
	パラメーター $wgCampaignEventsEnableWorklistEventDiscoveryTracking; $wgCampaignEventsEnableEventInvitation; $wgCampaignEventsProgramsAndEventsDashboardInstance; $wgCampaignEventsEnableWorklists; $wgCampaignEventsProgramsAndEventsDashboardAPISecret; $wgCampaignEventsEnableWikimediaParticipantQuestions; $wgCampaignEventsContributionTrackingDisallowedCountries; $wgCampaignEventsEventNamespaces;
	追加する権限 campaignevents-enable-registration; campaignevents-delete-registration; campaignevents-organize-events; campaignevents-email-participants; campaignevents-view-private-participants; campaignevents-generate-invitation-lists;
	使用するフック ArticleViewHeader; BeforeCreateEchoEvent; BeforePageDisplay; BlockIpComplete; CentralAuthAccountDeleted; CentralAuthUserVisibilityChanged; DeleteAccount; GetPreferences; LoadExtensionSchemaUpdates; RenameUserComplete; TitleMove; UnblockUserComplete; UserMergeAccountFields; getUserPermissionsErrors;
	提供するフック CampaignEventsGetAllEventsTabs; CampaignEventsGetPolicyMessageForRegistration; CampaignEventsGetPolicyMessageForRegistrationForm;
ライセンス	GNU 一般公衆利用許諾書 2.0 以降
ダウンロード	拡張機能をダウンロード ; Git [?]: リポジトリを参照 (GitHub); Gerrit コードレビュー; Git コミットログ; Download source tarball;
ヘルプ	Help:Extension:CampaignEvents/ja
	translatewiki.net で翻訳を利用できる場合は、CampaignEvents 拡張機能の翻訳にご協力ください
問題点	未解決のタスク · バグを報告

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

CampaignEvents is a MediaWiki extension, created and maintained by the Wikimedia Foundation Connection Team, which provides tools for organizing and running events, including registration, communication and an organizer dashboard. See キャンペーンイベント and Registration for more information.

Group Goal-Setting - As of April 2026, event organizers can set, track, and display shared event goals in real time (such as the total number of articles created or the number of participants). This enables participants to work toward collective targets and visualize their combined impact as the event unfolds.^[1]

インストール

ダウンロードして、ファイルをextensions/フォルダー内のCampaignEventsという名前のディレクトリ内に配置します。
開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:
```
cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CampaignEvents
```
以下のコードを LocalSettings.php ファイルの末尾に追加します:
```
wfLoadExtension( 'CampaignEvents' );
```
更新スクリプトを実行します。このスクリプトは、この拡張機能が必要とするデータベーステーブルを自動的に作成します。
CLDR 拡張機能をインストールします。 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.
完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

設定

利用者権限

権限	説明
campaignevents-enable-registration	イベント登録を有効化
campaignevents-delete-registration	イベント登録を削除
campaignevents-organize-events	イベントを開催
campaignevents-email-participants	メールイベントに参加
campaignevents-view-private-participants	プライベートイベントの参加者を閲覧

パラメーター

変数名	既定値	説明
`$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. Must be configured if you intend to use the P&E Dashboard.
`$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 ]`	List of permitted namespaces for event registration
`$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.

The extension can be configured to store data into a database other than the main wiki DB. You do so by configuring the virtual-campaignevents domain, see Manual:$wgVirtualDomainsMapping . 例:

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

This is especially useful in combination with a central database that stores event for a whole wiki family. Note, if you do so, that the wiki farm needs to use central user IDs .

API

Documentation of all the API endpoints is available.

メンテナンススクリプト

Script to update timezones

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. You can read more details. 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. The PHP manual provides some context about this. The easiest solution is to install the timezonedb PECL package and make sure to keep it up-to-date.

Assuming that PHP has access to the latest timezone rules, you can run the script with:

$ 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 to aggregate participant answers

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.