Jump to content

Kézikönyv:$wgFileExtensions

From mediawiki.org
This page is a translated version of the page Manual:$wgFileExtensions and the translation is 62% complete.
Outdated translations are marked like this.
Files and file uploads: $wgFileExtensions
A feltöltéskor preferált kiterjesztések listája. A listán nem szereplő kiterjesztésekkel rendelkező fájlok feltöltésekor figyelmeztetés jelenik meg.
Bevezetve:1.2.0
Eltávolítva:használatban
Megengedett értékek:(sztringek tömbje)
Alapértelmezett érték:see below

Részletek

A $wgFileExtensions-ban szereplő $wgFileExtensions listázza az engedélyezett/preferált kiterjesztéseket. A beállítást a $FileBlacklist és a $MimeTypeBlacklist felülírja.

Ha a $StrictFileExtensions „true” értékű (alapértelmezés), akkor a $wgFileExtensions tömb az engedélyezett fájlokat listázza; minden más kiterjesztés feltöltése tiltott.

Ha a $StrictFileExtensions „false” értékű, akkor a listában nem szereplő kiterjesztésű fájlok feltöltésekor figyelmeztetés fog megjelenni. például a $wgFileExtensions ekkor csak a kiterjeszétsek „preferált” listáját tartalmazza. Ebben az esetben a $wgFileBlacklist és a $wgMimeTypeBlacklist használatával néhány különösen veszélyes fájltípus továbbra is blokkolva lesz.

Ha a $CheckFileExtensions „false” értékű, ennek a beállításnak nincs hatása, mivel ekkor minden kiterjesztés feltölthető bármiféle ellenőrzés nélkül.

Ha az $EnableUploads „false”, a beállításnak szintén nincs hatása, mivel ekkor a feltöltés le van tiltva.

Néhány esetben (például az OpenOffice.org által használt OpenDocument-fájlok (odt, ods, odg stb.) esetén) a MIME-típus és a kiterjesztés nem egyezik (vagy valami hasonló). Az ilyen fájlok feltöltésekor a következő figyelmeztetés jelenik meg: A fájl sérült vagy helytelen kiterjesztésű. Ellenőrizd a fájlt és töltsd fel újra. Ebben az esetben a MIME-típus validációjával egyes kiterjesztéseket MIME-típusokhoz rendelhetsz hozzá.

Default values

MediaWiki-verzió:
1.27
$wgFileExtensions = [ 'png', 'gif', 'jpg', 'jpeg', 'webp', ];
MediaWiki-verziók:
1.3 – 1.26
$wgFileExtensions = array( 'png', 'gif', 'jpg', 'jpeg' );
MediaWiki-verzió:
1.2
$wgFileExtensions = array( "png", "jpg", "jpeg", "ogg" );

Példa

A $wgFileExtensions egy PHP-tömb, amelyet kiterjesztések egy alapértelmezett (érzékeny) listája inicializál. A LocalSettings.php-ban használhatsz tömbműveleteket, például:

// Csak egy fájltípust ad hozzá az alapértelmezett tömbhöz
$wgFileExtensions[] = 'pdf';

// Több fájltípust is hozzáad az alapértelmezett tömbhöz
$wgFileExtensions = array_merge(
    $wgFileExtensions, [
        'pdf', 'ppt', 'jp2', 'doc', 'docx', 'xls', 'xlsx'
    ]
);

// Az alapértelmezést a következő fájltípusokkal írja felül:
// This is usually not a good idea because newer important file extensions could be added in the defaults in later versions of MediaWiki.
$wgFileExtensions = [
    'png', 'gif', 'jpg', 'jpeg', 'jp2', 'webp', 'ppt', 'pdf', 'psd',
    'mp3', 'xls', 'xlsx', 'swf', 'doc', 'docx', 'odt', 'odc', 'odp',
    'odg', 'mpp', 'pptx'
];

Lásd még