Extension:Cargo

Manuel des extensions MediaWiki

Cargo État de la version : stable
Implémentation	Page spéciale , API , Fonction d'analyseur
Description	Une extension qui permet l'enregistrement et la recherche de données contenues dans les modèles.
Auteur(s)	Yaron Koren <yaron57@gmail.com> (Yaron Korendiscussion)
Dernière version	3.7 (septembre 2024)
Politique de compatibilité	Le master conserve la compatibilité arrière.
MediaWiki	1.39+
Modifie la base de données	Oui
Composer	mediawiki/cargo
Tables	cargo_tables cargo_pages cargo_backlinks
Licence	Licence publique générale GNU v2.0 ou supérieur
Téléchargement	Télécharger l'extension Git [?]: Télécharger la branche master de Git parcourir le dépôt (Phabricator · GitHub) historique des validations (commits) contributeurs du dépôt (GitHub) relecture du code
Exemple	Une page contenant différents appels à #cargo_query
Paramètres $wgCargoFileDataColumns $wgCargoDrilldownLargestFontSize $wgCargoDecimalMark $wgCargoDefaultStringBytes $wgCargoAllowedSQLFunctions $wgCargoHideNamespaceName $wgCargoPageDataColumns $wgCargoIgnoreBacklinks $wgCargoMaxVisibleHierarchyDrilldownValues $wgCargoDrilldownSmallestFontSize $wgCargoLegacyNullLuaFieldsAsEmptyString $wgCargoRecurringEventMaxInstances $wgCargoDefaultMapService $wgCargoStoreUseTemplateArgsFallback $wgCargoTablesPrioritizeReplacements $wgCargoMaxQueryLimit $wgCargoDigitGroupingCharacter $wgCargoDefaultQueryLimit $wgCargoDrilldownNumRangesForNumbers $wgCargo24HourTime $wgCargoDrilldownUseTabs $wgCargoMapClusteringMinimum $wgCargoDrilldownMinValuesForComboBox
Droits ajoutés recreatecargodata deletecargodata runcargoqueries
Accroches utilisées AdminLinks ApprovedRevsRevisionApproved ApprovedRevsRevisionUnapproved CategoryAfterPageAdded CategoryAfterPageRemoved LinksUpdate LoadExtensionSchemaUpdates MakeGlobalVariablesScript PageDeleteComplete PageForms::TemplateFieldEnd PageForms::TemplateFieldStart PageMoveComplete PageSaveComplete PageSchemasRegisterHandlers ParserFirstCallInit ResourceLoaderGetConfigVars ScribuntoExternalLibraries SidebarBeforeOutput SkinTemplateNavigation::Universal UploadComplete
Accroches fournies CargoSetFormatClasses CargoBeforeStoreData CargoDisplayExportData CargoTablesSetAllowedActions CargoTablesSetActionLinks
Téléchargements trimestriels	52 (Ranked 84th)
Traduire l’extension Cargo
Problèmes	Tâches ouvertes · Signaler un bogue

Cargo est une extension de MediaWiki qui fournit une manière allégée d'enregistrer et rechercher les données contenues dans les appels aux modèles, comme les boîtes d'information. Dans le principe, elle est similaire à l'extension Semantic MediaWiki , mais offre plusieurs avantages, y compris la facilité d'installation et d'utilisation.

Cargo enregistre toutes ses données dans les tables de la base de données, qui peuvent être placées soit dans la propre base de données de MediaWiki (par défaut), soit dans une base de données séparée. Dans la plupart des cas, chaque modèle enregistré récupère ses données rangées dans une table unique de la base de données, avec une colonne pour chaque paramètre significatif du modèle. Il existe quelques exceptions à cela : la manipulation des champs d'un modèle qui contiennent des tableaux ou des listes de valeurs, des coordonnées géographiques; ceci est plus complexe dû à la gestion native assez pauvre de ces types de données dans la plupart des systèmes de bases de données. Et plusieurs modèles peuvent être initialisés pour ranger leurs données dans une table de la base de données.

L'extension définit un nombre de fonctions d'analyse syntaxique; les trois suivantes sont les plus importantes :

• #cargo_declare - placé à l'intérieur de la partie ‎<noinclude> d'un modèle; il définit le schéma pour une table.
• #cargo_store - range une ligne dans une table Cargo; habituellement placé à l'intérieur de la partie ‎<includeonly> d'un modèle.
• #cargo_query - interroge une ou plusieurs tables de données Cargo, en utilisant les composants SQL.

Les autres fonctions d'analyse définies sont :

• #cargo_attach - définit un modèle en ajoutant des lignes à une table déclarée quelque part.
• #cargo_compound_query - affiche le résultat de plusieurs requêtes à un même endroit.
• #cargo_display_map - affiche une carte montrant un seul point.
• #recurring_event - affiche les dates d'un événement récurrent; pour être utilisé par #cargo_store.

Cargo définit également diverses interfaces pour la visualisation et l'exploration de ces données stockées. As such, it adds the following special pages:

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

Cargo a été testé, et fonctionne, avec les systèmes de base de données MySQL, PostgreSQL. En théorie, il prend également en charge SQLite , mais il n'a pas été testé avec ce système et peut ne pas fonctionner.

Cette version de l'extension Cargo nécessite MediaWiki 1.38+.

Cliquez sur les pages de la barre de navigation ci-dessus pour en savoir plus sur Cargo, son fonctionnement, son utilisation et son installation.

Installation

See Download and Installation .

Configuration

Below are Cargo's global configuration settings along with their default values.

To configure Cargo to use a separate database instead of the MediaWiki database, the following settings are provided:

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.

For character configuration as related to numbers, the following configuring settings are provided:

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

The remaining global configuration settings are as follows:

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.

Voir aussi

• Manuel:Gestion des données dans MediaWiki – Aperçu et comparaison.
• Semantic MediaWiki – Permet l'enregistrement et la recherche de données contenues dans les pages.
• WikiDB – Fournit les fonctionalités de base de données, semblables quelque peu aux propriétés sémantiques.
• Wikibase – Permet de représenter et de manipuler les données structurées comme partie du projet Wikidata.