Jump to content

Manual:$wgIllegalFileChars

From mediawiki.org
Files and file uploads: $wgIllegalFileChars
Override the default list of illegal characters in file names.
Introduced in version:1.16.0 (r55802)
Deprecated in version:1.41.0 (Gerrit change 942710; git #1552f420)
Removed in version:Still in use
Allowed values:(string of characters)
Default value:':\\/\\\\' (1.39+)

":\\/\\\\" (1.28-1.38)

":" (1.16-1.27)

Details

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 $wgLegalTitleChars ), except for 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, remove the colon from the value of this variable.

References