Extension:FlickrAPI
This extension is currently not actively maintained! Although it may still work, any bug reports or feature requests will more than likely be ignored. If you are interested in taking on the task of developing and maintaining this extension, you can request repository ownership. As a courtesy, you may want to contact the author. You should also remove this template and list yourself as maintaining the extension in the page's {{extension}} infobox. Please see the following alternatives that you may wish to install instead of this extension: |
![]() Release status: unmaintained |
|
---|---|
Implementation | Tag |
Description | Embeds Flickr images |
Author(s) | Ike Hecht (Tosfostalk) |
Latest version | 2.0.2 (July 2021) |
Compatibility policy | For every MediaWiki release that is a Long Term Support release there is a corresponding branch in the extension. |
MediaWiki | 1.35 |
Database changes | No |
License | GNU General Public License 2.0 or later |
Download | |
|
|
Quarterly downloads | 3 (Ranked 175th) |
Translate the FlickrAPI extension if it is available at translatewiki.net | |
Issues | Open tasks · Report a bug |
The FlickrAPI allows you to embed Flickr images into your wiki. It is intended as a replacement for Extension:Flickr and is mostly backwards-compatible, but note that the configuration variables have changed. It uses the phpFlickr library.
This extension was created for WikiWorks.
InstallationEdit
- Download and place the file(s) in a directory called
FlickrAPI
in yourextensions/
folder. - Only when installing from Git, run Composer to install PHP dependencies, by issuing
composer install --no-dev
in the extension directory. (See task T173141 for potential complications.) - Add the following code at the bottom of your
LocalSettings.php
:wfLoadExtension( 'FlickrAPI' ); $wgFlickrAPIKey = ' /*FLICKR API KEY HERE*/ ';
- Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
Note: You'll need an API key from Flickr. Get it here.
So, after installation from git, add the line "extensions/FlickrAPI/composer.json"
to the "composer.local.json" file in the root directory of your wiki like e.g.
{
"extra": {
"merge-plugin": {
"include": [
"extensions/FlickrAPI/composer.json"
]
}
}
}
Now run composer update --no-dev
from the top level of your MediaWiki installation.
ConfigurationEdit
- $wgFlickrAPIKey - Required. Your Flickr API key goes here.
- $wgFlickrAPISecret - The API secret from Flickr. This is optional and right now it probably doesn't do anything.
- $wgFlickrAPIDefaults - Array that contains the default values for the extension for when the
<flickr>
call does not specify certain options. Defaults to:[ 'type' => 'frameless', 'location' => 'right', 'size' => '-' ];
UsageEdit
Embed a Flickr image using the tag: <flickr>id|type|location|size|caption</flickr>
The only mandatory parameter is id. The others can be omitted and the defaults will be applied from $wgFlickrAPIDefaults
.
- id
- The Flickr ID of this photo.
- type
- The display type. This can be set to:
thumb
,frame
orframeless
. - location
- The horizontal alignment. This can be set to:
right
,left
,center
ornone
. - size
- The size to use for the image. This can be set to:
s
,t
,m
,-
orb
. See this page for more info. - caption
- The caption to display for the image. If omitted, the default caption will be the photo's title in Flickr. Note that no caption is ever displayed if type is set to
frameless
.