This page is a translated version of the page Extension:Cargo and the translation is 62% complete.

Manual de extensiones de MediaWiki

👁 Image Cargo Estado de la versión: estable
👁 Image
Implementación	Página especial, API, Función del analizador
Descripción	Una extensión que permite el almacenamiento y la consulta de datos contenidos en plantillas.
Autor(es)	Yaron Koren <yaron57@gmail.com> (Yaron Korendiscusión)
Última versión	3.9.2 (junio de 2026)
Política de compatibilidad	La rama maestra mantiene la retrocompatibilidad.
MediaWiki	1.42+
Cambios en la base de datos	Sí
Composer	mediawiki/cargo
Tablas cargo_tables cargo_pages cargo_backlinks
Parámetros $wgCargoFileDataColumns $wgCargoDrilldownLargestFontSize $wgCargoDecimalMark $wgCargoDefaultStringBytes $wgCargoAllowedSQLFunctions $wgCargoHideNamespaceName $wgCargoMaxVisibleHierarchyDrilldownValues $wgCargoDrilldownSmallestFontSize $wgCargoDBTableOptions $wgCargoMaxQueryLimit $wgCargoDefaultMapService $wgCargoStoreUseTemplateArgsFallback $wgCargoPageDataColumns $wgCargoIgnoreBacklinks $wgCargoDigitGroupingCharacter $wgCargoDefaultQueryLimit $wgCargoDrilldownNumRangesForNumbers $wgCargo24HourTime $wgCargoLegacyNullLuaFieldsAsEmptyString $wgCargoTablesPrioritizeReplacements $wgCargoRecurringEventMaxInstances $wgCargoDrilldownUseTabs $wgCargoDrilldownMinValuesForComboBox $wgCargoMapClusteringMinimum
Derechos añadidos recreatecargodata deletecargodata runcargoqueries
Ganchos utilizados AdminLinks ApprovedRevsRevisionApproved ApprovedRevsRevisionUnapproved CategoryAfterPageAdded CategoryAfterPageRemoved LinksUpdate LoadExtensionSchemaUpdates MakeGlobalVariablesScript PageDeleteComplete PageForms::TemplateFieldEnd PageForms::TemplateFieldStart PageMoveComplete PageSaveComplete PageSchemasRegisterHandlers ParserFirstCallInit ResourceLoaderGetConfigVars ScribuntoExternalLibraries SidebarBeforeOutput SkinTemplateNavigation::Universal UploadComplete
Ganchos proporcionados CargoSetFormatClasses CargoBeforeStoreData CargoDisplayExportData CargoTablesSetAllowedActions CargoTablesSetActionLinks
Licencia	Licencia Pública General de GNU 2.0 o posterior
Descargar	Descargar la extensión. Git [?]: Explorar el repositorio (Phabricator · GitHub) revisión de código historial de cambios Download source tarball
Ejemplo	Wikimedia Australia's Cargo Tables
Traduce la extensión Cargo
Incidentes	Tareas abiertas · Reportar un error

Cargo es una extensión de MediaWiki que proporciona una forma liviana de almacenar y consultar los datos contenidos en las llamadas a plantillas, como las infoboxes. Es similar en concepto a la extensión de SemanticMediaWiki, pero ofrece una serie de ventajas, incluida la facilidad de instalación y uso.

Cargo almacena todos sus datos en tablas de bases de datos, que se pueden colocar en la propia base de datos de MediaWiki (la predeterminada) o en una base de datos separada. En su mayor parte, cada plantilla almacenada obtiene sus datos almacenados en una sola tabla de base de datos, con una columna para cada parámetro de plantilla relevante. Hay unas cuantas excepciones a esto: el manejando de campos de plantilla que listas de variedades/el control de valores, y de campos que control coordenadas geográficas, es más complejo, debido a pobre nativo manejando de aquellos tipos de dato en más DB sistemas. Y se pueden configurar varias plantillas para almacenar todos sus datos en una tabla de base de datos.

La extensión define una serie de funciones de analizador; estas tres son las más importantes:

