Wikimore

**Příručka k rozšířením MediaWiki**
Cargo; Stav rozšíření: stabilníCategory:Stable extensions/cs
Implementace	Speciální stránkaCategory:Special page extensions/cs, APICategory:API extensions/cs, Funkce analyzátoruCategory:Parser function extensions/cs
Popis	Rozšíření, které umožňuje ukládání dat a dotazování na data obsažená v šablonách.
Autoři	Yaron Koren <yaron57@gmail.com> (Yaron Korendiskuse)
Nejnovější verze	3.8 (dubna 2025)
Zásady kompatibility	Větev master zachovává zpětnou kompatibilitu.
MediaWiki	1.40+Category:Extensions with manual MediaWiki version
Změny v databázi	Ano
Composer	mediawiki/cargoCategory:Extensions supporting Composer/cs
Tabulky	cargo_tables; cargo_pages; cargo_backlinks
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření ; Git [?]: Procházení úložiště (Phabricator · GitHub); Kontrola kódu Gerrit; Zobrazení historie Git; Stáhněte si zdrojový soubor tarball; Category:Extensions in Wikimedia version control/cs
Příklad	Stránka obsahující různá volání na #cargo_query
	Parametry $wgCargoFileDataColumns; $wgCargoDrilldownLargestFontSize; $wgCargoDecimalMark; $wgCargoDefaultStringBytes; $wgCargoAllowedSQLFunctions; $wgCargoHideNamespaceName; $wgCargoPageDataColumns; $wgCargoIgnoreBacklinks; $wgCargoMaxVisibleHierarchyDrilldownValues; $wgCargoDrilldownSmallestFontSize; $wgCargoLegacyNullLuaFieldsAsEmptyString; $wgCargoRecurringEventMaxInstances; $wgCargoDefaultMapService; $wgCargoStoreUseTemplateArgsFallback; $wgCargoTablesPrioritizeReplacements; $wgCargoMaxQueryLimit; $wgCargoDigitGroupingCharacter; $wgCargoDefaultQueryLimit; $wgCargoDrilldownNumRangesForNumbers; $wgCargo24HourTime; $wgCargoDrilldownUseTabs; $wgCargoMapClusteringMinimum; $wgCargoDrilldownMinValuesForComboBox;
	Přidaná práva recreatecargodata; deletecargodata; runcargoqueries;
	Použité háčky (hooks) AdminLinksCategory:AdminLinks extensions/cs; ApprovedRevsRevisionApprovedCategory:ApprovedRevsRevisionApproved extensions/cs; ApprovedRevsRevisionUnapprovedCategory:ApprovedRevsRevisionUnapproved extensions/cs; CategoryAfterPageAddedCategory:CategoryAfterPageAdded extensions/cs; CategoryAfterPageRemovedCategory:CategoryAfterPageRemoved extensions/cs; LinksUpdateCategory:LinksUpdate extensions/cs; LoadExtensionSchemaUpdatesCategory:LoadExtensionSchemaUpdates extensions/cs; MakeGlobalVariablesScriptCategory:MakeGlobalVariablesScript extensions/cs; PageDeleteCompleteCategory:PageDeleteComplete extensions/cs; PageForms::TemplateFieldEndCategory:PageForms::TemplateFieldEnd extensions/cs; PageForms::TemplateFieldStartCategory:PageForms::TemplateFieldStart extensions/cs; PageMoveCompleteCategory:PageMoveComplete extensions/cs; PageSaveCompleteCategory:PageSaveComplete extensions/cs; PageSchemasRegisterHandlersCategory:PageSchemasRegisterHandlers extensions/cs; ParserFirstCallInitCategory:ParserFirstCallInit extensions/cs; ResourceLoaderGetConfigVarsCategory:ResourceLoaderGetConfigVars extensions/cs; ScribuntoExternalLibrariesCategory:ScribuntoExternalLibraries extensions/cs; SidebarBeforeOutputCategory:SidebarBeforeOutput extensions/cs; SkinTemplateNavigation::UniversalCategory:SkinTemplateNavigation::Universal extensions/cs; UploadCompleteCategory:UploadComplete extensions/cs;
	Poskytované háčky (hooks) CargoSetFormatClasses; CargoBeforeStoreData; CargoDisplayExportData; CargoTablesSetAllowedActions; CargoTablesSetActionLinks;
Čtvrtletní stahování	70 (Ranked 56th)
	Přeložte rozšíření Cargo
Problémy	Otevřené úkoly · Nahlásit chybu

Category:GPL licensed extensions/csCategory:All extensions/cs

