Extension:CampaignEvents/pt-br

Not to be confused with: Extension:Campaigns.

Manual de extensões do MediaWiki

CampaignEvents Estado da versão: estável
Implementação	Página especial , Tema
Descrição	Oferece recursos para organizadores e participantes de eventos
Autor(es)	Equipe de conexão
Política de compatibilidade	Lançamentos de snapshot junto com o MediaWiki. A master não é retrocompatível.
Modifica o banco de dados	Sim
Domínio virtual	virtual-campaignevents
Tabelas 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
Parâmetros $wgCampaignEventsEnableEventInvitation $wgCampaignEventsProgramsAndEventsDashboardInstance $wgCampaignEventsEnableEventGoals $wgCampaignEventsProgramsAndEventsDashboardAPISecret $wgCampaignEventsEnableWikimediaParticipantQuestions $wgCampaignEventsContributionTrackingDisallowedCountries $wgCampaignEventsEventNamespaces
Direitos adicionados campaignevents-enable-registration campaignevents-delete-registration campaignevents-organize-events campaignevents-email-participants campaignevents-view-private-participants campaignevents-generate-invitation-lists
Hooks usados ArticleViewHeader BeforeCreateEchoEvent BeforePageDisplay BlockIpComplete CentralAuthAccountDeleted CentralAuthUserVisibilityChanged DeleteAccount GetPreferences LoadExtensionSchemaUpdates RenameUserComplete TitleMove UnblockUserComplete UserMergeAccountFields
Hooks fornecidos CampaignEventsGetAllEventsTabs CampaignEventsGetPolicyMessageForRegistration CampaignEventsGetPolicyMessageForRegistrationForm
Licença	GNU GPL (Licença Pública Geral) 2.0 ou superior
Download	Baixar extensão Git [?]: Navegar pelo repositório (GitHub) Revisão de código no Gerrit Registro de commits no Git Baixar tarball do código-fonte
Para traduzir a extensão CampaignEvents, verifique sua disponibilidade no translatewiki.net
Problemas	Tarefas em aberto · Relatar um bug

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 Help:Extension:CampaignEvents and Registration for more information.

Instalação

• Baixe e mova a pasta extraída CampaignEvents ao seu diretório extensions/.
  Desenvolvedores e colaboradores de código, por outro lado, deverão instalar a extensão a partir do Git, usando:

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

• Adicione o seguinte código ao final do seu arquivo LocalSettings.php :

  wfLoadExtension( 'CampaignEvents' );
  

• Execute o script de atualização que criará automaticamente as tabelas necessárias a essa extensão no banco de dados.
• Instale a extensão de 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.
• Concluído – Navegue à página Special:Version em sua wiki para verificar se a instalação da extensão foi bem sucedida.

Direitos de usuário

Direito	Descrição
campaignevents-enable-registration	Ativar inscrições para o evento
campaignevents-delete-registration	Excluir inscrições do evento
campaignevents-organize-events	Organizar eventos
campaignevents-email-participants	Enviar e-mail aos participantes do evento
campaignevents-view-private-participants	ver participantes privados do evento

Parâmetros

Nome da variável	Valor padrão	Descrição
$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
$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.

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 . Por exemplo:

$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.

Scripts de manutenção

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.

Ver também

• High-level project overview on meta
• Extension:WikimediaCampaignEvents - provides Wikimedia-specific add-ons