Vine Type

$_flickr

variable

• $_flickr_a_nnn
• ...through...
• $_flickr_z_nnn

applicable sections

• html

description

Place this variable at the location in the html element where you want your Flickr photos to appear.

associated vinetype.config variables

• $flickr_get
• $flickr_size
• $flickr_tags

example

$flickr_get_a:4
$flickr_size_a:s
$flickr_tags_a:disneyland

These three vinetype.config entries 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.

• To request recent photos, regardless of their tags, use the special value "all-recent" (without the quotes) in the $flickr_tags variable.

• In order to access your Flickr photos, you will need to also provide these two vinetype.config file entries:

  • $flickr_api_key
  • $flickr_username

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