$flickr_tag
variables
- $flickr_tag_a
- ...
- $flickr_tag_z
Note: Previous to Version 2.3, this variable was $flickr\_tags_a through z. Starting with Version 2.3, the singualr tag is used to maintain consistency with other similar variable names.
The letters a through z represent up to 26 sets of Flickr photos. Each group is defined by three entries all ending in the same letter.
type
- behavioral
associated template variables
- $_flickr
description
The tag(s) you want to match when requesting your Flickr photos.
To request recent photos, regardless of their tags, use the special value "all-recent" (without the quotes) in the
$flickr_tagsvariable.Separate tags by spaces. The search will be an "or" search. If you enter a tags value of "state fair" Vine Type will retrieve URLs for photos with "state" or "fair" as a tag.
example
$flickr_get_a:4
$flickr_size_a:s
$flickr_tag_a:disneyland
These three values would define a Flickr photo set "a". To display the photos from photo set a on your web page, add the associated template variables.
$_flickr_a_001
$_flickr_a_002
$_flickr_a_003
$_flickr_a_004
notes
Only photos with a Flickr privacy setting of Public will be returned.
If you request more photo URLs than match the tags in your Flickr collection, Vine Type will create template variables for the number of photos in the collection.
The maximum number of URLs to request is 100.
Note: Showing 100 Flickr photos on a single page may violate the Flickr terms that you agreed to when obtaining an API key. Vine Type allows requesting up to 100 URLs to work in conjunction with random variables so that you can show a small random collection of a larger number of photos. The number of photos displayed on your website is controlled in the template file, not in the configuration file.
In order to access your Flickr photos, you will need to also provide these two vinetype.config file entries:
- $flickr_username
- $flickr_api_key
When you obtain an API key from Flickr you agree to terms governing your use of Flickr photos. I recommend that you become familiar with these terms.
You don't have to display all the photos you request. By using Vine Type random numbers, you could display four of the most recent 50 photos. This would display a different set of photos with each page refresh.
four random photos example
Create a Flickr photo set and a random variable in your config file. In this example it is the random_q variable:
$flickr_get_a:50
$flickr_size_a:s
$flickr_tag_a:disneyland
$random_q:50
Then use the random values in the template file like this:
$_flickr_a_$random_q001
$_flickr_a_$random_q002
$_flickr_a_$random_q003
$_flickr_a_$random_q004
Vine Type might display, for example, the following four photos:
$_flickr_a_032
$_flickr_a_008
$_flickr_a_020
$_flickr_a_017
The same photo would never appear twice on the same page because of the way Vine Type random variables work. That is, $random_q001 is always different from $random_q002 and $random_q003 et cetera.