MediaWiki extensions manual

Attachments Release status: stableCategory:Stable extensions
Implementation	Parser function Category:Parser function extensions, Variable Category:Variable extensions, Page action Category:Page action extensions, Hook Category:Hook extensions
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.Category:Extensions with release branches compatibility policy
MediaWiki	1.39+Category:Extensions with manual MediaWiki version
License	MIT License
Download	GitHub: project page git repository URL [help ] commit history Note: No localisation updates are provided by translatewiki.net . Category:Extensions in GitHub version control
Example	https://vowi.fsinf.at/
Parameters $wgAttachmentsNamespaces $wgAttachmentsChunkListByLetter $wgAttachmentsShowSubpageForm $wgAttachmentsShowLinkForm $wgAttachmentsShowInNamespaces $wgAttachmentsShowInViews $wgAttachmentsShowEmptySection
Hooks used ParserFirstCallInit Category:ParserFirstCallInit extensions BeforePageDisplay Category:BeforePageDisplay extensions MagicWordwgVariableIDs Category:MagicWordwgVariableIDs extensions ParserGetVariableValueSwitch Category:ParserGetVariableValueSwitch extensions SkinTemplateNavigation::Universal Category:SkinTemplateNavigation::Universal extensions ListDefinedTags Category:ListDefinedTags extensions ChangeTagsListActive Category:ChangeTagsListActive extensions
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 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 descripiton.
• 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.

Installation

Tips

• 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.

Credits

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:

• attachments are stored in page_props instead of pagelinks
• no open redirects, just links
• attachments are shown at the end of pages, as opposed to on a special page

Originally developed and maintained by Gittenburg.

See also

• MoinMoinWiki - supports attachments out of the box.