You are here

README.txt in Homebox 6.2

Same filename in this branch
  1. 6.2 README.txt
  2. 6.2 homebox_og/README.txt
Same filename and directory in other branches
  1. 6.3 README.txt
  2. 6 README.txt
  3. 7.3 README.txt
  4. 7.2 README.txt
 _                          _                  ____
| |__   ___  _ __ ___   ___| |__   ___ __  __ |___ \
| '_ \ / _ \| '_ ` _ \ / _ \ '_ \ / _ \\ \/ /   __) |
| | | | (_) | | | | | |  __/ |_) | (_) |>  <   / __/
|_| |_|\___/|_| |_| |_|\___|_.__/ \___//_/\_\ |_____|


Welcome to Homebox 2.


REQUIREMENTS
------------

 * jQuery UI 6.x-1.3 - http://drupal.org/project/jquery_ui
 * jQuery UI 1.6
   - Grab jQuery UI package from Google Code - http://jquery-ui.googlecode.com/files/jquery.ui-1.6.zip
 * PHP >= 5.2
   - This is required for JSON support.


RECOMMENDED
---------------------

The following modules are not required but recommended for integration or ease of use:

 * Color picker - http://drupal.org/project/colorpicker
 * Views -  http://drupal.org/project/views
 * Advanced Help - http://drupal.org/project/advanced_help


INSTALLATION
------------

 * Enable jQuery UI modules
 * Be sure to follow instructions from README.txt in jQuery UI module

   --- IMPORTANT ---- Begin
   Be sure to grab jQuery UI package from Google Code - http://jquery-ui.googlecode.com/files/jquery.ui-1.6.zip

   If not sure read this http://drupal.org/node/463270
   --- IMPORTANT ---- End

 * Enable optional modules if you want (see list above)
 * Enable Homebox module
 * Visit the Status Report page and make sure there are no Homebox errors
 * Go to Administer > Site building > Homebox
 * Create an new page


UPGRADING FROM 1.x TO 2.x
-------------------------

Sorry, but there is no upgrade path between the 1.x version of Homebox and the 2.x version.
In order for Homebox 2 to work correctly, you must completely uninstall any previous versions
and cleanly install this version.


NEW FEATURES
------------

Homebox 2 is loaded with new features and improvements. To get the most out of this module,
please quickly read the list of changes in CHANGELOG.txt, under the 2.x section.


CONTROLLING ACCESS TO HOME BOX PAGES
------------------------------------

Access controls for Homebox pages (not the admin interface) are no longer located in the standard
Drupal permissions table. When creating/editing each Homebox page, you can choose which roles are
allowed to view the page. Unlike other Drupal components, if you do not choose any roles, then only
admins can view the page. So, choose at least one role. For obvious reasons, anonymous users will
not be able to save pages or add custom items.


CREATING PANELS-LIKE HOME BOX LAYOUTS
-------------------------------------

One of Homebox 2's new features, is the ability to easily create panels-like layouts. After creating
a new Homebox page, click the 'Settings' link. Under the 'Custom column widths' fieldset, you can
specify the width percentage of each region. If you wanted to create a layout like:

[-----top----]
[--l--][--r--]
[---bottom---]

You'd use widths of 100, 50, 50, and 100.


"CUSTOM ITEMS"
--------------

Another new feature in Homebox 2 is the ability for users to enter custom items into their Homebox.
Each Homebox page has the option to turn this on or off. If set on, users can enter as many custom
blocks as they like - supplying a block title and body (full HTML allowed). This is useful if they want
to paste code for an external widget.


PROFILE INTEGRATION
-------------------

Homebox 2 integrates with Drupal's core profile module. After creating a page, you can navigate
to admin/user/homebox and choose any available Homebox page to reside as a tab on user's profiles.
User's can only view their own Homebox profile tab.


ORGANIC GROUPS INTEGRATION
--------------------------

Similar to the previously mentioned, Homebox integrates with the Organic Groups module. You have the option
to have a Homebox page reside as a group homepage tab, or become the new group homepage itself. You must
enable the homebox_og module then navigate to admin/og/homebox. If your site is using Panels and you set
a Homebox page to act as a group homepage, it will automatically disable any Panels that override node
views.


FEATURES INTEGRATION
--------------------

Homebox 2 has the ability to import and export pages, as well as have them live in code. Because of this,
Homebox has been made to integrate with the Features.module. For more information about Features, please
visit http://drupal.org/project/features.


API
---

Modules can now ship with a Homebox completely in code. See homebox_example.module for an example and
documentation.

File

README.txt
View source
  1. _ _ ____
  2. | |__ ___ _ __ ___ ___| |__ ___ __ __ |___ \
  3. | '_ \ / _ \| '_ ` _ \ / _ \ '_ \ / _ \\ \/ / __) |
  4. | | | | (_) | | | | | | __/ |_) | (_) |> < / __/
  5. |_| |_|\___/|_| |_| |_|\___|_.__/ \___//_/\_\ |_____|
  6. Welcome to Homebox 2.
  7. REQUIREMENTS
  8. ------------
  9. * jQuery UI 6.x-1.3 - http://drupal.org/project/jquery_ui
  10. * jQuery UI 1.6
  11. - Grab jQuery UI package from Google Code - http://jquery-ui.googlecode.com/files/jquery.ui-1.6.zip
  12. * PHP >= 5.2
  13. - This is required for JSON support.
  14. RECOMMENDED
  15. ---------------------
  16. The following modules are not required but recommended for integration or ease of use:
  17. * Color picker - http://drupal.org/project/colorpicker
  18. * Views - http://drupal.org/project/views
  19. * Advanced Help - http://drupal.org/project/advanced_help
  20. INSTALLATION
  21. ------------
  22. * Enable jQuery UI modules
  23. * Be sure to follow instructions from README.txt in jQuery UI module
  24. --- IMPORTANT ---- Begin
  25. Be sure to grab jQuery UI package from Google Code - http://jquery-ui.googlecode.com/files/jquery.ui-1.6.zip
  26. If not sure read this http://drupal.org/node/463270
  27. --- IMPORTANT ---- End
  28. * Enable optional modules if you want (see list above)
  29. * Enable Homebox module
  30. * Visit the Status Report page and make sure there are no Homebox errors
  31. * Go to Administer > Site building > Homebox
  32. * Create an new page
  33. UPGRADING FROM 1.x TO 2.x
  34. -------------------------
  35. Sorry, but there is no upgrade path between the 1.x version of Homebox and the 2.x version.
  36. In order for Homebox 2 to work correctly, you must completely uninstall any previous versions
  37. and cleanly install this version.
  38. NEW FEATURES
  39. ------------
  40. Homebox 2 is loaded with new features and improvements. To get the most out of this module,
  41. please quickly read the list of changes in CHANGELOG.txt, under the 2.x section.
  42. CONTROLLING ACCESS TO HOME BOX PAGES
  43. ------------------------------------
  44. Access controls for Homebox pages (not the admin interface) are no longer located in the standard
  45. Drupal permissions table. When creating/editing each Homebox page, you can choose which roles are
  46. allowed to view the page. Unlike other Drupal components, if you do not choose any roles, then only
  47. admins can view the page. So, choose at least one role. For obvious reasons, anonymous users will
  48. not be able to save pages or add custom items.
  49. CREATING PANELS-LIKE HOME BOX LAYOUTS
  50. -------------------------------------
  51. One of Homebox 2's new features, is the ability to easily create panels-like layouts. After creating
  52. a new Homebox page, click the 'Settings' link. Under the 'Custom column widths' fieldset, you can
  53. specify the width percentage of each region. If you wanted to create a layout like:
  54. [-----top----]
  55. [--l--][--r--]
  56. [---bottom---]
  57. You'd use widths of 100, 50, 50, and 100.
  58. "CUSTOM ITEMS"
  59. --------------
  60. Another new feature in Homebox 2 is the ability for users to enter custom items into their Homebox.
  61. Each Homebox page has the option to turn this on or off. If set on, users can enter as many custom
  62. blocks as they like - supplying a block title and body (full HTML allowed). This is useful if they want
  63. to paste code for an external widget.
  64. PROFILE INTEGRATION
  65. -------------------
  66. Homebox 2 integrates with Drupal's core profile module. After creating a page, you can navigate
  67. to admin/user/homebox and choose any available Homebox page to reside as a tab on user's profiles.
  68. User's can only view their own Homebox profile tab.
  69. ORGANIC GROUPS INTEGRATION
  70. --------------------------
  71. Similar to the previously mentioned, Homebox integrates with the Organic Groups module. You have the option
  72. to have a Homebox page reside as a group homepage tab, or become the new group homepage itself. You must
  73. enable the homebox_og module then navigate to admin/og/homebox. If your site is using Panels and you set
  74. a Homebox page to act as a group homepage, it will automatically disable any Panels that override node
  75. views.
  76. FEATURES INTEGRATION
  77. --------------------
  78. Homebox 2 has the ability to import and export pages, as well as have them live in code. Because of this,
  79. Homebox has been made to integrate with the Features.module. For more information about Features, please
  80. visit http://drupal.org/project/features.
  81. API
  82. ---
  83. Modules can now ship with a Homebox completely in code. See homebox_example.module for an example and
  84. documentation.