You are here

README.txt in Dynamic Background 7.2

Same filename and directory in other branches
  1. 6 README.txt
  2. 7 README.txt
Dynamic background
------------------
Enables site administrators to upload a range of images and select one as
background on the site. This enables non HTML/CSS aware administrators to
quickly change the background image on a site from within the administrator
interface.

The selected image is applied to the site by entering a CSS selector in the
administration interface (e.g. body #main-wrapper). It's also possible to attach
CSS to the selector in the interface (e.g. background-size: cover).

Extensions
----------
This module comes with extensions that allows you to used the uploaded
background images in different contexts. The extensions has a weight so the user
extension overrides the image selection made in the node extension. If an
extension do not have a image selected, then it falls back to the next extension
with a lower weight.

Each extension have its own set of configuration options, but they all have the
CSS fields, which have to be filled out.

* User
------
This extension allows authorized users to select a background image to use when
they are logged in. If a used have selected a image it will override all other
background image selection. The image is selected on the "My background" tab on
the user profile page (e.g. /user/1/backgrounds).

* Blog
------
This extension allows users to select a background image for their blog pages
and entries. The image is selected on the user profile on the "My blog
background" tab on at the user profile page (e.g. /user/1/blog/background).

* Panels
--------
The panels extension allow you to select a background image for a given panel 
variant. The image is selected under "General settings" in the variant of the
panel that should use a given image.

* Node
------
This extension allow each node to have its own background image. You can select
which content types should have this ability in the administration interface.
The image for a given node is selected in the individual node edit form, when
creating or updating a node.

* Views
-------
This extension enables administrators to select dynamic background images in
views, so each view can have it's own image. This is achieved exposing a new
display in views called "Page (dynamic background)", which under page settings
have an option to select the image

* Context
---------
The context extension allows administrators to select uploaded images base on
different contexts using the context module. Such contexts as path, role,
node type or taxonomy and may more conditions.

* Inherit
---------
An add-on that works with the Node submodule to automatically use the
background image from the parent page (by path) if one is not manually
selected.

Configuration
-------------
Enable the modules/extensions that you want to use and go to the administration
interface at /admin/config/user-interface/backgrounds/settings. Start by filling
out the form and remember to fill out the CSS behaviour section. Then go into
the configuration tab for each module/extension that you have enabled and as a
minimum filling out the CSS behaviour fields.

Go to /admin/config/user-interface/backgrounds and select some images to upload
after pressing "Save configuration" the form will change and allow you to select
a default image. If you have enable some of the extensions go to their location
and select one of the uploaded images. See the extension descriptions above for
information on where to select images for each extension.

File

README.txt
View source
  1. Dynamic background
  2. ------------------
  3. Enables site administrators to upload a range of images and select one as
  4. background on the site. This enables non HTML/CSS aware administrators to
  5. quickly change the background image on a site from within the administrator
  6. interface.
  7. The selected image is applied to the site by entering a CSS selector in the
  8. administration interface (e.g. body #main-wrapper). It's also possible to attach
  9. CSS to the selector in the interface (e.g. background-size: cover).
  10. Extensions
  11. ----------
  12. This module comes with extensions that allows you to used the uploaded
  13. background images in different contexts. The extensions has a weight so the user
  14. extension overrides the image selection made in the node extension. If an
  15. extension do not have a image selected, then it falls back to the next extension
  16. with a lower weight.
  17. Each extension have its own set of configuration options, but they all have the
  18. CSS fields, which have to be filled out.
  19. * User
  20. ------
  21. This extension allows authorized users to select a background image to use when
  22. they are logged in. If a used have selected a image it will override all other
  23. background image selection. The image is selected on the "My background" tab on
  24. the user profile page (e.g. /user/1/backgrounds).
  25. * Blog
  26. ------
  27. This extension allows users to select a background image for their blog pages
  28. and entries. The image is selected on the user profile on the "My blog
  29. background" tab on at the user profile page (e.g. /user/1/blog/background).
  30. * Panels
  31. --------
  32. The panels extension allow you to select a background image for a given panel
  33. variant. The image is selected under "General settings" in the variant of the
  34. panel that should use a given image.
  35. * Node
  36. ------
  37. This extension allow each node to have its own background image. You can select
  38. which content types should have this ability in the administration interface.
  39. The image for a given node is selected in the individual node edit form, when
  40. creating or updating a node.
  41. * Views
  42. -------
  43. This extension enables administrators to select dynamic background images in
  44. views, so each view can have it's own image. This is achieved exposing a new
  45. display in views called "Page (dynamic background)", which under page settings
  46. have an option to select the image
  47. * Context
  48. ---------
  49. The context extension allows administrators to select uploaded images base on
  50. different contexts using the context module. Such contexts as path, role,
  51. node type or taxonomy and may more conditions.
  52. * Inherit
  53. ---------
  54. An add-on that works with the Node submodule to automatically use the
  55. background image from the parent page (by path) if one is not manually
  56. selected.
  57. Configuration
  58. -------------
  59. Enable the modules/extensions that you want to use and go to the administration
  60. interface at /admin/config/user-interface/backgrounds/settings. Start by filling
  61. out the form and remember to fill out the CSS behaviour section. Then go into
  62. the configuration tab for each module/extension that you have enabled and as a
  63. minimum filling out the CSS behaviour fields.
  64. Go to /admin/config/user-interface/backgrounds and select some images to upload
  65. after pressing "Save configuration" the form will change and allow you to select
  66. a default image. If you have enable some of the extensions go to their location
  67. and select one of the uploaded images. See the extension descriptions above for
  68. information on where to select images for each extension.