Manual:$wgForeignFileRepos/hu

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 -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 é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.

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 -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.

A Wikimédia Commons fájljainak használata: ForeignAPIRepo

 * Az 1.16.0 verzió óta egy kényelmesebb módszer is rendelkezésre áll a Commons külső tárhelyként való használatára, a .

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.

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.

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.

Alternatively, if you have set up for multiple wikis, you can use  :

This needs not all the db* parameters as in.

Using files from a local folder : FileRepo
You can set your wiki to use media from a single folder. This is just a demonstration feature at present, and will probably be too slow for busy wikis or slow servers due to the lack of caching. This code should be added to LocalSettings.php.

The below code enabled media files from it:

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.