You are here

Home » API reference » Image Style Selector 7.2

README.txt in Image Style Selector 7.2

Same filename and directory in other branches
  1. 7 README.txt
Image Style Selector
===========

Allows for selecting an image style per created image.

Dependencies
------------
- image


Installation
------------
Just enable module like any other.


Configuration
-------------
Check "ISS enabled" checkbox on image styles you want to use, and save them. Then edit an image
fields you want to use, Enable Image Style Selector for them and choose which styles you want to be
sources and which styles you want to be targets. Source styles are the styles which will be changed
before rendering, and target styles are just styles they will be able to be changed to. Next you
need to give users permission to "Select image styles".

For example: Let's say you have field_image for your articles main image. It uses "large" style for
displaying image in nodes "full" view mode. You also have "large_watermark" style which differ only
in that it has additional effect adding watermark to the image. You want to allow your content
creators to choose between those image styles on per image basis.

First make "large" and "large_watermark" image styles "ISS enabled" on their edit form. Then edit
field_image on your content type, enable Image Style Selector there, choose "large" style as source
style, and "large" and "large_watermark" as target styles. Give your users permission to select
style, and they will be able to do this on content creation. They will be able to choose between
"large" (which will be presented as "No change" because it is the same as source style) and
"large_watermark". Now every time they will choose "large_watermark" - this particular image will
be displayed in this style instead of "large" style on image fields.

NOTE: If only one source style is chosen for field, user will have available only one select widget
to choose target style for this source. It is possible however to have multiple source styles - in
this case user will have available TWO select widgets, first to choose source style, and second
to choose target style for source style chosen in previous select widget.

Additionaly on admin/config/media/iss there is additional configuration of iss module.

File

README.txt
View source 
  1. Image Style Selector

  2. ===========

  3. 

  4. Allows for selecting an image style per created image.

  5. 

  6. Dependencies

  7. ------------

  8. - image

  9. 

  10. 

  11. Installation

  12. ------------

  13. Just enable module like any other.

  14. 

  15. 

  16. Configuration

  17. -------------

  18. Check "ISS enabled" checkbox on image styles you want to use, and save them. Then edit an image

  19. fields you want to use, Enable Image Style Selector for them and choose which styles you want to be

  20. sources and which styles you want to be targets. Source styles are the styles which will be changed

  21. before rendering, and target styles are just styles they will be able to be changed to. Next you

  22. need to give users permission to "Select image styles".

  23. 

  24. For example: Let's say you have field_image for your articles main image. It uses "large" style for

  25. displaying image in nodes "full" view mode. You also have "large_watermark" style which differ only

  26. in that it has additional effect adding watermark to the image. You want to allow your content

  27. creators to choose between those image styles on per image basis.

  28. 

  29. First make "large" and "large_watermark" image styles "ISS enabled" on their edit form. Then edit

  30. field_image on your content type, enable Image Style Selector there, choose "large" style as source

  31. style, and "large" and "large_watermark" as target styles. Give your users permission to select

  32. style, and they will be able to do this on content creation. They will be able to choose between

  33. "large" (which will be presented as "No change" because it is the same as source style) and

  34. "large_watermark". Now every time they will choose "large_watermark" - this particular image will

  35. be displayed in this style instead of "large" style on image fields.

  36. 

  37. NOTE: If only one source style is chosen for field, user will have available only one select widget

  38. to choose target style for this source. It is possible however to have multiple source styles - in

  39. this case user will have available TWO select widgets, first to choose source style, and second

  40. to choose target style for source style chosen in previous select widget.

  41. 

  42. Additionaly on admin/config/media/iss there is additional configuration of iss module.