Extension:Cargo/nl

MediaWiki Handleiding extensies

Cargo Release status: stabiel
Implementatie	Speciale pagina , API , Parser functie
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.7 (september 2024)
Compatibiliteit beleid	Master onderhoudt achterwaartse compatibiliteit.
MediaWiki	1.39+
Database wijzigingen	Ja
Composer	mediawiki/cargo
Tabellen	cargo_tables cargo_pages cargo_backlinks
Licentie	GNU General Public Licentie 2.0 of hoger
Download	Extensie downloaden Git [?]: Download Git master blader door de repository (Phabricator · GitHub) commitgeschiedenis repository beheerders (GitHub) code review
Voorbeeld	Een pagina met verschillende aanroepen van #cargo_query
Parameters $wgCargoFileDataColumns $wgCargoDrilldownLargestFontSize $wgCargoDecimalMark $wgCargoDefaultStringBytes $wgCargoAllowedSQLFunctions $wgCargoHideNamespaceName $wgCargoPageDataColumns $wgCargoIgnoreBacklinks $wgCargoMaxVisibleHierarchyDrilldownValues $wgCargoDrilldownSmallestFontSize $wgCargoLegacyNullLuaFieldsAsEmptyString $wgCargoRecurringEventMaxInstances $wgCargoDefaultMapService $wgCargoStoreUseTemplateArgsFallback $wgCargoTablesPrioritizeReplacements $wgCargoMaxQueryLimit $wgCargoDigitGroupingCharacter $wgCargoDefaultQueryLimit $wgCargoDrilldownNumRangesForNumbers $wgCargo24HourTime $wgCargoDrilldownUseTabs $wgCargoMapClusteringMinimum $wgCargoDrilldownMinValuesForComboBox
Toegevoegde rechten recreatecargodata deletecargodata runcargoqueries
Gebruikte hooks AdminLinks ApprovedRevsRevisionApproved ApprovedRevsRevisionUnapproved CategoryAfterPageAdded CategoryAfterPageRemoved LinksUpdate LoadExtensionSchemaUpdates MakeGlobalVariablesScript PageDeleteComplete PageForms::TemplateFieldEnd PageForms::TemplateFieldStart PageMoveComplete PageSaveComplete PageSchemasRegisterHandlers ParserFirstCallInit ResourceLoaderGetConfigVars ScribuntoExternalLibraries SidebarBeforeOutput SkinTemplateNavigation::Universal UploadComplete
Beschikbare hooks CargoSetFormatClasses CargoBeforeStoreData CargoDisplayExportData CargoTablesSetAllowedActions CargoTablesSetActionLinks
Downloads kwartaal	52 (Ranked 84th)
Vertaal de extensie Cargo
Problemen	Open taken · Rapporteer een bug

Cargo is een uitbreiding 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.38+.

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	-1	Als het op een positief getal wordt ingesteld, wordt de kleinste lettergrootte, in pixels, ingesteld voor een tag-cloud weergave van filterwaarden.
$wgCargoDrilldownLargestFontSize	-1	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

• Handleiding:Gegevens beheren in MediaWiki – Een overzicht en een vergelijking.
• Semantic MediaWiki – Maakt het mogelijk om gegevens binnen pagina's op te slaan en op te vragen.
• WikiDB – Biedt databasefuncties die enigszins lijken op semantische eigenschappen.
• Wikibase – Maakt het mogelijk om gestructureerde gegevens weer te geven en te manipuleren als onderdeel van het Wikidata-project.