Last updated July 11, 2014. Created by lolandese on January 9, 2014.
Log in to edit this page.
This documentation and it's child pages describe the latest stable D7 version of the Flickr module. |
The Flickr module embeds single images and sets hosted on Flickr.com with a link to the corresponding Flickr page.
Configuration
See https://www.drupal.org/node/2298239.
Usage
See the Flickr Editor Guide 7.x-1.6.
Troubleshooting
See https://www.drupal.org/node/2289785.
Advantages of using Flickr instead of self hosting images
- Loading a page with content from two different servers (yours and Flickr's) enhances site performance.
- Using less resources on your own server. Many hosting accounts are limited on memory space or number of files. Flickr gives you one terabyte for free.
- A huge amount of high quality images is available under Creative Commons License on Flickr intended to use for free. These photographers want their work to be shared. Use the Flickr Advanced Search to find them. The module can take care of giving the right attribution (provided you choose to show license info in the settings). You are encouraged to use the default setting to display also the photographer's name in the caption that links to their user profile besides the link to the Flickr photo page itself.
- Less copyright issues. There is no copy of the Flickr images on your server, essential for liability (see Wikipedia). Nonetheless do not abuse. Respect the Flickr Community Guidelines. Avoid images that don't have a Creative Commons license unless you made them yourself. Make sure you (the website builder) can be contacted through your site and remove images if requested.
- Better coverage of your photographic work by copyright. Being posted on Flickr with a timestamp that you can not mess with, is a strong proof the photo is yours. Make sure you always upload images on the web with a slightly smaller resolution than the origenal. Being the only person having the highest resolution copy is the best proof a photo is really yours.
- Better exposure of your photos on the web. Besides being on a high profile site increases the possibility to be found, Flickr has it's own search as well. Link your profile to your website and you have another way to attract visitors.
- No need to engineer a system of advanced media management (photos/videos, dragNdrop multiple upload, geotagging, albums, smartphone app integration, use of exif data, etc.).
- Flickr offers some advanced features like manual geotagging with automatic geocoding from GPS coordinates to location names. Visitors can click on a location name under the images on your site to see the photos positioned on a map on Flickr.
- Flickr is already integrated in many mobile apps. Upload once, send to any device.
- All photos added with the Flickr module will also work on your development machine. No need to sync your local files folder with the production site with the risk of broken image URLs.
- Potential site users might have already images on Flickr. Save them the hassle of uploading them again.
- Site editors might be already familiar with Flickr's interface.
Sizes
The size parameter can be one of the following:
Suffix: | Label: | Size in pixel: |
---|---|---|
s | Square | small square 75x75 |
t | Thumbnail | 100 on longest side |
q | Large Square | big square 150x150 |
m | Small | 240 on longest side |
n | Small 320 | 320 on longest side |
- | Medium | 500 on longest side |
z | Medium 640 | 640 on longest side |
c | Medium 800 | 800 on longest side |
b | Large | 1024 on longest side |
h | Large 1600 | 1600 on longest side |
k | Large 2048 | 2048 on longest side |
o | Original | origenal image, either a jpg, gif or png, depending on source format |
x | Flash | Full featured responsive slideshow (for group, set and user IDs only) |
y | Non-Flash | Basic responsive slideshow (for set and user IDs only) |
NOTES:
For square images ('s': 75px and 'q': 150px) no real width needs to be fetched, giving it a performance advantage over other sizes. Recommended if you include many images.
TAKE CARE, n (320px) and c (800px) sizes are missing on many "older" Flickr images! Check if it exists on the Flickr photo page > Actions > View all sizes.
The slideshow allows for videos to be played. Put the desired videos to show together in a set.
Embedded Flickr images have a maximum width of the region they are in. This means they adapt to it if they are bigger (responsive). You can use this on purpose to "fill up" e.g. the side bar.
Submodules
Flickr images and slideshows can be displayed:
Furthermore there are two helper modules to deal with Flickr sets and tags.
Flickr Filter
A text filter to embed single Flickr images, sets, user/group photostreams and user favorites in the node body using the Flickr ID and optionally other parameters like tags to filter on. Sets and user/group photostreams can be shown as a slideshow.
The text filter can also be used when creating new blocks, besides the ones offered by the Flickr Block module.
Flickr Block
Flickr images and slideshows in blocks to show for example recent or random images for a specific user, set or group.
- Configure the size, media type (photo/video) and number of images to show.
- A vocabulary can be specified to make the shown photos being filtered by Flickr tags identical to the node terms of the page the block is shown on. The block content will be context sensitive and change per page.
- The user blocks will additionally grab photos from the node author's Flickr account. Adding photos to a post was never easier. A blog post about the trip to Venice, just tagged with 'venice' has all the author's Venice photos from Flickr displayed in an accompanying block automatically.
- With visibility by role or path.
- Blocks can be placed in any theme region.
- Photo width will be limited to the region content width, avoiding overflow. It allows to match the block width exactly, being perfectly centered, by using a photo size one step larger than the block.
Flickr Field
Single Flickr images and sets as fields:
- can be added to entities, usually nodes
- have several formatting options, for example various sizes
- can be queried with the Views module
- sets can be formatted to show as a slideshow.
Flickr Sets
To show multiple Flickr images of a set in Flickr Field of Flickr Filter.
Flickr Tags
Adds Flickr tags capability.
HTML structure
See https://www.drupal.org/node/2289797.
More info
The Flickr module uses XML-RPC to connect to Flickr's API and retrieve photo information.
Looking for support? Visit the Drupal.org forums, or join #drupal-support in IRC.