Extension:Cargo/nl

Category:GPL licensed extensions/nl
MediaWiki Handleiding extensies
Cargo
Release status: stabielCategory:Stable extensions/nl
Implementatie Speciale pagina Category:Special page extensions/nl, API Category:API extensions/nl, Parser functie Category:Parser function extensions/nl
Beschrijving Een extensie die het mogelijk maakt om gegevens in sjablonen op te slaan en op te vragen.
Auteur(s) Yaron Koren <yaron57@gmail.com> (Yaron Korenoverleg)
Laatste versie 3.8.2 (juli 2025)
Compatibiliteit beleid Master onderhoudt achterwaartse compatibiliteit.
MediaWiki 1.40+Category:Extensions with manual MediaWiki version/nl
Database wijzigingen Ja
Composer mediawiki/cargoCategory:Extensions supporting Composer/nl
Tabellen cargo_tables
cargo_pages
cargo_backlinks
Licentie GNU General Public Licentie 2.0 of hoger
Download Category:Extensions in Wikimedia version control/nl
Voorbeeld Een pagina met verschillende aanroepen van #cargo_query
  • $wgCargoFileDataColumns
  • $wgCargoDrilldownLargestFontSize
  • $wgCargoDecimalMark
  • $wgCargoDefaultStringBytes
  • $wgCargoAllowedSQLFunctions
  • $wgCargoMaxVisibleHierarchyDrilldownValues
  • $wgCargoDrilldownSmallestFontSize
  • $wgCargoHideNamespaceName
  • $wgCargoMaxQueryLimit
  • $wgCargoDefaultMapService
  • $wgCargoStoreUseTemplateArgsFallback
  • $wgCargoPageDataColumns
  • $wgCargoIgnoreBacklinks
  • $wgCargoDigitGroupingCharacter
  • $wgCargoDefaultQueryLimit
  • $wgCargoDrilldownNumRangesForNumbers
  • $wgCargo24HourTime
  • $wgCargoLegacyNullLuaFieldsAsEmptyString
  • $wgCargoTablesPrioritizeReplacements
  • $wgCargoRecurringEventMaxInstances
  • $wgCargoDrilldownUseTabs
  • $wgCargoDrilldownMinValuesForComboBox
  • $wgCargoMapClusteringMinimum
  • recreatecargodata
  • deletecargodata
  • runcargoqueries
Vertaal de extensie Cargo
Problemen Open taken · Rapporteer een bug
Category:All extensions/nl

Cargo is een extensie op MediaWiki die een lichtgewicht manier biedt om de gegevens in de aanroepen naar sjablonen, zoals infoboxen, op te slaan en op te vragen. Het is qua concept vergelijkbaar met de extensie Semantic MediaWiki, maar biedt een aantal voordelen, waaronder installatiegemak en gebruiksgemak.

Cargo slaat al zijn gegevens op in databasetabellen, die in de eigen database van MediaWiki (de standaard) of een aparte database kunnen worden geplaatst. Voor het grootste deel krijgt elke opgeslagen sjabloon zijn gegevens opgeslagen in een enkele DB-tabel, met een kolom voor elke relevante sjabloonparameter. Hierop zijn enkele uitzonderingen: de verwerking van sjabloonvelden met arrays/lijsten met waarden en van velden met geografische coördinaten is complexer vanwege de slechte interne verwerking van die gegevenstypen in de meeste database-systemen. En meerdere sjablonen kunnen worden ingesteld om hun gegevens allemaal in één database-tabel op te slaan.

De extensie definieert een aantal parserfuncties; Deze drie zijn de belangrijkste:

  • #cargo_declare - geplaatst binnen het deel <noinclude> van een sjabloon; Het definieert het schema voor een tabel.
  • #cargo_store - slaat één rij op in een Cargo-tabel; meestal geplaatst binnen het deel <includeonly> van een sjabloon.
  • #cargo_query - voert query's uit op een of meer Cargo-gegevenstabellen met behulp van SQL-onderdelen.

