Manual:$wgIllegalFileChars

From MediaWiki.org
Jump to: navigation, search

Other languages:
English • ‎français • ‎日本語 • ‎polski
Uploads: $wgIllegalFileChars
Override the default list of illegal characters in file names.
Introduced in version: 1.16.0 (r55802)
Removed in version: still in use
Allowed values: string of characters
Default value: ":\\/\\\\"
Other settings: Alphabetical | By function

Details[edit]

Warning Warning: Don't change this unless you know what you're doing!

This is a regex character class (i.e. a list of characters in a format suitable for a regular expression) that you want MediaWiki to convert to dashes ("-") despite being in the list of allowable title characters.

By default, file names can use the same characters as titles (see $wgLegalTitleCharsManual:$wgLegalTitleChars), with the exception of those characters listed in this variable, the default being the colon, slash and backslash. All invalid characters in file names, including those listed in this variable, will automatically be converted to dashes ("-").

The default will not allow namespaces to be part of file names (example: File:Project:filename.txt). While this is generally desirable, it interferes with any extension that uses namespace indexing or protection. To keep the colon from being converted to a dash, set this variable to an empty string.

References[edit]