Manual:$wgForeignFileRepos/cs

Podrobnosti


Vlastnosti požadované pro všechna úložiště

 * class
 * Název třídy pro úložiště. Může pocházet z jádra nebo rozšíření. Základní třídy úložiště jsou LocalRepo, ForeignDBRepo, FileRepo a ForeignAPIRepo.


 * name
 * Jedinečný název úložiště.



Pro všechna základní úložiště

 * url
 * Základní veřejná URL


 * thumbUrl
 * Základní adresa URL thumb, pokud se liší od adresy url/thumb


 * hashLevels
 * Počet úrovní adresáře pro rozdělení souborů na základě hash


 * thumbScriptUrl
 * Adresa URL pro thumb.php (volitelné, nedoporučuje se)


 * transformVia404
 * Zda přeskočit transformaci mediálního souboru při analýze a spoléhat se na obslužnou rutinu 404.


 * initialCapital
 * Ekvivalent určuje, zda názvy souborů implicitně začínají velkým písmenem. Současná implementace může poskytovat nesprávné odkazy na stránky s popisem, pokud místní  a initialCapital neodpovídají.


 * pathDisclosureProtection
 * Může být 'paranoid' pro odstranění všech parametrů z chybových zpráv, 'none' pro ponechání cest beze změny nebo 'simple' pro nahrazení cest zástupnými symboly. Výchozí pro LocalRepo je 'simple'. Všimněte si, že některé programy pro vytváření miniatur obrázků vkládají cestu k miniaturám do výsledných metadat, takže toto nastavení nemusí poskytovat plnou ochranu.


 * descBaseUrl
 * URL stránek s popisem obrázků, např.


 * scriptDirUrl
 * Adresa URL instalace MediaWiki, ekvivalentní, např.


 * articleUrl
 * Ekvivalent, např.


 * fetchDescription
 * Načtěte text stránky popisu vzdáleného souboru. Ekvivalent.


 * descriptionCacheExpiry
 * Pokud je nastaveno na 0, nebude se používat žádné ukládání do mezipaměti. Nastavte na 1 nebo více (sekundy), abyste definovali, jak dlouho bude trvat místní mezipaměť stránek s popisem. Chcete-li použít, je nutné nastavit fetchDescription na hodnotu true.



Třída ForeignAPIRepo

 * apibase
 * Základní adresa URL pro rozhraní API vzdáleného úložiště (např. ). Používá se pouze pro ForeignAPIRepo.


 * apiThumbCacheExpiry
 * Jak dlouho ukládat thumbs lokálně do mezipaměti. Nastavení na 0 deaktivuje místní ukládání do mezipaměti. Místní ukládání thumb do mezipaměti sníží zatížení cizího serveru a zlepší soukromí uživatelů. Může to však způsobit, že vaše wiki bude o něco pomalejší.



Třída ForeignDBRepo

 * directory
 * Cesta k mediálnímu adresáři MediaWiki na serveru, například.


 * dbType, dbServer, dbUser, dbPassword, dbName, dbFlags
 * Ekvivalentní odpovídajícímu členu


 * tablePrefix
 * Předpona tabulky, cizí wiki je


 * hasSharedCache
 * True, pokud je sdílená mezipaměť wiki přístupná přes místní


 * favicon
 * Favicon pro vzdálené úložiště

Výchozí hodnota (kód v ):



Třída ForeignDBViaLBRepo

 * wiki
 * wiki-db-name použitý v



Oprávnění k adresáři
Budete potřebovat rw na  a   pro jakéhokoli uživatele, pod kterým php běží.

Použití


Použití souborů z Wikimedia Commons : ForeignAPIRepo
Svou wiki můžete nastavit tak, aby používala média přímo z Wikimedia Commons (nebo z jakékoli jiné stránky s podporou MediaWiki, viz níže). Dejte si však pozor na jakékoli právní důsledky.

