Extensión:Cargo

This page is a translated version of the page Extension:Cargo and the translation is 44% complete.
Manual de extensiones de MediaWiki
Cargo
Estado de lanzamiento: estable
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.5.1 (marzo de 2024)
Política de compatibilidad Master mantiene la compatibilidad con versiones anteriores.
MediaWiki 1.37+
Cambios de la base de datos
Composer mediawiki/cargo
Tablas cargo_tables
cargo_pages
cargo_backlinks
Licencia GNU Licencia Pública general 2.0 o posterior
Descarga
Ejemplo Una página que contiene diversas llamadas a #cargo_query.
  • $wgCargoFileDataColumns
  • $wgCargoDrilldownLargestFontSize
  • $wgCargoDecimalMark
  • $wgCargoDefaultStringBytes
  • $wgCargoAllowedSQLFunctions
  • $wgCargoHideNamespaceName
  • $wgCargoPageDataColumns
  • $wgCargoMaxVisibleHierarchyDrilldownValues
  • $wgCargoDrilldownSmallestFontSize
  • $wgCargoIgnoreBacklinks
  • $wgCargoRecurringEventMaxInstances
  • $wgCargoDefaultMapService
  • $wgCargoStoreUseTemplateArgsFallback
  • $wgCargoLegacyNullLuaFieldsAsEmptyString
  • $wgCargoTablesPrioritizeReplacements
  • $wgCargoDigitGroupingCharacter
  • $wgCargoDefaultQueryLimit
  • $wgCargoDrilldownNumRangesForNumbers
  • $wgCargo24HourTime
  • $wgCargoMaxQueryLimit
  • $wgCargoDrilldownUseTabs
  • $wgCargoMapClusteringMinimum
  • $wgCargoDrilldownMinValuesForComboBox
  • recreatecargodata
  • deletecargodata
  • runcargoqueries
Descargas trimestrales 88 (Ranked 72nd)
Traduce el Cargo extensión
Asuntos Tareas abiertas · Reportar un bug

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 Extensión: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.35+.

Haz clic en las páginas de la barra de navegación de arriba para obtener más información sobre Cargo, cómo funciona, cómo usarlo y cómo instalarlo.

Instalación

Configuración

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:

Separate database configuration settings
Setting Default Description
$wgCargoDBtype null Database type.
$wgCargoDBserver null Host name or IP address of database server.
$wgCargoDBname null Name of the database.
$wgCargoDBuser null Database username.
$wgCargoDBpassword null The password for $wgCargoDBuser.
$wgCargoDBprefix null Database table name prefix.
$wgCargoDBRowFormat null Data base row format.

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

Character configuration settings
Setting Default Description
$wgCargoDecimalMark . Decimal character for numbers.
$wgCargoDigitGroupingCharacter , Thousands digit separator.

Las configuraciones globales restantes son las siguientes:

Setting Default Description
$wgCargoAllowedSQLFunctions [] Sets allowed SQL functions. See Using SQL Functions for defaults.
$wgCargoRecurringEventMaxInstances 100 The number of max instances to store for recurring events with no set end date.
$wgCargoDefaultStringBytes 300 The default number of characters for fields of type Page, String, Wikitext string, File, URL, Email
$wgCargoDefaultQueryLimit 100 Number of results to show for #cargo_query if no limit is set
$wgCargoMaxQueryLimit 5000 The maximum allowed number of results for #cargo_query
$wgCargo24HourTime false If true uses 24-hour time for Datetime field types.
$wgCargoDefaultMapService OpenLayers Sets the default map service to Google Maps, if set to googlemaps, to Leaflet if set to leaflet, and to OpenLayers if set to openlayers.
$wgCargoGoogleMapsKey null API key for Google Maps, for the googlemaps display format.
$wgCargoMapClusteringMinimum 80 If the number of map points displayed is greater than the value of $wgCargoMapClusteringMinimum, the map displays the locations in "clusters" instead of individual points, for readability. If set to a very high number, does not display clustering.
$wgCargoDrilldownUseTabs true Displays Special:Drilldown table names as tabs at the top instead of a vertical list at the side.
$wgCargoDrilldownSmallestFontSize -1 If set to a positive number, sets the smallest font size, in pixels, for a tag-cloud-style display of filter values.
$wgCargoDrilldownLargestFontSize -1 If set to a positive number, sets the largest font size, in pixels, for a tag-cloud-style display of filter values.
$wgCargoDrilldownMinValuesForComboBox 40 Sets the minimum number of values before their display is converted to a combo box, instead of individual links.
$wgCargoDrilldownNumRangesForNumbers 5 For fields/filters of type Integer or Float, specifies the number of "buckets" into which values are divided.
$wgCargoMaxVisibleHierarchyDrilldownValues 30 If set to a positive integer, specifies the maximum number of values shown at a time for any hierarchy field (All the top-level values are shown irrespective of this value). The values are hidden beyond a certain depth of the hierarchy such that the count of total visible values is at most this number.
$wgCargoTablesPrioritizeReplacements false If true, all tables having a replacement appear at the top of the Special:CargoTables page, instead displaying them in alphabetical order.
$wgCargoPageDataColumns [] The set of fields to store in the _pageData Cargo table. See Storing page data .
$wgCargoFileDataColumns [] The set of fields to store in the _fileData Cargo table. See Storing file data .
$wgCargoHideNamespaceName [6] Array of namespaces to hide from query results.
$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.


Véase también