Manual:$wgForeignFileRepos/hu

Részletek


Minden tárhelyhez szükséges tulajdonságok

 * class
 * A tárhely osztályneve; a szoftver vagy egy kiterjesztés határozza meg. Az alapértelmezett osztálynevek: LocalRepo, ForeignDBRepo, FileRepo és ForeignAPIRepo.


 * name
 * A tárhely egyedi neve.



Minden alapértelmezett tárhelyhez

 * url
 * Nyilvános gyökér URL


 * thumbUrl
 * Bélyegképek gyökér URL-je, ha az URL/thumbtól eltér


 * hashLevels
 * A fájlok hash-sel számított elosztásához tartozó könyvtárak szintjeinek száma


 * thumbScriptUrl
 * A thum.php URL-je (opcionális, nem ajánlott)


 * transformVia404
 * A média-átalakítás kihagyása értelmezés során, és helyette HTTP 404-es hibakezelő használata.


 * initialCapital
 * Megegyezik a $wgc-szel; meghatározza, hogy a fájlneveknek nagybetűvel kell-e kezdődniük. A jelenlegi implementációban a leírólapokon problémákat okozhat, ha a $wgc és az initialCapital nem egyezik.


 * pathDisclosureProtection
 * Értékei: 'paranoid' – minden paraméter törlése a hibaüzenetekből; 'none' – az útvonalak változatlanul hagyása; 'simple' – az útvonalak felülírása helykitöltőkkel. A LocalRepo alapértelmezése a 'simple'. Megjegyzés: egyes bélyegkép-létrehozó szoftverek a fájl útvonalát a létrejött állomány metaadataiban rögzítik, így ezen beállítás lehet, hogy nem biztosít kellő védelmet.


 * descBaseUrl
 * A kép-leírólapok URL-je, például


 * scriptDirUrl
 * A MediaWiki-telepítés URL-je; a -szel megegyezik, például:


 * articleUrl
 * A -szel megegyezik, például:


 * fetchDescription
 * A távoli leírólap szövegét importálja; megegyezik a -szel.


 * descriptionCacheExpiry
 * 0 érték esetén a gyorsítótárazás le lesz tiltva. 1-nél magasabb érték (másodpercben) megadja a leírólapok gyorsítótárának tárolási idejét. Működéséhez a fetchDescription „true” értéke szükséges.



ForeignAPIRepo-osztályok

 * apibase
 * A távoli tárhely API-jának gyökér URL-je (például ). Csak a ForeignAPIRepo által használt.


 * apiThumbCacheExpiry
 * A bélyegképek helyi gyorsítótárazásának hossza. Üresen hagyása vagy 0 értéke letiltja a bélyegképek helyi gyorsítótárazását. Local thumb caching will reduce load on the foreign server, and improve user privacy. However it may cause your wiki to be slightly slower.



ForeignDBRepo-osztályok

 * directory
 * A MediaWiki médiakönyvtárának helyi útvonala a szerveren, például.


 * dbType, dbServer, dbUser, dbPassword, dbName, dbFlags
 * megegyezik a vonatkozó tagjával.


 * tablePrefix
 * Táblaelőtag, a külső wiki -e.


 * hasSharedCache
 * Értéke legyen „true”, ha a wiki megosztott gyorsítótára a helyi $wgMemc-en át elérhető.


 * favicon
 * A távoli tárhely faviconja.

Alapértelmezett érték (az -ban rögzítve):



ForeignDBViaLBRepo-osztályok

 * wiki
 * a wiki adatbázisának által használt neve



Könyvtár-jogosultságok
A PHP által használt felhasználónak 'rw' jogosultság szükséges az  és   könyvtárak esetében.

Használat


A Wikimédia Commons fájljainak használata: ForeignAPIRepo
A beállítással a wiki a Wikimédia Commonsról, vagy bármely más MediaWiki-oldalról (lásd alább) használhat fájlokat, azonban vedd figyelembe a jogi szabályokat.

Használatához a következő szükséges:


 * PHP JSON-támogatással (a  funkcióhoz). A JSON a PHP 5.2.0 óta alapértelmezésben engedélyezve van; régebbi verziók esetén a PECL kiterjesztést kell beszerezned. A MediaWiki 1.16 óta erre nincs szükség; ha nem elérhető a JSON, a szoftver egy egyéni (és lassabb) megoldást fog alkalmazni.
 * A távoli wikin legalább a MediaWiki 1.13 megléte szükséges, máskülönben annak  állománya   hibaüzenetet fog visszaküldeni, és a fájlkérések csendben sikertelenek lesznek (például a kért állományok nemlétezőként lesznek kezelve).
 * A távoli wikin legalább a MediaWiki 1.13 megléte szükséges, máskülönben annak  állománya   hibaüzenetet fog visszaküldeni, és a fájlkérések csendben sikertelenek lesznek (például a kért állományok nemlétezőként lesznek kezelve).

Az alábbi kód engedélyezi a Wikimédia Commonsról származó fájlok használatát; a részletet a LocalSettings.php-ba kell másolnod:

Más Wikimédia-projektről származó képek megjelenítéséhez az  értékének a forráswiki api.php-jére kell mutatnia, például:. Példa.

Képek beágyazásához használd a  kódot.

Performance
A működéshez szükséges lehet még a konfigurálása is. Ennek alapértelmezett értéke CACHE_NONE, ezáltal a távoli képet minden laplekéréskor tölti le. Ugyanígy, a távoli bélyegképek használatához az  értéke legyen 0.

Setting  may improve performance of instant commons at the cost of making images be lower quality on high resolution displays.

Currently MediaWiki does not support pipelining foreign api requests. A high performance site may want to look at setting up a local proxy (like nginx) that can coalesce multiple requests into a single pipelined request to reduce round trip times from TCP & TLS handshakes.

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



Fájlok használata egy általad hozzáférhető adatbázisból: ForeignDBRepo, ForeignDBViaLBRepo
A ForeignDBRepo wikicsaládok létrehozásakor hasznos, mely esetben minden wikinek saját adatbázis-előtagja van. Az osztály használatával egy wiki felismerheti a családtagjának tábláit. A ForeignDBRepón át történő hozzáférés a ForeignAPIRepónál gyorsabb; beállítása a LocalSettings.php-ban szükséges.

Alternatív megoldásként a több wikihez való beállítása esetén használhatod a  -t:

Ehhez nem szükséges a  összes db* paramétere.



Fájlok használata helyi könyvtárból: FileRepo
A wikidet egy könyvtárból való fájlhasználathoz is konfigurálhatod; ez csak bemutatási célokat szolgál, és nagyobb wikik vagy lassú szerverek esetén a gyorsítótárazás hiánya miatt teljesítménybeli problémákat okozhat. Az engedélyezéshez másold be az alábbi kódot a LocalSettings.php-ba:

Az alábbi kód engedélyezi az onnan származó médiafájlok felhasználását:

Caveats
For optimal performance, use a wiki whose primary purpose is to serve as a commons as the target of. Avoid, for instance, pointing two content wikis at each other as foreign repositories in order to share files between them, because this will generate an excessive number of file requests on page views and edits as both wikis request the file from each other.

Likewise, avoid sharing a database between the commons wiki and other content wikis, especially if you must use  instead of   due to limitations imposed by your service provider or administrator. This generates a large number of potentially long-lived database connections that can result in impaired performance, or can exceed DB connection limits even on wikis with very little traffic or activity.



Lásd még

 * (főleg helyi feltöltésekhez)
 * (a Commons automatikus hozzáadása a tárhelyek tömbjéhez)
 * – a tárhelyek konfigurációjának lekérdezése, például: 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