De andere gedefinieerde parserfuncties zijn:

  • #cargo_attach - definieert een sjabloon als het toevoegen van rijen aan een tabel die elders is gedeclareerd.
  • #cargo_compound_query - hiermee worden de resultaten van meerdere query's op één plaats weergegeven.
  • #cargo_display_map - hiermee wordt een kaart weergegeven met één punt.
  • #recurring_event - drukt de datums voor een terugkerende gebeurtenis af; voor gebruik met #cargo_store.

Cargo definieert ook verschillende interfaces voor het bekijken en inzoomen van de opgeslagen gegevens. Deze extensie voegt de volgende speciale pagina's toe:

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

Cargo is getest en werkt met de MySQL- en PostgreSQL-databasesystemen. In theorie ondersteunt het ook SQLite, maar het is niet goed getest met SQLite en werkt mogelijk niet.

Deze versie van de extensie vereist MediaWiki 1.40+.

Klik door de pagina's in de navigatiebalk hierboven voor meer informatie over Cargo, hoe het werkt, hoe het te gebruiken en hoe het te installeren.

Installatie

Zie Download en Installatie.

Configuratie

Hieronder vindt u de algemene configuratie-instellingen van Cargo, samen met de standaardwaarden.

Om Cargo te configureren om een aparte database te gebruiken in plaats van de MediaWiki-database, zijn er de volgende instellingen:

Afzonderlijke database configuratie-instellingen
Instelling Standaard Beschrijving
$wgCargoDBtype null Databasetype
$wgCargoDBserver null Hostnaam of IP-adres van de database-server.
$wgCargoDBname null Naam van de database.
$wgCargoDBuser null Database gebruikersnaam.
$wgCargoDBpassword null Het wachtwoord voor $wgCargoDBuser.
$wgCargoDBprefix null Database tabelnaam prefix.
$wgCargoDBRowFormat null Database rij-formaat.

Voor karakterconfiguratie in verband met getallen zijn er de volgende instellingen:

Karakter configuratie-instellingen
Instelling Standaard Beschrijving
$wgCargoDecimalMark . Decimaalteken voor getallen.
$wgCargoDigitGroupingCharacter , Duizend-scheidingsteken.

De overige globale instellingen zijn als volgt:

Instelling Standaard Beschrijving
$wgCargoAllowedSQLFunctions [] Zet de toegestane SQL-functies. Zie SQL-Functies gebruiken voor standaarden.
$wgCargoRecurringEventMaxInstances 100 Het maximale aantal instanties dat moet worden opgeslagen voor terugkerende gebeurtenissen zonder vaste einddatum.
$wgCargoDefaultStringBytes 300 Het standaardnummer van tekens voor velden van type Page, String, Wikitext string, File, URL, Email
$wgCargoDefaultQueryLimit 100 Aantal resultaten die voor #cargo_query moeten worden weergegeven als er geen limiet is ingesteld
$wgCargoMaxQueryLimit 5000 Het maximaal toegestane aantal resultaten voor #cargo_query
$wgCargo24HourTime false Als true de 24 uur tijdnotatie gebruikt voor veldtypen van Datetime .
$wgCargoDefaultMapService OpenLayers Stel de standaard voor kaartservices in op Google Maps, indien ingesteld op googlemaps, op Leaflet als ingesteld als leaflet en op OpenLayers indien ingesteld als openlayers.
$wgCargoGoogleMapsKey null API-key voor Google Maps, voor het googlemaps weergaveformaat.
$wgCargoMapClusteringMinimum 80 Als het aantal weer te geven punten op de kaart groter is dan de waarde van $wgCargoMapClusteringMinimum, wordt de kaart met "clusters van locaties" weergegeven in plaats van in individuele punten, dit voor de leesbaarheid. Als het op een zeer hoog aantal wordt ingesteld, wordt geen clustering weergegeven.
$wgCargoDrilldownUseTabs true Toont de tabelnamen Special:Drilldown als tabbladen boven in plaats van een verticale lijst aan de zijkant.
$wgCargoDrilldownSmallestFontSize
Als het op een positief getal wordt ingesteld, wordt de kleinste lettergrootte, in pixels, ingesteld voor een tag-cloud weergave van filterwaarden.
$wgCargoDrilldownLargestFontSize
Als het op een positief getal wordt ingesteld, wordt de grootste lettergrootte, in pixels, ingesteld voor een tag-cloud weergave van filterwaarden.
$wgCargoDrilldownMinValuesForComboBox 40 Stelt het minimum aantal waarden voor de omzetting van het display in een combinatievak in plaats van in afzonderlijke links.
$wgCargoDrilldownNumRangesForNumbers 5 Voor velden/filters van type Integer of Float, wordt het aantal "buckets" aangegeven waarin de waarden worden verdeeld.
$wgCargoMaxVisibleHierarchyDrilldownValues 30 Als deze optie wordt ingesteld op een positief geheel getal, dan geeft het het maximum aantal waarden op dat tegelijk wordt weergegeven voor een veld hierarchy (alle waarden op het hoogste niveau worden weergegeven, ongeacht deze waarde). De waarden buiten een bepaalde diepte van de hiërarchie zijn verborgen, zodat het aantal totale zichtbare waarden maximaal dit getal is.
$wgCargoTablesPrioritizeReplacements false Als true, alle tabellen met een vervanging worden bovenaan de pagina van Special:CargoTables weergegeven, in plaats van dat ze in alfabetische volgorde worden weergegeven.
$wgCargoPageDataColumns [] De set velden die in de tabel _pageData van Cargo moet worden opgeslagen. Zie opslaan paginagegevens.
$wgCargoFileDataColumns [] De set velden die in de tabel _fileData van Cargo moet worden opgeslagen. Zie opslaan bestandsgegevens.
$wgCargoHideNamespaceName [6] Matrix met namespaces die in de queryresultaten moeten worden verborgen.
$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.