• #cargo_declare – colocado dentro de la parte ‎<noinclude> de una plantilla; define el esquema para una tabla.
• #cargo_store – almacena una fila en una tabla Cargo; generalmente se coloca dentro de la parte de ‎<includeonly> de una plantilla.
• #cargo_query – consulta una o más tablas de datos de Cargo, usando componentes SQL.

Las otras funciones de analizador definidas son:

• #cargo_attach – Se define una plantilla como la adición de filas a una tabla declarada en otro lugar.
• #cargo_compound_query – muestra los resultados de múltiples consultas en un solo lugar.
• #cargo_display_map – muestra un mapa que muestra un solo punto.
• #recurring_event – imprime las fechas de un evento recurrente; para usar por #cargo_store.

Cargo también define varias interfaces para ver y profundizar en estos datos almacenados. Como tal, agrega las siguientes páginas especiales:

• Special:CargoQuery
• Special:CargoTableDiagram
• Special:CargoTables
• Special:Drilldown

Cargo ha sido probado y funciona con los sistemas de bases de datos MySQL y PostgreSQL. En teoría, también es compatible con SQLite, pero no ha sido ampliamente probado con SQLite y es posible que no funcione correctamente.

Esta versión de la extensión Cargo requiere MediaWiki 1.42+.

• Download and installation
  How to download Cargo via either Git, a standard download, or a software package; and how to install it.
• Quick start guide
  A short guide to generate Cargo-based templates and Cargo tables, especially in conjunction with the Page Forms extension.
• Other documentation
  Links to other forms of documentation
• SMW migration guide
  A guide for modifying templates and queries that use Semantic MediaWiki to switch to Cargo instead.
• Storing data
  Using #cargo_declare, #cargo_attach and #cargo_store to create and populate Cargo tables.
• Querying data
  Querying Cargo data with #cargo_query, #cargo_compound_query and other tools.
• Display formats
  The various display formats available, including lists, charts, maps and calendars.
• Browsing data
  Browsing the Cargo data using the built-in tools: Special:Drilldown, Special:CargoQuery, Special:CargoTables
• Exporting data
  Exporting Cargo data into output formats including: CSV, JSON, RSS
• Other features
  Other features of Cargo, including displaying maps and making use of Lua.
• Common problems
  Common issues that people have run into.
• Known bugs and planned features
  Known bugs in the software, and potential workarounds for them; plus features that are planned in the current development roadmap.
• Getting support
  Where to ask questions, submit bug reports, submit feature requests, submit fixes, and add new translations.
• Authors and credits
  The main authors, others who have contributed to the code, and credits to other organizations and software projects.
• Version history
  The release history of Cargo.
• Sites that use Cargo
  A small sampling of the wikis that use Cargo.
• Cargo and Semantic MediaWiki
  A comparison of Cargo to its main alternative, Semantic MediaWiki, in terms of both features and performance.
• FAQ
  Frequently-asked questions.

A continuación se encuentran las configuraciones globales de Cargo junto con sus valores predeterminados.

Para configurar Cargo para que utilice una base de datos separada en lugar de la base de datos de MediaWiki, se proporcionan las siguientes configuraciones:

Configuración de ajustes de la base de datos por separado
Opción	Por defecto	Descripción
$wgCargoDBtype	null	Tipo de base de datos.
$wgCargoDBserver	null	Nombre o dirección IP del servidor que hospeda la base de datos.
$wgCargoDBname	null	Nombre de la base de datos.
$wgCargoDBuser	null	Nombre de usuario de la base de datos
$wgCargoDBpassword	null	La contraseña para $wgCargoDBuser.
$wgCargoDBprefix	null	Prefijo del nombre de la tabla de la base de datos.
$wgCargoDBRowFormat	null	Formatos de filas de base de datos.
$wgCargoDBTableOptions	null	Comma-separated options, analogous to $wgDBTableOptions.

Para la configuración de caracteres relacionada con números, se proporcionan las siguientes configuraciones de configuración:

Configuración de caracteres
Configuración	Por defecto	Descripción
$wgCargoDecimalMark	.	Los números son decimales.
$wgCargoDigitGroupingCharacter	,	Separador de miles de dígitos.

Las configuraciones globales restantes son las siguientes:

