Editing Uploading Files

= Uploading Files =

MediaWiki allows users to upload images, documents, and other media files for use within wiki pages. This guide explains how to enable uploads and how to properly insert files into pages.

== Enabling File Uploads (Administrators) ==

If you manage the wiki, make sure uploads are enabled in <code>LocalSettings.php</code>:

<syntaxhighlight lang="php">
$wgEnableUploads = true;
$wgFileExtensions = [ 'png', 'jpg', 'jpeg', 'gif', 'pdf', 'svg', 'webp' ];
$wgMaxUploadSize = 10485760; // 10MB
</syntaxhighlight>

Ensure the <code>/images</code> directory is writable by the web server.

You may also need to allow user permissions:

<syntaxhighlight lang="php">
$wgGroupPermissions['user']['upload'] = true;
$wgGroupPermissions['autoconfirmed']['upload'] = true;
$wgGroupPermissions['user']['reupload'] = true;
$wgGroupPermissions['user']['reupload-own'] = true;
</syntaxhighlight>

== Uploading a File ==

# Log in to your account.
# Navigate to [[Special:Upload]].
# Click '''Choose File'''.
# Enter a destination filename.
# Add a description and licensing information.
# Click '''Upload file'''.

After uploading, the file will be available at:

<code>File:Filename.ext</code>

== Using Uploaded Files in Pages ==

=== Display an Image ===

<syntaxhighlight lang="wiki">
[[File:example.jpg|thumb|300px|Caption here]]
</syntaxhighlight>

=== Display Without Thumbnail ===

<syntaxhighlight lang="wiki">
[[File:example.jpg|300px]]
</syntaxhighlight>

=== Link to a PDF or Document ===

<syntaxhighlight lang="wiki">
[[File:document.pdf]]
</syntaxhighlight>

To create a direct link:

<syntaxhighlight lang="wiki">
[[:File:document.pdf]]
</syntaxhighlight>

== Allowing Additional File Types ==

To allow additional formats:

<syntaxhighlight lang="php">
$wgFileExtensions[] = 'svg';
$wgFileExtensions[] = 'webp';
</syntaxhighlight>

To disable strict file extension checking:

<syntaxhighlight lang="php">
$wgStrictFileExtensions = false;
</syntaxhighlight>

== Troubleshooting ==

{| class="wikitable"
! Problem
! Solution
|-
| Upload option missing
| Ensure <code>$wgEnableUploads = true;</code>
|-
| File type not allowed
| Add the extension to <code>$wgFileExtensions</code>
|-
| Permission denied
| Check folder permissions on the <code>/images</code> directory
|-
| File too large
| Increase <code>$wgMaxUploadSize</code> and PHP <code>upload_max_filesize</code>
|}

== See Also ==

* [[Special:Upload]]
* [[Help:Images]]
* [[Help:Contents]]

[[Category:Help]]