README.txt 1.6 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849
  1. # Boxes
  2. Boxes module is a reimplementation of the custom blocks (boxes) that the core
  3. block module provides. It is a proof of concept for what a re-worked block
  4. module could do.
  5. The module assumes that custom blocks are configuration, and not content. This
  6. means that it is a reasonable action to ask for all blocks at one time, this is
  7. in fact exactly what the core block module does.
  8. ## Features
  9. **Inline editing.** Boxes provides an inline interface for editing blocks,
  10. allowing you to change the contents of blocks without going to an admin page.
  11. **Exportability.** Boxes provided blocks can be exported into code. Note; this
  12. includes the settings for the boxes themselves and not visibility rules. For
  13. exporting visibility settings the Context[1] module is recommended.
  14. **Pluggable box types.** Boxes includes a basic "box type" that mimics how custom
  15. blocks behave in core. Boxes is designed to allow for modules to provide
  16. additional "box types" that have different configuration and rendering options.
  17. ## Chaos tools support
  18. Boxes provides exportables for its blocks via the required Chaos tools[2]
  19. module. This allows modules to provide blocks in code that can be overwritten
  20. in the UI.
  21. Chaos tools is required to use Boxes.
  22. ## Spaces support
  23. Boxes provides a Spaces[3] controller class that allows individual spaces to
  24. override a particular block, or even define a completely new block for a
  25. specific space.
  26. Spaces is not required by boxes.
  27. ## Todo
  28. * Boxes need language awareness.
  29. * The inline editing experience could be nicer.
  30. [1] http://drupal.org/project/context
  31. [2] http://drupal.org/project/ctools
  32. [3] http://drupal.org/project/spaces