Configuración	Por defecto	Descripción
$wgCargoAllowedSQLFunctions	[1]	Los conjuntos permiten funciones SQL.
$wgCargoRecurringEventMaxInstances	100	El número máximo de instancias que se almacenarán para eventos recurrentes sin fecha de finalización fijada.
$wgCargoDefaultStringBytes	300	El número predeterminado de caracteres Page campos de tipo Página, cadena, cadena de Wikitext, archivo, URL, correo electrónicoEmail
$wgCargoDefaultQueryLimit	100	Número de resultados para mostrar para #cargo_query si no se establece límite
$wgCargoMaxQueryLimit	5000	El número máximo permitido de resultados para #cargo_query
$wgCargoQueryMaxExecutionTime	null	The maximum amount of time (in milliseconds) that Cargo queries can run before they are stopped (MySQL/MariaDB only)
$wgCargo24HourTime	false	Si true utiliza el tiempo de 24 horas para los tipos de campo de Datetime
$wgCargoDefaultMapService	OpenLayers	Establece el servicio de mapas predeterminado en Google Maps, si se establece en googlemaps, en Follet si se establece a leaflet, y en OpenLayers si se establece para openlayers.
$wgCargoGoogleMapsKey	null	API clave para Google Maps, para el formato de visualización de googlemaps
$wgCargoMapClusteringMinimum	80	Si el número de puntos de mapa que se muestran es mayor que el valor de $wgCargoMapClusteringMinimum, el mapa muestra las ubicaciones en "agrupaciones" en lugar de puntos individuales, para su legibilidad. Si se establece en un número muy alto, no se muestra agrupamiento.
$wgCargoDrilldownUseTabs	true	Muestra los nombres de tablas Special:Drilldown como pestañas en la parte superior en lugar de una lista vertical en el lado.
$wgCargoDrilldownSmallestFontSize	-1	Si se establece en un número positivo, se establece el tamaño de fuente más pequeño, en píxeles, para una pantalla de valores de filtro en estilo de etiqueta-nube.
$wgCargoDrilldownLargestFontSize	-1	Si se establece en un número positivo, se establece el tamaño de fuente más grande, en píxeles, para una visualización de valores de filtro en estilo de etiqueta-nube.
$wgCargoDrilldownMinValuesForComboBox	40	Establece el número mínimo de valores antes de que su visualización se convierta en una caja combinada, en lugar de enlaces individuales.
$wgCargoDrilldownNumRangesForNumbers	5	Para los campos/filtros del tipo Integer o Float, especifique el número de "buckets" en los que se dividen los valores.
$wgCargoMaxVisibleHierarchyDrilldownValues	30	Si se establece en un número entero positivo, especifica el número máximo de valores mostrados a la vez para cualquier campo de hierarchy (Todos los valores de nivel superior se muestran independientemente de este valor). Los valores están ocultos más allá de una cierta profundidad de la jerarquía de tal manera que el recuento de los valores visibles totales es al máximo este número.
$wgCargoTablesPrioritizeReplacements	false	Si true, todas las tablas que tienen un reemplazo aparecen en la parte superior de la página de Special:CargoTables, en su lugar mostrándolas en orden alfabético.
$wgCargoPageDataColumns	[]	El conjunto de campos para almacenar en la tabla Cargo de _pageData. Consulte Almacenamiento de datos de página.
$wgCargoFileDataColumns	[]	El conjunto de campos para almacenar en la tabla Cargo de _fileData. Consulte Almacenamiento de datos de página.
$wgCargoHideNamespaceName	[6]	Array de espacios de nombres para ocultar de los resultados de la consulta.
$wgCargoLegacyNullLuaFieldsAsEmptyString	false	Null results to the Lua Cargo query function should return as string rather than nil. This allows you to rollback a breaking change from early 2022. New wikis created after this time should not enable this.
$wgCargoStoreUseTemplateArgsFallback	true	Enable the behavior that looks for template arguments that match the template's declared table to fill columns.

• Manual:Managing data in MediaWiki – Una descripción general y comparativa.

👁 Image

Esta extensión está incluida en los siguientes anfitriones/granjas wiki y/o paquetes: Canasta Fandom Miraheze MyWikis wiki.gg

Retrieved from "https://www.mediawiki.org/w/index.php?title=Extension:Cargo/es&oldid=8445141"