InstantCommons/da
InstantCommons er en MediaWiki-funktion som muliggør brugen af uploadede mediefiler fra Wikimedia Commons til valgfri MediaWiki-installationer verden over.
Begrundelse
Fra november 2023, Wikimedia Commons, det centrale medie lager gemt af Wikimedia Foundation indeholder over 100 millioner filer. Hver af disse filer er tilgængelige under en fri indholdslicens eller i offentlighedens domæne; der er ingen andre begrænsninger i brug end dem, en brugen af officielle emblemer eller varemærker. Licenser, der begrænser den kommercielle anvendelse, anses for ikke-frie.
I takt med at kendskabet til Commons vokser, vokser også ønsket fra eksterne parter om at bruge indholdet deri og bidrage med nyt materiale. Det er i øjeblikket teknisk muligt at hente billeder direkte fra Wikimedia's servere i forbindelse med enhver webside. Sådanne hotlink er tilladt, men det er problematisk af flere årsager:
- Det respekterer ikke licensvilkårene for billedet og tillader ikke pålidelig transport af andre metadata
- Udover at det ikke give ordentlig kreditering til forfatteren af medie-filen, krediterer det heller ikke Wikimedia
- Den bruger Wikimedia-båndbredde på hver sidevisning (medmindre billedet er cachéet på brugerens side eller via en proxy; denne funktion er i øjeblikket deaktiveret som standard)
- Den letter ikke brugbare billedoperationer som miniatørgenerering og underskrift og er svær at bruge i forbindelse med en wiki, især for standard layoutoperationer
- Det er bundet til URL'er som ressourceidentifikatorer, hvilket komplicerer spejlning
- Det skaber et ikke-sporbart eksternt brugsweb, hvor enhver ændring på Wikimedia's side nødvendigvis påvirker disse eksterne brugere
- Det tillader ikke offline-visning, hvilket er afgørende i lande, der kun har begrænset nettilgang.
InstantCommons søger at løse dette ved at give en nem metode til (cached) hentning af billeder og metadata fra Wikimedia's servere. Selvom cache-funktionalitet er en målsætning, er det blevet deaktiveret siden MediaWiki 1.27.2/1.28.1. InstantCommons blev først implementeret for MediaWiki med mulighed for at udføre alle MediaWiki-billedoperationer (miniaturvisning, underskrift, gallerier osv.) transparent. Andre wiki-generatorer kan implementere InstantCommons-lignende funktionalitet ved hjælp af API-operationerne beskrevet nedenfor.
Basale krav
Under installationen kan websitetadministratoren vælge, om InstantCommons skal aktiveres. Ideelt set bør funktionen dog være aktiveret som standard (når opdateringsbiblioteket er skrivbart) for at tillade det største mulige antal brugere at bruge Wikimedia Commons-indhold.
Hvis funktionen er aktiveret, opfører wikien sig som et Wikimedia-projekt, dvs. hvis et billede eller en anden mediefil henvises til, som findes på Commons, kan det inkluderes i en wiki side som en lokalt uploadet fil ved at angive dets navn. Lokale filnavne har forrang over Commons filnavne.
Konfiguration
Standardmetode: $wgUseInstantCommons
For at aktivere InstantCommons i MediaWiki version 1.16 eller nyere, er det nok at tilføje denne linje til din $ 1 (se $ 2 for detaljer):
$wgUseInstantCommons = true;
Classic InstantCommons with local thumb caching
Default InstantCommons as enabled through $wgUseInstantCommons uses thumb images hotlinked from Wikimedia.[1]
This may be slow and may also interfere with file caching (broken links).
If you would like to generate and use thumbs on your local server, do not use $wgUseInstantCommons.
Instead, insert this code into LocalSettings.php as described here: Manual:$wgForeignFileRepos#Usage.
$wgForeignFileRepos[] = [
'class' => ForeignAPIRepo::class,
'name' => 'commonswiki', // Must be a distinct name
'apibase' => 'https://commons.wikimedia.org/w/api.php',
'hashLevels' => 2,
'fetchDescription' => true, // Optional
'descriptionCacheExpiry' => 43200, // 12 hours, optional (values are seconds)
'apiThumbCacheExpiry' => 86400, // 24 hours, optional, but required for local thumb caching
];
Using files via InstantCommons
With InstantCommons enabled, you can choose any image from Wikimedia Commons (e.g. this one), click the "Use this file" button (the button with the wiki icon 
next to) and paste the markup in your wiki.
In our example, pasting
[[File:Wikipedia-Marker-commons.svg|thumb|A picture from Wikimedia Commons embedded in this Wiki]]
will render the thumbnail (as can be seen on the right side of this page).
Note that when using files in this way you will still need to respect any licensing and other file use legal requirements - see Commons:Reusing content outside Wikimedia.
Troubleshooting
Common thumbnail sizes
Since early 2026, Wikimedia image servers prefer to generate thumbnail images with predefined widths.
The rate limiting applied to sizes outside of the predefined widths is quite strict.
The Common thumbnail sizes can be used along with $wgThumbnailSteps to limit the image sizes used in the <img> HTML tags generated by MediaWiki.
When active these settings make your MediaWiki emit HTML that puts whatever width and height attribute is appropriate on generated <img> tags while also selecting the exact match or next largest width from the step sizes for the image requested from upload.wikimedia.org.
Adding $wgThumbnailSteps = [20, 40, 60, 120, 250, 330, 500, 960, 1280, 1920, 3840]; and $wgThumbnailStepsRatio = 1; in your LocalSettings.php will make your MediaWiki match the expected sizes.
User-Agent Policy
Since late 2025, Wikimedia Commons may categorize API requests from your server as unidentified and throttle or block its requests. This is due to enforcement of the Wikimedia Foundation User-Agent Policy and protects against increases in automated scraping.
Prior to MediaWiki 1.45, the User-Agent header in InstantCommons did not include a source URL, as required by the policy. If you encounter a rate limit message when using InstantCommons, please upgrade to MediaWiki 1.45.0 (or MediaWiki 1.39.14+, 1.43.4+, or 1.44.1+) which sets a compliant header that includes the wiki's server URL. High traffic wikis may additionally need to follow Bot traffic requirements by verifying the server's IP range.
HTTPS
Since June 2015, Wikimedia Commons can only be accessed using HTTPS. Some installs may be missing their root certificate store which prevents MediaWiki from contacting Commons over HTTPS. If InstantCommons stopped working, try:
- Installing the php curl extension. (It is generally more reliable, and more likely to have proper certificates already installed.) On Debian/Ubuntu:
sudo apt-get install php-curl
- Verifying you have an up-to-date certificate store. If you have the php curl extension installed, follow the instructions on webaware or Talk:InstantCommons#Stop_working.
- Make sure the PHP function
curl_exec()is not disabled in your web server.
SElinux
If your server OS implements SElinux, please take a look at the dedicated section on the SELinux settings page, and make sure HTTPD scripts and modules can access the network successfully. If SElinux prevents HTTPD scripts and modules from connecting to Wikimedia Commons repository, the InstantCommons feature will simply not work.
Behind a firewall
If the server on which the wiki runs is behind a firewall, the wiki server must be granted outgoing http/https requests to commons.wikimedia.org and upload.wikimedia.org, for Instant Commons to work. The IP address ranges are found at wikitech:IP addresses.
If you need to use a proxy to access the internet from behind the firewall, see $wgHTTPProxy.
See also
- Manual:$wgForeignFileRepos – for the same functionality as InstantCommons but with other wikis
- PhotoCommons – WordPress plug-in to provide the same functionality
- Examples of sites which are using InstantCommons
- Extension:QuickInstantCommons