Extension:CampaignEvents

No confundir con Extension:Campaigns.

Manual de extensiones de MediaWiki

CampaignEvents Estado de la versión: estable
Implementación	Página especial , Apariencia
Descripción	Ofrece funcionalidades para para personas que organizan y/ participan en eventos
Autor(es)	Connection Team
Política de compatibilidad	Se publican nuevas instantáneas junto con MediaWiki. La rama maestra no es retrocompatible.
PHP	>8.1.7
Cambios en la base de datos	Sí
Dominio virtual	virtual-campaignevents
Tablas	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
Licencia	Licencia Pública General de GNU 2.0 o posterior
Descargar	Descargar la extensión. Git [?]: Explorar el repositorio (GitHub) revisión de código historial de cambios Download source tarball
Ayuda	Help:Extension:CampaignEvents/es
Parámetros $wgCampaignEventsContributionTrackingDisallowedCountries $wgCampaignEventsEnableEventInvitation $wgCampaignEventsProgramsAndEventsDashboardInstance $wgCampaignEventsEnableContributionTracking $wgCampaignEventsProgramsAndEventsDashboardAPISecret $wgCampaignEventsEnableWikimediaParticipantQuestions $wgCampaignEventsEventNamespaces $wgCampaignEventsCountrySchemaMigrationStage
Derechos añadidos campaignevents-enable-registration campaignevents-delete-registration campaignevents-organize-events campaignevents-email-participants campaignevents-view-private-participants
Ganchos utilizados ArticleViewHeader BeforeCreateEchoEvent GetPreferences LoadExtensionSchemaUpdates TitleMove
Ganchos proporcionados CampaignEventsGetAllEventsTabs CampaignEventsGetPolicyMessageForRegistration CampaignEventsGetPolicyMessageForRegistrationForm
Traduce la extensión CampaignEvents si está disponible en translatewiki.net
Incidentes	Tareas abiertas · Reportar un error

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

Instalación

• Descarga y mueve la carpeta CampaignEvents extraída a tu directorio extensions/.
  Los desarrolladores y contribuidores de código deberían instalar la extensión desde Git en su lugar, usando:

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

• Añade el siguiente código en la parte final de tu archivo LocalSettings.php :

  wfLoadExtension( 'CampaignEvents' );
  

• Ejecuta la secuencia de actualización, que creará automáticamente las tablas de la base de datos que necesita esta extensión.
• Install the CLDR extension. This is a hard dependency but cannot be declared as such due to a bug in the MediaWiki installer.
• Programa un cronjob que ejecute el #script para actualizar las zonas horarias (opcional), y otro para el #script para agregar las respuestas de las personas participantes.
• Hecho – Navega a Special:Version en el wiki para verificar que la extensión se haya instalado correctamente.

Configuración

Permisos

Permiso	Descripción
campaignevents-enable-registration	Permitir inscripciones para los eventos
campaignevents-delete-registration	Eliminar inscripciones de los eventos
campaignevents-organize-events	Organizar eventos
campaignevents-email-participants	Enviar correos electrónicos a las personas participantes del evento
campaignevents-view-private-participants	Visualizar participantes privados del evento

Parámetros

Nombre de variable	Valor predeterminado	Decripción
$wgCampaignEventsProgramsAndEventsDashboardInstance	null	Determina qué instancia del P&E Dashboard se debe utilizar, si existe. Los valores admitidos son 'production', 'staging' o null para no utilizar el cuadro de mandos. 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 que se utilizará con la instancia seleccionada del Cuadro de mandos del dashboard. Debe configurarse si desea utilizar el dashboard.
$wgCampaignEventsEnableWikimediaParticipantQuestions	true	Si se habilitan preguntas específicas de Wikimedia que puedan hacerse a participantes, como por ejemplo si pertenecen a un afiliado de Wikimedia.
$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.

La extensión puede configurarse para almacenar datos en una base de datos distinta de la base de datos principal del wiki. Para ello, configura el dominio virtual-campaignevents, véase Manual:$wgVirtualDomainsMapping . Por ejemplo:

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

Esto resulta especialmente útil en combinación con una base de datos central que almacene los eventos de toda una familia wiki. Ten en cuenta, si lo haces, que la wiki farm necesita utilizar central user IDs .

API

Documentación de todos los endpoints de la API disponible.

Scripts de mantenimiento

Script para actualizar la hora local

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. Puedes leer más detalles. Para mitigarlo, la extensión proporciona un script de mantenimiento que vuelve a calcular las marcas de tiempo UTC de todos los eventos de acuerdo con las últimas reglas de zona horaria, y las almacena de nuevo en la base de datos.

In order for this to work, you have to make sure that PHP has access to the latest version of the tz database. El manual PHP proporciona contexto sobre esto. La solución más sencilla es instalar el paquete PECL timezonedb y asegurarse de mantenerlo actualizado.

Suponiendo que PHP tiene acceso a las últimas reglas de zona horaria, puede ejecutar el script con:

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

El script también toma un parámetro opcional --timezone donde puede especificar el nombre de una zona horaria cuyas reglas cambiaron; este parámetro puede repetirse varias veces. Si se pasa, el script sólo actualizará los eventos cuya zona horaria coincida con una de las zonas horarias especificadas mediante este parámetro.

Si actualiza la base de datos de zonas horarias automáticamente (por ejemplo, con un cronjob), puede hacer que ese trabajo también ejecute este script, para no tener que hacerlo manualmente cada vez que actualice la base de datos de zonas horarias. 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 para agregar las respuestas de participantes

La extensión proporciona un script de mantenimiento que agrega las respuestas de las personas participantes tras un periodo de 90 días. El script se puede ejecutar con:

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

El script debe configurarse para que se ejecute automáticamente (por ejemplo, como un cronjob) para asegurarse de que la IIP no se retiene durante más tiempo del necesario.

Véase también

• Visión general del proyecto en meta
• Extension:WikimediaCampaignEvents - proporciona complementos específicos de Wikimedia