Chcete-li to použít, potřebujete:


 * PHP s podporou JSON (pro funkci ). JSON je standardně povolen od PHP 5.2.0, pro starší verze budete potřebovat rozšíření PECL. Od MediaWiki 1.16 to již není nutné. Verze 1.16 použije vlastní (a pomalejší) kód, pokud JSON není k dispozici.
 * Vzdálená wiki musí také používat MediaWiki 1.13 nebo novější. Jinak jeho  vrátí   a požadavky na soubor selžou bezobslužně (tj. požadované soubory jsou prostě považovány za neexistující).
 * Vzdálená wiki musí také používat MediaWiki 1.13 nebo novější. Jinak jeho  vrátí   a požadavky na soubor selžou bezobslužně (tj. požadované soubory jsou prostě považovány za neexistující).

Níže uvedený kód umožňuje na vašem webu mediální soubory z Wikimedia Commons. Měli byste jej umístit do svého souboru "LocalSettings.php":

Chcete-li stáhnout obrázky z jiného projektu Wikimedie, nastavte  na soubor "api.php" této wiki jako např. . Příklad:

Chcete-li do své instalace vložit obrázek, jednoduše použijte.

Výkon
Možná budete muset nakonfigurovat také. Výchozí hodnota je často CACHE_NONE, což znamená, že se načte obrázek ze vzdáleného hostitele při každém načtení stránky, což bude velmi pomalé. Podobně musíte nastavit  na nulu, pokud dáváte přednost použití cizích miniatur, které budou rychlejší.

Nastavení  může zlepšit výkon instant commons za cenu nižší kvality obrázků na displejích s vysokým rozlišením.

V současné době MediaWiki nepodporuje zřetězení cizích žádostí o API. Vysoce výkonný web se může chtít podívat na nastavení místního proxy (jako je nginx), který dokáže sloučit více požadavků do jednoho zřetězeného požadavku, aby se zkrátily časy zpáteční cesty z TCP a TLS handshake.

There is also an alternative implementation at which may be much faster



Použití souborů z databáze, ke které máte přístup: ForeignDBRepo, ForeignDBViaLBRepo
Třída ForeignDBRepo je velmi užitečná pro vytváření wiki rodin. V rodině wiki bude mít každá wiki svou vlastní databázi nebo předponu tabulky. Pomocí této třídy můžete upozornit člena rodiny na tabulky jiného člena rodiny. Přístup přes ForeignDBRepo je rychlejší než přes ForeignAPIRepo. Tento kód by měl být nasazen do LocalSettings.php

Případně, pokud máte nastaveno pro více wikin, můžete použít  :

To nevyžaduje všechny parametry db* jako v.



Použití souborů z místní složky : FileRepo
Svou wiki můžete nastavit tak, aby používala média z jedné složky. Toto je v současnosti pouze demonstrační funkce a pravděpodobně bude příliš pomalá pro vytížené wiki nebo pomalé servery kvůli nedostatku mezipaměti. Tento kód by měl být přidán do LocalSettings.php.

Níže uvedený kód z něj povolil mediální soubory:

Varování
Pro optimální výkon použijte wiki, jejíž primárním účelem je sloužit jako commons jako cíl. Vyhněte se například nasměrování obsahu dvou wiki na sebe jako cizích repozitářů za účelem sdílení souborů mezi nimi, protože to bude generovat nadměrný počet žádostí o soubory při zobrazení stránky a úpravách, protože obě wiki si soubor od sebe navzájem vyžádají.

Podobně se vyhněte sdílení databáze mezi Commons a jinými wikinami s obsahem, zvláště pokud musíte použít  místo   kvůli omezením uloženým vaším poskytovatelem služeb nebo správcem. To generuje velké množství potenciálně dlouhodobých databázových připojení, která mohou mít za následek zhoršení výkonu nebo mohou překročit limity DB připojení i na wikinách s velmi malým provozem nebo aktivitou.



Související odkazy

 * (hlavně pro místní nahrávání)
 * (pro automatické přidání commons do pole úložiště souborů)
 * API pro získání informací o konfiguraci repozitáře, např. https://www.mediawiki.org/w/api.php?action=query&format=json&meta=filerepoinfo
 * Extension:QuickInstantCommons
 * Category:File repository extensions
 * Extension:QuickInstantCommons
 * Category:File repository extensions