Extension:Cargo/nl

From mediawiki.org
This page is a translated version of the page Extension:Cargo and the translation is 100% complete.
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.5.1 (maart 2024)
Compatibiliteit beleid Master onderhoudt achterwaartse compatibiliteit.
MediaWiki 1.37+
Database wijzigingen Ja
Composer mediawiki/cargo
Tabellen cargo_tables
cargo_pages
cargo_backlinks
Licentie GNU General Public Licentie 2.0 of hoger
Download
Voorbeeld Een pagina met verschillende aanroepen van #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
Downloads kwartaal 88 (Ranked 72nd)
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.35+.

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