You are here

Home » API reference » Background Images 6

README.txt in Background Images 6

Same filename and directory in other branches
  1. 7 README.txt
# BACKGROUND IMAGES #

This module enables users to set custom background images to any 'section' of the site. Leveraging the power of Context, this module defines a new context reaction called "Background Image" which will let you change the background image based on any criteria you can craft with context's conditions.

Background Image uses an existing content type as the interface to manage the images. So, you would first have to create a content type with an imagefield, then configure background image to use that content type. CSS is used to set/override the 'background' css property on the page of any element.

## Getting Started ##

Setup is fairly straightforward, but you will need to configure a few things to get started.

- Create a new content type with an image field and create a node with an image uploaded.
- Go to the settings page (admin/settings/background-image) and in the 'Node Settings' section select the node type you created as well as the image field you uploaded. Now you have an image field mapped directly to the background image module.
- Still in the settings page, provide a css selector and color and repeat attributes in the 'Default CSS Settings' section.
Create a context, and add the reaction 'Background Image'. There will be a select list with all the nodes of the specified type to choose from. Additionally you can override any css setting here as well.
- If you want, you can also set a weight for the background image. The weight helps the module decide which background image to use if there are overlapping contexts. Useful if you want to setup a default image as a site-wide context, and have other more specific contexts override it.

File

README.txt
View source 
  1. # BACKGROUND IMAGES #

  2. 

  3. This module enables users to set custom background images to any 'section' of the site. Leveraging the power of Context, this module defines a new context reaction called "Background Image" which will let you change the background image based on any criteria you can craft with context's conditions.

  4. 

  5. Background Image uses an existing content type as the interface to manage the images. So, you would first have to create a content type with an imagefield, then configure background image to use that content type. CSS is used to set/override the 'background' css property on the page of any element.

  6. 

  7. ## Getting Started ##

  8. 

  9. Setup is fairly straightforward, but you will need to configure a few things to get started.

  10. 

  11. - Create a new content type with an image field and create a node with an image uploaded.

  12. - Go to the settings page (admin/settings/background-image) and in the 'Node Settings' section select the node type you created as well as the image field you uploaded. Now you have an image field mapped directly to the background image module.

  13. - Still in the settings page, provide a css selector and color and repeat attributes in the 'Default CSS Settings' section.

  14. Create a context, and add the reaction 'Background Image'. There will be a select list with all the nodes of the specified type to choose from. Additionally you can override any css setting here as well.

  15. - If you want, you can also set a weight for the background image. The weight helps the module decide which background image to use if there are overlapping contexts. Useful if you want to setup a default image as a site-wide context, and have other more specific contexts override it.