Extension:CampaignEvents

No confundir con Extension:Campaigns.

Manual de extensiones de MediaWiki

CampaignEvents Estado de lanzamiento: estable
Implementación	Página especial , Piel
Descripción	Ofrece funcionalidades para para personas que organizan y/ participan en eventos
Autor(es)	Equipo de Campañas
Política de compatibilidad	Lanzamientos de screenshots junto con MediaWiki. Master no es compatible con versiones anteriores.
MediaWiki	>= 1.43
Cambios de la base de datos	Sí
Virtual domain	virtual-campaignevents
Tablas	campaign_events ce_participants ce_organizers ce_address ce_event_address ce_tracking_tools
Licencia	GNU Licencia Pública general 2.0 o posterior
Descarga	Descargar la extensión. Git [?]: Descargar desde master de Git Explorar el repositorio (GitHub) historial de cambios Colaboradores de repositorio (GitHub) revisión de código
Parámetros $wgCampaignEventsEnableEventInvitation $wgCampaignEventsProgramsAndEventsDashboardInstance $wgCampaignEventsProgramsAndEventsDashboardAPISecret $wgCampaignEventsEnableWikimediaParticipantQuestions $wgCampaignEventsShowEventInvitationSpecialPages
Derechos añadidos campaignevents-enable-registration campaignevents-delete-registration campaignevents-organize-events campaignevents-email-participants
Hooks que usa ArticleViewHeader BeforeCreateEchoEvent LoadExtensionSchemaUpdates PageDeleteComplete PageMoveComplete SpecialPage_initList TitleMove
Descargas trimestrales	4 (Ranked 134th)
Traduce la extensión CampaignEvents si está disponible en translatewiki.net
Asuntos	Tareas abiertas · Reportar un bug

CampaignEvents is a MediaWiki extension, created and maintained by the Wikimedia Foundation Campaigns Team, which provides tools for organizing and running events, including registration, communication and an organizer dashboard. See Registration for more information.

Instalación

• Descarga y extrae los archivos en un directorio denominado «CampaignEvents» dentro de la carpeta extensions/.
  Developers and code contributors should install the extension from Git instead, using: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.
• 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	Habilitar inscripciones a eventos
campaignevents-delete-registration	Eliminar inscripciones del evento
campaignevents-organize-events	Organizar eventos
campaignevents-email-participants	Enviar email a participantes

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

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

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