You are here

README.txt in Arrange Fields 6

Same filename and directory in other branches
  1. 7 README.txt
; $Id$
=======================
Arrange Fields
=======================
Richard Peacock (richard@richardpeacock.com)

This module lets you drag-and-drop the fields of any CCK content type, Webform,
or almost any other form in Drupal into the 
positions you would like for editing. This makes it super simple to have forms 
with inline fields, which you can change at any point. Tab indexing is also respected, 
so no matter how you arrange the fields, the users can still tab through them easily.

You can also add arbitrary bits of markup to the form as well, including extra labels,
images, etc. 

=======================
Restrictions
=======================
 - This module does not work so well with fields with "unlimited" as their number of
   values.
 
 - Multi-page forms are not currently supported.
 
 - Fields within fieldsets cannot be arranged.  But, the fieldset itself
   can be re-arranged.
   
 - jQuery is used to properly specify the height of the container 
   div on the node/edit page, after you have arranged fields. As such, 
   the person editing the form will need javascript enabled in order for it 
   to show up correctly. (If anyone out there knows a better way to do this, 
   please open an issue!)
 
 - Field positions will not change the node view page for the created 
   content. That information will still be displayed the traditional 
   way (straight down the page).

 - This module doesn't try to work on Webform's submissions pages.  It just
   uses the default display for those.
   
   
======================
Directions
======================

- Make sure you have correctly installed and configured the jquery_ui module!
  Read through it's README.txt file for detailed instructions.  Make sure
  you get the correct version of the plugin! (NOT the most recent version unless
  you know what you're doing!)

- Unpack the module files into /sites/all/modules/arrange_fields.

- Visit your admin/build/modules page in Drupal and enable the module.

- Visit your admin/user/permissions and give authorized users the
  "administer arrange fields" permission, if desired.  (Otherwise, only the
  admin user will be able to use it).

- To begin arranging fields just visit admin/settings/arrange-fields to see a main menu page.
  Visit the Settings tab on that page to add arbitrary form_id's to the list which
  you can arrange.
  OR...
  - For CCK:
    - visit Administer -> Content Types (the link
      is at the top of the page, as a tab).  You can also select "manage fields" 
      for a content type, and then there will be a new tab at the top of 
      this page as well.
  - For Webform:
    - Begin editing a new or existing webform.  There will be a subtab at the top
      of the page that says "Arrange fields".  It should be next to the "Form components"
      subtab.


======================
Notes
======================
Included icon(s) are from the "mini" pack at famfamfam.com.

File

README.txt
View source
  1. ; $Id$
  2. =======================
  3. Arrange Fields
  4. =======================
  5. Richard Peacock (richard@richardpeacock.com)
  6. This module lets you drag-and-drop the fields of any CCK content type, Webform,
  7. or almost any other form in Drupal into the
  8. positions you would like for editing. This makes it super simple to have forms
  9. with inline fields, which you can change at any point. Tab indexing is also respected,
  10. so no matter how you arrange the fields, the users can still tab through them easily.
  11. You can also add arbitrary bits of markup to the form as well, including extra labels,
  12. images, etc.
  13. =======================
  14. Restrictions
  15. =======================
  16. - This module does not work so well with fields with "unlimited" as their number of
  17. values.
  18. - Multi-page forms are not currently supported.
  19. - Fields within fieldsets cannot be arranged. But, the fieldset itself
  20. can be re-arranged.
  21. - jQuery is used to properly specify the height of the container
  22. div on the node/edit page, after you have arranged fields. As such,
  23. the person editing the form will need javascript enabled in order for it
  24. to show up correctly. (If anyone out there knows a better way to do this,
  25. please open an issue!)
  26. - Field positions will not change the node view page for the created
  27. content. That information will still be displayed the traditional
  28. way (straight down the page).
  29. - This module doesn't try to work on Webform's submissions pages. It just
  30. uses the default display for those.
  31. ======================
  32. Directions
  33. ======================
  34. - Make sure you have correctly installed and configured the jquery_ui module!
  35. Read through it's README.txt file for detailed instructions. Make sure
  36. you get the correct version of the plugin! (NOT the most recent version unless
  37. you know what you're doing!)
  38. - Unpack the module files into /sites/all/modules/arrange_fields.
  39. - Visit your admin/build/modules page in Drupal and enable the module.
  40. - Visit your admin/user/permissions and give authorized users the
  41. "administer arrange fields" permission, if desired. (Otherwise, only the
  42. admin user will be able to use it).
  43. - To begin arranging fields just visit admin/settings/arrange-fields to see a main menu page.
  44. Visit the Settings tab on that page to add arbitrary form_id's to the list which
  45. you can arrange.
  46. OR...
  47. - For CCK:
  48. - visit Administer -> Content Types (the link
  49. is at the top of the page, as a tab). You can also select "manage fields"
  50. for a content type, and then there will be a new tab at the top of
  51. this page as well.
  52. - For Webform:
  53. - Begin editing a new or existing webform. There will be a subtab at the top
  54. of the page that says "Arrange fields". It should be next to the "Form components"
  55. subtab.
  56. ======================
  57. Notes
  58. ======================
  59. Included icon(s) are from the "mini" pack at famfamfam.com.