Extension:Attachments

**MediaWiki extensions manual**
Attachments; Release status: stable
Implementation	Parser function, Variable, Page action, Hook
Description	Attach subpages, files and external links to pages.
Author(s)	Gittenburg; Wryck; Vuhuy (Shibe90);
Latest version	1.0.1
Compatibility policy	Snapshots releases along with MediaWiki. Master is not backward compatible.
MediaWiki	1.39+
License	MIT License
Download	GitHub: project page; git repository URL [help]; commit history; ; Note:; No localisation updates are; provided by translatewiki.net.
Example	https://vowi.fsinf.at/
	Parameters $wgAttachmentsNamespaces; $wgAttachmentsChunkListByLetter; $wgAttachmentsShowSubpageForm; $wgAttachmentsShowLinkForm; $wgAttachmentsShowInNamespaces; $wgAttachmentsShowInViews; $wgAttachmentsShowEmptySection;
	Hooks used ParserFirstCallInit; BeforePageDisplay; MagicWordwgVariableIDs; ParserGetVariableValueSwitch; SkinTemplateNavigation::Universal; ListDefinedTags; ChangeTagsListActive;
	Hooks provided BeforeSortAttachments;

The Attachments extension lets users attach subpages, files and external links to pages in enabled namespaces.

Attachments can easily be added through the user interface.
Attachments of an article are displayed in an automatically generated list at its end.
This extension integrates with the Vector and Minerva Neue skins.

So how does it work?

subpages automatically count as attached to their parent page
When you upload a file through the Attach page action, a parser function {{#attach: Title}} is added to the description.
When you add a link, the extension creates a subpage containing the {{#exturl: URL}} parser function.
Both parser functions set page properties , which are queried for the autogenerated sections.

Advanced features

#attach can also be used to attach a regular page to another regular page.
You can exclude subpages starting with a specific prefix from the autoindex with {{#attachments ignore subpages: prefix}} on the parent page.
You can access attachments before they are sorted with the BeforeSortAttachments(&$links) hook, where links is an associative array mapping string keys to HTML links. Return false to take over the sorting.

The Attachments extension provides the {{FILEPREFIX}} parser function to faciliate linking/embedding attached files.

If you attach an image Example.jpg to Somepage then you can embed the image:

from Somepage with [[File:{{FILEPREFIX}}Example.jpg]]
from Somepage/Subpage with [[File:{{FILEPREFIX:..}}Example.jpg]]
from Somepage/Subpage/Subsubpage with [[File:{{FILEPREFIX:../..}}Example.jpg]]

Note that the same also works with [[Media:...]] links.

Enable Uploads .
Developers can clone the extension into your MediaWiki extensions directory:
```
cd extensions/
git clone https://github.com/vuhuy/Swiki
```
Note that you should also enable subpages for these namespaces.

Name	Type	Description	Default
`$wgAttachmentsChunkListByLetter`	Boolean	Whether or not the attachment list should be chunked by the first letter of list items.	`true`
`$wgAttachmentsShowSubpageForm`	Boolean	Whether or not the subpage form should be shown.	`true`
`$wgAttachmentsShowLinkForm`	Boolean	Whether or not the external link form should be shown.	`true`
`$wgAttachmentsShowInNamespaces`	Boolean	Whether or not a link to the attachments should be shown in the namespaces (page, discussion).	`false`
`$wgAttachmentsShowInViews`	Boolean	Whether or not an 'add attachments' link should be shown in the views (read, edit source, view history).	`false`
`$wgAttachmentsShowEmptySection`	Boolean	Whether or not to show certain elements when there are no attachments for a page.	`false`

Enable $wgCountCategorizedImagesAsUsed to exclude attached files from Special:UnusedImages.
Attachments and external URLs are both stored as page props, meaning they can be queried with API:Pageprops and API:Pageswithprop .
Set $wgForeignUploadTargets to [], if you want to prevent users from circumventing this extension through the upload dialog.
If new attachments do not show up, it might be because you have many jobs in your job queue.

This extension is essentially a complete rewrite of PerPageResources by Mathias Ertl, which consists of Extension:Resources, Extension:AddResource and Extension:ExternalRedirects. This extension replaces all three, notable differences are:

Originally developed and maintained by Gittenburg.