Cargo 'je rozšíření MediaWiki, které poskytuje snadný způsob ukládání a dotazování na data obsažená v rámci volání šablon, například infoboxů. V konceptu je podobné rozšíření Semantic MediaWiki , ale nabízí řadu výhod, včetně jednoduchosti instalace a snadného použití.

Cargo ukládá všechna svá data do databázových tabulek, které lze umístit buď do vlastní databáze MediaWiki (výchozí) nebo do samostatné databáze. Z větší části získává každá šablona svá data uložená jen v jediné tabulce DB se sloupcem pro každý vhodný parametr šablony. Existuje několik výjimek: Zpracování polí šablon, která obsahují pole nebo seznamy hodnot, a polí, která obsahují zeměpisné souřadnice, je složitější kvůli špatnému nativnímu (nezměněném stavu) zpracování těchto datových typů ve většině systémů DB. A lze nastavit několik šablon, aby všechny ukládaly svá data do jediné tabulky DB.

Přípona definuje řadu funkcí syntaktického analyzátoru. Tyto tři jsou nejdůležitější:

#cargo_declare - umístěné v části ‎<noinclude> šablony. Definuje schéma pro tabulku.
#cargo_store - ukládá jeden řádek do Cargo table. Obvykle umístěné v rámci ‎<includeonly> šablony.
#cargo_query - dotazuje jednu nebo více datových tabulek Cargo pomocí součástí SQL.

Další definované funkce analyzátoru jsou:

#cargo_attach - definuje šablonu jako přidání řádků do tabulky deklarované jinde.
#cargo_compound_query - zobrazí výsledky více dotazů na jednom místě.
#cargo_display_map - zobrazí mapu s jedním bodem.
#recurring_event - vytiskne data pro opakující se událost. Pro použití #cargo_store.

Cargo také definuje různá rozhraní pro prohlížení a procházení těchto uložených dat. Jako takový přidává následující speciální stránky:

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

Cargo bylo testováno a pracuje s databázovými systémy MySQL a PostgreSQL. Teoreticky také podporuje SQLite, ale nebyl dobře testován s SQLite a nemusí fungovat.

Tato verze rozšíření Cargo vyžaduje MediaWiki 1.38+.

Kliknutím na stránky na navigační liště výše se dozvíte více o Cargo, jak funguje, jak jej používat a jak jej nainstalovat.

Instalace

Viz Stažení a instalace .

Konfigurace

Níže jsou uvedena globální nastavení konfigurace Cargo spolu s jejich výchozími hodnotami.

Chcete-li nakonfigurovat Cargo tak, aby místo databáze MediaWiki používala samostatnou databázi, jsou k dispozici následující nastavení:

Samostatná nastavení konfigurace databáze
Nastavení	Výchozí	Popis
`$wgCargoDBtype`	`null`	Typ databáze.
`$wgCargoDBserver`	`null`	Název hostitele nebo IP adresa databázového serveru.
`$wgCargoDBname`	`null`	Název databáze.
`$wgCargoDBuser`	`null`	Uživatelské jméno databáze.
`$wgCargoDBpassword`	`null`	Heslo pro `$wgCargoDBuser`.
`$wgCargoDBprefix`	`null`	Předpona názvu databázové tabulky.
`$wgCargoDBRowFormat`	`null`	Formát řádku databáze.

Pro konfiguraci znaků související s čísly jsou k dispozici následující konfigurační nastavení:

Nastavení konfigurace znaků
Nastavení	Výchozí	Popis
`$wgCargoDecimalMark`	`.`	Desetinný znak pro čísla.
`$wgCargoDigitGroupingCharacter`	`,`	Oddělovač tisíců číslic.

Zbývající globální konfigurační nastavení jsou následující:

