Manual:$wgIllegalFileChars
| File:OOjs UI icon alert-destructive.svg | <translate>
This deprecated feature should no longer be used, but is still available for reasons of backwards compatibility. This feature was deprecated in version <tvar name=ver>1.41.0</tvar>.</translate> |
| <translate> Files and file uploads</translate>: $wgIllegalFileChars | |
|---|---|
| Override the default list of illegal characters in file names. |
|
| <translate> Introduced in version:</translate> | 1.16.0 (r55802) |
| <translate> Deprecated in version:</translate> | 1.41.0 (Gerrit change 942710; git #1552f420) |
| <translate> Removed in version:</translate> | <translate> still in use</translate> |
| <translate> Allowed values:</translate> | (string of characters) |
| <translate> Default value:</translate> | ':\\/\\\\' (1.39+)
":" (1.16-1.27) |
| <translate> Other settings:</translate> <translate> Alphabetical</translate> | <translate> By function</translate> | |
Details
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
- change log for 1.16.0, where this variable was introduced
- $wgLegalTitleChars
