You are here

Home » API reference » Image link to file 7

README.txt in Image link to file 7 

-- SUMMARY --

The Image link to file module is a formatter for image fields that creates a
hyperlink from the image to a file field in the same entity.

This simple module solves a typical use case in which, when clicking on a
preview image (e.g. JPG or PNG file), a PDF file specified as a file field in
the same node should be opened.

To use the formatter, click on the Manage Display tab of a content type that
contains at least an image field and a file field. Then, in the Format column
of the image field, select "Image linked to file". To specify the format
settings, click on the button with the gear to reveal the "Image style"
selector, the "Image link" selector and the "Open image in a new window or tab"
checkbox.

Any of the available image style options can be selected for the image and any
of the file fields can be selected for the linked file. Optionally, the linked
file can be made to open in a new window or tab, rather than in the same window
or tab.

After your selection, click the Update button and then click the Save button.


-- REQUIREMENTS --

None.


-- INSTALLATION --

* Install as usual, see
  https://drupal.org/documentation/install/modules-themes/modules-7
  for further information.


-- CONFIGURATION --

None.


-- FAQ --

Q: Must a file link be specified in any case? What happens if no link is
   specified?

A: A link to a file field is optional. If no link is specified, the image will
   not be linked to anything.


Q: What happens if the file field linked to the image is empty?

A: If the file field linked to the image is empty, the image will not be linked
   to anything.


Q: What if there is more than one file field in the node?

A: A selector in the settings form (accessible via the button with the gear)
   allows you to specify as link destination any of the file field in the node.


Q: What if there are multiple file values in the same file field specified as
   link destination?

A: The first file is linked to the image.


Q: Can I control whether the linked file opens in a new window or in a new tab?

A: This depends on the settings of your browser. This module can control
   whether the file opens in the same window/tab or in a new window/tab, but
   has no control over the choice of window vs. tab.


-- CONTACT --

Developer and current maintainer:
* Alex B - https://drupal.org/user/1815724

File

README.txt
View source 
  1. 

  2. -- SUMMARY --

  3. 

  4. The Image link to file module is a formatter for image fields that creates a

  5. hyperlink from the image to a file field in the same entity.

  6. 

  7. This simple module solves a typical use case in which, when clicking on a

  8. preview image (e.g. JPG or PNG file), a PDF file specified as a file field in

  9. the same node should be opened.

  10. 

  11. To use the formatter, click on the Manage Display tab of a content type that

  12. contains at least an image field and a file field. Then, in the Format column

  13. of the image field, select "Image linked to file". To specify the format

  14. settings, click on the button with the gear to reveal the "Image style"

  15. selector, the "Image link" selector and the "Open image in a new window or tab"

  16. checkbox.

  17. 

  18. Any of the available image style options can be selected for the image and any

  19. of the file fields can be selected for the linked file. Optionally, the linked

  20. file can be made to open in a new window or tab, rather than in the same window

  21. or tab.

  22. 

  23. After your selection, click the Update button and then click the Save button.

  24. 

  25. 

  26. -- REQUIREMENTS --

  27. 

  28. None.

  29. 

  30. 

  31. -- INSTALLATION --

  32. 

  33. * Install as usual, see

  34.   https://drupal.org/documentation/install/modules-themes/modules-7

  35.   for further information.

  36. 

  37. 

  38. -- CONFIGURATION --

  39. 

  40. None.

  41. 

  42. 

  43. -- FAQ --

  44. 

  45. Q: Must a file link be specified in any case? What happens if no link is

  46.    specified?

  47. 

  48. A: A link to a file field is optional. If no link is specified, the image will

  49.    not be linked to anything.

  50. 

  51. 

  52. Q: What happens if the file field linked to the image is empty?

  53. 

  54. A: If the file field linked to the image is empty, the image will not be linked

  55.    to anything.

  56. 

  57. 

  58. Q: What if there is more than one file field in the node?

  59. 

  60. A: A selector in the settings form (accessible via the button with the gear)

  61.    allows you to specify as link destination any of the file field in the node.

  62. 

  63. 

  64. Q: What if there are multiple file values in the same file field specified as

  65.    link destination?

  66. 

  67. A: The first file is linked to the image.

  68. 

  69. 

  70. Q: Can I control whether the linked file opens in a new window or in a new tab?

  71. 

  72. A: This depends on the settings of your browser. This module can control

  73.    whether the file opens in the same window/tab or in a new window/tab, but

  74.    has no control over the choice of window vs. tab.

  75. 

  76. 

  77. -- CONTACT --

  78. 

  79. Developer and current maintainer:

  80. * Alex B - https://drupal.org/user/1815724