You are here

Home » API reference » Flickr 7

README.txt in Flickr 7

Same filename in this branch
  1. 7 README.txt
  2. 7 filter/README.txt
  3. 7 block/README.txt
  4. 7 sets/README.txt
  5. 7 field/README.txt
  6. 7 cachewarmer/README.txt
  7. 7 feeds/README.txt
  8. 7 style/README.txt
  9. 7 tags/README.txt
Same filename and directory in other branches
  1. 6 field/README.txt
The content of this file is based on the online documentation that can be found
at https://drupal.org/node/2171299
It is recommended to read it there, as it is more detailed and illustrated.

NAME
====
Flickr Field
Part of the Flickr module. Project page at https://drupal.org/project/flickr

OVERVIEW
========
Add Flickr images or sets to content as fields:
- can be added to entities, usually nodes
- have several formatting options to use various sizes, including slideshows
- can be queried with the Views module.

There are two kind of module provided Flickr fields. Only the first type is used
for single Flickr photos. Both type of fields can be used for Flickr Photo Sets
but each in a different way.

Flickr Photo
------------
Store Flickr Photo or Photoset IDs and display the photos in nodes and Views.
Despite the name this field is used both for individual photos (using
'Item Type': 'Photo') as for complete sets of photos (using 'Item Type':
'Photoset'). The submodule Flickr Sets should be enabled to use sets in this
field.

Flickr Photo Set
----------------
Field for storing a reference to a Flickr photo set. It displays only the
primary representing image of a set or a slideshow of multiple images. To
display multiple photos from a photoset, use the Flickr Photo field type or use
the slideshow format.

Most interesting feature of this field is the slideshow. Both a full featured and
basic version exist. Both are responsive and adapt to the available space.

Full screen mode is supported, showing the largest available image that fits the
screen on a black background (the way that most professional photographers
prefer to showcase their work).

FIELD CONFIGURATION
===================
- Go to '/admin/structure/types'
- Click 'manage fields'
- Add new field > Flickr Photo or Flickr Photo Set (submodule Flickr Sets
  should be enabled to use sets in this field)
- Save field settings
- Configure as desired
- Save settings
Then:
- Go to '/admin/structure/types'
- Click 'manage display'
- Select the formatter for a Flickr field (a size)
- Save

NOTE:
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.

FEEDS INTEGRATION
=================
If you have the feeds module enabled, you can export Flickr field data.
- Go to 'Mapping' (under 'Processor') for your particular feed.
- See and use the 3 new 'Target' options (named as your chosen field name with
  the targeted column (id, nsid and type) in brackets.

The options are as follows:
- id: This is the Flickr photo or set ID.
- nsid: This is the Flickr user ID.
- type: This is the type of Flickr field. Current options are 'photo_id' (for an
  individual photo) and 'id' (for a set).

Find an example csv file and feeds importer at:
https://www.drupal.org/node/2339189#comment-9160963

File

field/README.txt
View source 
  1. The content of this file is based on the online documentation that can be found

  2. at https://drupal.org/node/2171299

  3. It is recommended to read it there, as it is more detailed and illustrated.

  4. 

  5. NAME

  6. ====

  7. Flickr Field

  8. Part of the Flickr module. Project page at https://drupal.org/project/flickr

  9. 

  10. OVERVIEW

  11. ========

  12. Add Flickr images or sets to content as fields:

  13. - can be added to entities, usually nodes

  14. - have several formatting options to use various sizes, including slideshows

  15. - can be queried with the Views module.

  16. 

  17. There are two kind of module provided Flickr fields. Only the first type is used

  18. for single Flickr photos. Both type of fields can be used for Flickr Photo Sets

  19. but each in a different way.

  20. 

  21. Flickr Photo

  22. ------------

  23. Store Flickr Photo or Photoset IDs and display the photos in nodes and Views.

  24. Despite the name this field is used both for individual photos (using

  25. 'Item Type': 'Photo') as for complete sets of photos (using 'Item Type':

  26. 'Photoset'). The submodule Flickr Sets should be enabled to use sets in this

  27. field.

  28. 

  29. Flickr Photo Set

  30. ----------------

  31. Field for storing a reference to a Flickr photo set. It displays only the

  32. primary representing image of a set or a slideshow of multiple images. To

  33. display multiple photos from a photoset, use the Flickr Photo field type or use

  34. the slideshow format.

  35. 

  36. Most interesting feature of this field is the slideshow. Both a full featured and

  37. basic version exist. Both are responsive and adapt to the available space.

  38. 

  39. Full screen mode is supported, showing the largest available image that fits the

  40. screen on a black background (the way that most professional photographers

  41. prefer to showcase their work).

  42. 

  43. FIELD CONFIGURATION

  44. ===================

  45. - Go to '/admin/structure/types'

  46. - Click 'manage fields'

  47. - Add new field > Flickr Photo or Flickr Photo Set (submodule Flickr Sets

  48.   should be enabled to use sets in this field)

  49. - Save field settings

  50. - Configure as desired

  51. - Save settings

  52. Then:

  53. - Go to '/admin/structure/types'

  54. - Click 'manage display'

  55. - Select the formatter for a Flickr field (a size)

  56. - Save

  57. 

  58. NOTE:

  59. For square images ('s': 75px and 'q': 150px) no real width needs to be fetched,

  60. giving it a performance advantage over other sizes. Recommended if you include

  61. many images.

  62. 

  63. FEEDS INTEGRATION

  64. =================

  65. If you have the feeds module enabled, you can export Flickr field data.

  66. - Go to 'Mapping' (under 'Processor') for your particular feed.

  67. - See and use the 3 new 'Target' options (named as your chosen field name with

  68.   the targeted column (id, nsid and type) in brackets.

  69. 

  70. The options are as follows:

  71. - id: This is the Flickr photo or set ID.

  72. - nsid: This is the Flickr user ID.

  73. - type: This is the type of Flickr field. Current options are 'photo_id' (for an

  74.   individual photo) and 'id' (for a set).

  75. 

  76. Find an example csv file and feeds importer at:

  77. https://www.drupal.org/node/2339189#comment-9160963