You are here

Home » API reference » Picture Background Formatter 8

README.txt in Picture Background Formatter 8

Same filename and directory in other branches
  1. 7 README.txt
Introduction
------------

The Picture Background Formatter module creates an image field formatter that
generates background image CSS code based on a Picture Mapping.


Requirements
------------

This module requires the following modules:

  * Picture (https://www.drupal.org/project/picture)


Installation
------------

  * Install as you would normally install a contributed Drupal module. See:
    https://drupal.org/documentation/install/modules-themes/modules-7
    for further information.


Configuration
-------------

  * A picture mapping must be created prior to utilizing the Picture Background
    Formatter

  * Add an image field to your desired Content Type

  * In the Content Type Display panel, change the format of your image field
    to Picture Background Formatter

  * Click the field settings gear to expose the Picture Mapping and Selector
    fields

    - The chosen Picture Mapping will create image style varients just as the
      normal Picture formatter would

    - Input the desired CSS Selector where you want the background image
      to appear


Troubleshooting
---------------

If you do not see the Picture Background Formatter formatter in your Content
Type display, please make sure you have correctly configured a valid Picture
Mapping via admin/config/media/picture

Picture Background Formatter only uses Image Styles for its output. Any
breakpoints that use Picture module's Sizes Attribute will be skipped.

File

README.txt
View source 
  1. Introduction

  2. ------------

  3. 

  4. The Picture Background Formatter module creates an image field formatter that

  5. generates background image CSS code based on a Picture Mapping.

  6. 

  7. 

  8. Requirements

  9. ------------

  10. 

  11. This module requires the following modules:

  12. 

  13.   * Picture (https://www.drupal.org/project/picture)

  14. 

  15. 

  16. Installation

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

  18. 

  19.   * Install as you would normally install a contributed Drupal module. See:

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

  21.     for further information.

  22. 

  23. 

  24. Configuration

  25. -------------

  26. 

  27.   * A picture mapping must be created prior to utilizing the Picture Background

  28.     Formatter

  29. 

  30.   * Add an image field to your desired Content Type

  31. 

  32.   * In the Content Type Display panel, change the format of your image field

  33.     to Picture Background Formatter

  34. 

  35.   * Click the field settings gear to expose the Picture Mapping and Selector

  36.     fields

  37. 

  38.     - The chosen Picture Mapping will create image style varients just as the

  39.       normal Picture formatter would

  40. 

  41.     - Input the desired CSS Selector where you want the background image

  42.       to appear

  43. 

  44. 

  45. Troubleshooting

  46. ---------------

  47. 

  48. If you do not see the Picture Background Formatter formatter in your Content

  49. Type display, please make sure you have correctly configured a valid Picture

  50. Mapping via admin/config/media/picture

  51. 

  52. Picture Background Formatter only uses Image Styles for its output. Any

  53. breakpoints that use Picture module's Sizes Attribute will be skipped.