Zie ook

Category:Data extraction extensions/nl Category:Database extensions/nl Category:Table extensions/nl Category:Calendar extensions/nl Category:Map extensions/nl Category:Google Maps extensions/nl Category:OpenLayers extensions/nl Category:Leaflet extensions/nl Category:Graphical Timelines/nl Category:Graph extensions/nl Category:Math extensions/nl Category:Search extensions/nl Category:Data management extensions/nl
Category:API extensions/nl Category:AdminLinks extensions/nl Category:All extensions/nl Category:ApprovedRevsRevisionApproved extensions/nl Category:ApprovedRevsRevisionUnapproved extensions/nl Category:Calendar extensions/nl Category:CategoryAfterPageAdded extensions/nl Category:CategoryAfterPageRemoved extensions/nl Category:Data extraction extensions/nl Category:Data management extensions/nl Category:Database extensions/nl Category:Extensions in Wikimedia version control/nl Category:Extensions included in Canasta/nl Category:Extensions included in Fandom/nl Category:Extensions included in Miraheze/nl Category:Extensions included in MyWikis/nl Category:Extensions included in WikiForge/nl Category:Extensions included in wiki.gg/nl Category:Extensions supporting Composer/nl Category:Extensions with manual MediaWiki version/nl Category:GPL licensed extensions/nl Category:Google Maps extensions/nl Category:Graph extensions/nl Category:Graphical Timelines/nl Category:Leaflet extensions/nl Category:LinksUpdate extensions/nl Category:LoadExtensionSchemaUpdates extensions/nl Category:MakeGlobalVariablesScript extensions/nl Category:Map extensions/nl Category:Math extensions/nl Category:OpenLayers extensions/nl Category:PageDeleteComplete extensions/nl Category:PageForms::TemplateFieldEnd extensions/nl Category:PageForms::TemplateFieldStart extensions/nl Category:PageMoveComplete extensions/nl Category:PageSaveComplete extensions/nl Category:PageSchemasRegisterHandlers extensions/nl Category:ParserFirstCallInit extensions/nl Category:Parser function extensions/nl Category:ResourceLoaderGetConfigVars extensions/nl Category:ScribuntoExternalLibraries extensions/nl Category:Search extensions/nl Category:SidebarBeforeOutput extensions/nl Category:SkinTemplateNavigation::Universal extensions/nl Category:Special page extensions/nl Category:Stable extensions/nl Category:Table extensions/nl Category:UploadComplete extensions/nl