Nastavení	Výchozí	Popis
`$wgCargoAllowedSQLFunctions`	`[]`	Nastavuje povolené funkce SQL. Výchozí nastavení viz Použití funkcí SQL .
`$wgCargoRecurringEventMaxInstances`	`100`	Maximální počet instancí k uložení pro opakující se události bez nastaveného data ukončení.
`$wgCargoDefaultStringBytes`	`300`	Výchozí počet znaků pro pole typu `Page`, `String`, `Wikitext string`, `File`, `URL`, `Email`
`$wgCargoDefaultQueryLimit`	`100`	Počet výsledků, které se mají zobrazit pro `#cargo_query`, pokud není nastaven žádný limit
`$wgCargoMaxQueryLimit`	`5000`	Maximální povolený počet výsledků pro `#cargo_query`
`$wgCargo24HourTime`	`false`	Pokud `true` používá 24hodinový čas pro typy polí `Datetime`.
`$wgCargoDefaultMapService`	`OpenLayers`	Nastaví výchozí mapovou službu na Mapy Google, pokud je nastavena na `googlemaps`, na Leaflet, pokud je nastavena na `leaflet`, a na OpenLayers, pokud je nastavena na `openlayers`.
`$wgCargoGoogleMapsKey`	`null`	Klíč API pro Mapy Google pro formát zobrazení `googlemaps`.
`$wgCargoMapClusteringMinimum`	`80`	Pokud je počet zobrazených bodů na mapě větší než hodnota $wgCargoMapClusteringMinimum, mapa kvůli čitelnosti zobrazuje místa ve "shlucích" místo jednotlivých bodů. Pokud je nastaveno na velmi vysoké číslo, nezobrazuje shlukování.
`$wgCargoDrilldownUseTabs`	`true`	Zobrazuje názvy tabulek Special:Drilldown jako karty nahoře namísto svislého seznamu po straně.
`$wgCargoDrilldownSmallestFontSize`	`-1`	Pokud je nastaveno na kladné číslo, nastaví nejmenší velikost písma v pixelech pro zobrazení hodnot filtrů ve stylu tag-cloud.
`$wgCargoDrilldownLargestFontSize`	`-1`	Pokud je nastaveno na kladné číslo, nastaví největší velikost písma v pixelech pro zobrazení hodnot filtrů ve stylu tag-cloud.
`$wgCargoDrilldownMinValuesForComboBox`	`40`	Nastaví minimální počet hodnot, než se jejich zobrazení převede na pole se seznamem namísto jednotlivých odkazů.
`$wgCargoDrilldownNumRangesForNumbers`	`5`	Pro pole/filtry typu `Integer` nebo `Float` určuje počet "segmentů", do kterých jsou hodnoty rozděleny.
`$wgCargoMaxVisibleHierarchyDrilldownValues`	`30`	Je-li nastaveno na kladné celé číslo, určuje maximální počet hodnot zobrazených najednou pro libovolné pole `hierarchy` (zobrazeny jsou všechny hodnoty nejvyšší úrovně bez ohledu na tuto hodnotu). Hodnoty jsou skryté za určitou hloubkou hierarchie, takže počet celkových viditelných hodnot je nejvýše toto číslo.
`$wgCargoTablesPrioritizeReplacements`	`false`	Pokud je `true`, všechny tabulky, které mají náhradu, se zobrazí v horní části stránky Special:CargoTables, místo toho se zobrazí v abecedním pořadí.
`$wgCargoPageDataColumns`	`[]`	Sada polí, která se mají uložit do tabulky `_pageData` Cargo. Viz Ukládání dat stránky .
`$wgCargoFileDataColumns`	`[]`	Sada polí, která se mají uložit do tabulky `_fileData` Cargo. Viz Ukládání dat souboru .
`$wgCargoHideNamespaceName`	`[6]`	Pole jmenných prostorů, které se mají skrýt před výsledky dotazu.
`$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.

Související odkazy

Příručka:Správa dat v MediaWiki – přehled a srovnání.
Semantic MediaWiki – umožňuje ukládání a dotazování dat na stránkách.
WikiDB – poskytuje databázové funkce, poněkud podobné sémantickým (významovým) vlastnostem.
Wikibase – umožňuje reprezentovat a manipulovat se strukturovanými daty jako součástí projektu Wikidata.

Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích:

Toto není autoritativní seznam. Některé wiki farmy/hostitelé a/nebo balíčky mohou toto rozšíření obsahovat, i když zde nejsou uvedeny. Pro potvrzení se vždy obraťte na své wiki farmy/hostitele nebo balíček.

Category:Data extraction extensions/cs Category:Database extensions/cs Category:Table extensions/cs Category:Calendar extensions/cs Category:Map extensions/cs Category:Google Maps extensions/cs Category:OpenLayers extensions/cs Category:Leaflet extensions/cs Category:Graphical Timelines/cs Category:Graph extensions/cs Category:Math extensions/cs Category:Search extensions/cs Category:Data management extensions/cs

Cargo - navigace
Základní informace	Hlavní stránka (diskuse) Stažení a instalace Průvodce pro rychlé seznámení Další dokumentace Průvodce migrací SMW
Použití Carga	Ukládání dat Dotazování na data (Formáty zobrazení ) Prohlížení dat Export dat Jiné funkce
Zdroje s nápovědou	Obvyklé problémy Známé chyby a plánované funkcionality Kde získat podporu
O Cargu	Autoři a přispěvatelé Historie verzí Stránky, které používají Cargo Cargo a sémantická MediaWiki FAQ

Cargo Stav rozšíření: stabilníCategory:Stable extensions/cs

Implementace	Speciální stránka Category:Special page extensions/cs, API Category:API extensions/cs, Funkce analyzátoru Category:Parser function extensions/cs
Popis	Rozšíření, které umožňuje ukládání dat a dotazování na data obsažená v šablonách.
Autoři	Yaron Koren <yaron57@gmail.com> (Yaron Koren^diskuse)
Nejnovější verze	3.8 (dubna 2025)
Zásady kompatibility	Větev master zachovává zpětnou kompatibilitu.
MediaWiki	1.40+Category:Extensions with manual MediaWiki version
Změny v databázi	Ano
Composer	mediawiki/cargo Category:Extensions supporting Composer/cs
Tabulky	cargo_tables cargo_pages cargo_backlinks
Licence	GNU General Public License 2.0 nebo novější
Stáhnout	Stáhněte si rozšíření Git ^[?]: Procházení úložiště (Phabricator · GitHub) Kontrola kódu Gerrit Zobrazení historie Git Stáhněte si zdrojový soubor tarball Category:Extensions in Wikimedia version control/cs
Příklad	Stránka obsahující různá volání na #cargo_query
Parametry $wgCargoFileDataColumns $wgCargoDrilldownLargestFontSize $wgCargoDecimalMark $wgCargoDefaultStringBytes $wgCargoAllowedSQLFunctions $wgCargoHideNamespaceName $wgCargoPageDataColumns $wgCargoIgnoreBacklinks $wgCargoMaxVisibleHierarchyDrilldownValues $wgCargoDrilldownSmallestFontSize $wgCargoLegacyNullLuaFieldsAsEmptyString $wgCargoRecurringEventMaxInstances $wgCargoDefaultMapService $wgCargoStoreUseTemplateArgsFallback $wgCargoTablesPrioritizeReplacements $wgCargoMaxQueryLimit $wgCargoDigitGroupingCharacter $wgCargoDefaultQueryLimit $wgCargoDrilldownNumRangesForNumbers $wgCargo24HourTime $wgCargoDrilldownUseTabs $wgCargoMapClusteringMinimum $wgCargoDrilldownMinValuesForComboBox
Přidaná práva recreatecargodata deletecargodata runcargoqueries
Použité háčky (hooks) AdminLinks Category:AdminLinks extensions/cs ApprovedRevsRevisionApproved Category:ApprovedRevsRevisionApproved extensions/cs ApprovedRevsRevisionUnapproved Category:ApprovedRevsRevisionUnapproved extensions/cs CategoryAfterPageAdded Category:CategoryAfterPageAdded extensions/cs CategoryAfterPageRemoved Category:CategoryAfterPageRemoved extensions/cs LinksUpdate Category:LinksUpdate extensions/cs LoadExtensionSchemaUpdates Category:LoadExtensionSchemaUpdates extensions/cs MakeGlobalVariablesScript Category:MakeGlobalVariablesScript extensions/cs PageDeleteComplete Category:PageDeleteComplete extensions/cs PageForms::TemplateFieldEnd Category:PageForms::TemplateFieldEnd extensions/cs PageForms::TemplateFieldStart Category:PageForms::TemplateFieldStart extensions/cs PageMoveComplete Category:PageMoveComplete extensions/cs PageSaveComplete Category:PageSaveComplete extensions/cs PageSchemasRegisterHandlers Category:PageSchemasRegisterHandlers extensions/cs ParserFirstCallInit Category:ParserFirstCallInit extensions/cs ResourceLoaderGetConfigVars Category:ResourceLoaderGetConfigVars extensions/cs ScribuntoExternalLibraries Category:ScribuntoExternalLibraries extensions/cs SidebarBeforeOutput Category:SidebarBeforeOutput extensions/cs SkinTemplateNavigation::Universal Category:SkinTemplateNavigation::Universal extensions/cs UploadComplete Category:UploadComplete extensions/cs
Poskytované háčky (hooks) CargoSetFormatClasses CargoBeforeStoreData CargoDisplayExportData CargoTablesSetAllowedActions CargoTablesSetActionLinks
Čtvrtletní stahování	70 (Ranked 56^th)
Přeložte rozšíření Cargo
Problémy	Otevřené úkoly · Nahlásit chybu

Wikimore

Extension:Cargo/cs

Instalace

Konfigurace

Související odkazy