Extensión:Cargo/Descarga e instalación

Descarga

Puedes descargar el código de Cargo en formato .zip: https://github.com/wikimedia/mediawiki-extensions-Cargo/archive/3.7.zip

También puedes descargar el código directamente a través de Git desde el repositorio de código fuente de MediaWiki (ver available tags). Ejecuta el siguiente bloque desde la línea de comandos:

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

Para ver el código en línea, incluyendo el historial de versiones para cada archivo, vaya aquí: vista Código de carga

Instalación

Para instalar la extensión, coloque todo el directorio 'Cargo' dentro de su directorio 'extensiones' de MediaWiki, y luego añada la siguiente línea a su archivo 'LocalSettings.php':

wfLoadExtension( 'Cargo' );

Una vez que hayas configurado el código, Cargo tiene dos tablas de base de datos en la base de datos principal que requiere. Necesitará configurarlos visitando el directorio de mantenimiento de MediaWiki y llamando a lo siguiente:

php update.php

Finalmente, debe asegurarse de que la cuenta de base de datos con la que el código accede a la base de datos tenga la capacidad de crear y dejar caer tablas. Esta puede ser o no la cuenta de base de datos MediaWiki estándar; vea más adelante.

Borrar la base de datos

Por defecto, Cargo utiliza la base de datos MediaWiki estándar para almacenar sus datos. (Si tiene varias bases de datos configuradas, utilizando la configuración de $wgDBservers , se utilizará la primera de esas bases de datos.) Cargo diferencia sus tablas DB de todas las demás comenzando todos sus nombres con un prefijo, que por defecto es "cargo__".

Puedes cambiar esto para que Cargo use cualquier otra base de datos. (Aunque las dos tablas "ayudantes" de Cargo, cargo_tables y cargo_pages, permanecerán en la base de datos principal de MW.) Hay dos razones principales por las que puede ser una buena idea utilizar una base de datos separada:

• Existe la posibilidad de que Cargo tenga una fuga de seguridad, es decir, que las consultas de Cargo permitan la inclusión de SQL malicioso que permitiría a los usuarios acceder a información que no se supone que deben, o incluso modificar la base de datos. No hay fugas de seguridad conocidas - y Cargo utiliza muchas medidas de seguridad para tratar de prevenir tales fugas - pero eso no significa que no exista fugas. Si existe tal vulnerabilidad, tener una base de datos separada que utilice un usuario de base de datos independiente con permisos restringidos es la opción más segura.
• Si se ejecutan consultas lentas e intensas, ya sea de forma involuntaria o maliciosa, tener una base de datos separada en un servidor de base de datos independiente evitaría que dichas consultas interfieran con el funcionamiento regular de la wiki.

Cargo ofrece las siguientes configuraciones globales para que puedas configurar una base de datos separada:

Variable	Required?	Default	Description
$wgCargoDBserver	Required		required to set up the custom database
$wgCargoDBname	Required		required to set up the custom database
$wgCargoDBuser	Required		required to set up the custom database
$wgCargoDBpassword	Required		required to set up the custom database
$wgCargoDBtype	Optional	the value of $wgDBtype
$wgCargoDBprefix	Optional	""
$wgCargoDBfilePath	Optional		only needed for SQLite databases; see SQLite specific options

Estos se configuran de la misma manera que sus equivalentes no Cargo, que se pueden encontrar en LocalSettings.php. Para configurar esta base de datos personalizada, agregue líneas para al menos las primeras cuatro variables a LocalSettings.php.

Permisos

The runcargoqueries permission governs access to Special:CargoQuery and Special:Drilldown and by default is true for everyone. This can be changed by following the instructions in Manual:Derechos de usuarios .

Other requirements

• Si desea exportar datos a una hoja de cálculo de Excel, debe instalar la biblioteca PhpSpreadsheet en su servidor. Esto se puede hacer añadiendo phpoffice/phpspreadsheet a sus composer.local.json y ejecutando composer update --no-dev -o.

Actualización

Si usaste 'git clone' para instalar Cargo, puedes actualizar al último código con un simple comando. Puede que no sea una liberación estable.

Desde una línea de comando en el directorio Cargo, ejecuta lo siguiente:

git pull