Manual:$wgForeignFileRepos/fr

Propriétés nécessaires pour tous les dépôts

 * class
 * Nom de classe du dépôt. Peut venir du noyau ou d'une extension. Les classes du dépôt du noyau sont LocalRepo, ForeignDBRepo, FileRepo et ForeignAPIRepo.


 * name
 * Nom unique de répertoire.

Pour tous les dépôts du noyau

 * url
 * URL publique de la base


 * thumbUrl
 * URL des vignettes de la base, si différente de url/thumb


 * hashLevels
 * Nombre de niveaux de répertoires pour les divisions de fichiers basées sur le hachage


 * thumbScriptUrl
 * URL pour thumb.php (optionnel, non recommandé)


 * transformVia404
 * Indique s'il faut sauter la transformation des fichiers média par l'analyseur syntaxique et en remplacement, s'appuyer sur un gestionnaire 404.


 * initialCapital
 * Equivalent à, détermine si les noms de fichiers commencent implicitement par une lettre majuscule. L'implémentation courante peut donner des liens erronnés vers la page de description lorsque le local et initialCapital ne correspondent pas.


 * pathDisclosureProtection
 * Peut être 'paranoid' pour supprimer tous les paramètres dans les messages d'erreur, 'none' pour laisser les chemins inchangés, ou 'simple' pour remplacer les chemins par des jokers. Par défaut, pour LocalRepo la valeur est 'simple'. Notez que certains logiciels de vignette d'image écrivent the chemin de la vignette dans les métadonnées de la vignette générée, donc ce paramètre peut ne pas fournir de protection totale.


 * descBaseUrl
 * URL de la page de description de l'image, par exemple


 * scriptDirUrl
 * URL de l'installation MediaWiki, équivaut à, par exemple :


 * articleUrl
 * Equivaut à, par exemple


 * fetchDescription
 * Va chercher le texte de la page distante de description de fichier. Equivaut à.


 * descriptionCacheExpiry
 * S'il est mis à 0, il n'y a pas de mise en cache. S'il vaut 1 ou plus (en secondes) alors il définit le temps pendant lequel la description des pages reste dans le cache local. Ceci ne fonctionne que lorsque fetchDescription vaut true.

Classe ForeignAPIRepo

 * apibase
 * L'URL de la base pour l'API du dépôt distant (par exemple ). Uniquement utilisé pour ForeignAPIRepo.


 * apiThumbCacheExpiry
 * Durée pendant laquelle les vignettes restent dans le cache local. S'il n'est pas initialisé, ou s'il est mis à 0, alors les vignettes ne sont pas mises dans le cache local

Classe ForeignDBRepo

 * directory
 * Chemin vers un répertoire de médias de MediaWiki, local au serveur, tel que.


 * dbType, dbServer, dbUser, dbPassword, dbName, dbFlags
 * équivaut au membre correspondant de


 * tablePrefix
 * Préfixe de tableau, le du wiki externe


 * hasSharedCache
 * True si le cache partagé du wiki est accessible via le local


 * favicon
 * Une icône favorite pour le dépôt distant

Valeur par défaut (code dans ) :

Classe ForeignDBViaLBRepo

 * wiki
 * wiki-db-name utilisé dans

Droits sur les répertoires
Vous aurez besoin des droits 'rw' sur  et sur   quelque soit l'utilisateur pour lequel PHP s'exécute.

Utiliser les fichiers de Wikimedia Commons : ForeignAPIRepo
You can set your wiki to use media from Wikimedia Commons (or from any other MediaWiki-powered site, see below) directly. However, please beware any legal implications.

Pour utiliser ceci, il faut :


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

Le code ci-dessous vous permet d'avoir des fichiers média de Wikimedia Commons sur votre site. Vous devez le mettre dans votre fichier « LocalSettings.php » :

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

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.

Utiliser les fichiers d'une base de données accessible : 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.

Utiliser les fichiers d'un répertoire local : 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.

Le code ci-dessous permet d'y récupérer les fichiers média :

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.

Voir aussi

 * (principalement pour les téléversements locaux)
 * (pour ajouter automatiquement Commons au tableau des répertoires de fichiers)
 * API for getting information about the configuration of a repo, e.g. https://www.mediawiki.org/w/api.php?action=query&format=json&meta=filerepoinfo
 * (pour ajouter automatiquement Commons au tableau des répertoires de fichiers)
 * API for getting information about the configuration of a repo, e.g. https://www.mediawiki.org/w/api.php?action=query&format=json&meta=filerepoinfo