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 with JSON support (for the  function). JSON is enabled by default since PHP 5.2.0, you'll need the PECL extension for older versions. Since MediaWiki 1.16, this is no longer necessary; v. 1.16 will use custom (and slower) code if JSON is not available.
 * The remote wiki must also use MediaWiki 1.13 or later; otherwise its  returns   and file requests fail silently (i.e. the requested files are just treated as non-existent).
 * The remote wiki must also use MediaWiki 1.13 or later; otherwise its  returns   and file requests fail silently (i.e. the requested files are just treated as non-existent).

The code below enables media files from Wikimedia Commons on your site. You should place it in you "LocalSettings.php" file:

To pull images from another Wikimedia project, set  to this wiki's "api.php" file like e.g.  . Example:

To embed an image in your installation, simply use.

You may need to configure the as well. Default it is set to CACHE_NONE, meaning it will load the image from the remote host on each page load. Similarly, you need to set  to zero if you prefer to use the foreign thumbnails.

Using files from a database that you can access : ForeignDBRepo, ForeignDBViaLBRepo
The ForeignDBRepo class is very useful for creating wiki families.. In a wiki family, each wiki will have its own database or table prefix. Using this class, you can make a family member aware of the tables of another family member. Access through ForeignDBRepo is faster than through ForeignAPIRepo. This code should be deployed to LocalSettings.php.

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.