You are here

Home » API reference » Arrange Fields 7

README.txt in Arrange Fields 7

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

This module lets you drag-and-drop the fields of any 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
======================

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

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

- Visit your 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/config/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 Drupal content types:
    - 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. (For Drupal 7)

  5. =======================

  6. Richard Peacock (richard@richardpeacock.com)

  7. 

  8. This module lets you drag-and-drop the fields of any content type, Webform,

  9. or almost any other form in Drupal into the 

  10. positions you would like for editing. This makes it super simple to have forms 

  11. with inline fields, which you can change at any point. Tab indexing is also respected, 

  12. so no matter how you arrange the fields, the users can still tab through them easily.

  13. 

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

  15. images, etc.

  16. 

  17. =======================

  18. Restrictions

  19. =======================

  20.  - This module does not work so well with fields with "unlimited" as their number of

  21.    values.

  22.  

  23.  - Multi-page forms are not currently supported.

  24.  

  25.  - Fields within fieldsets cannot be arranged.  But, the fieldset itself

  26.    can be re-arranged.

  27.    

  28.  - jQuery is used to properly specify the height of the container 

  29.    div on the node/edit page, after you have arranged fields. As such, 

  30.    the person editing the form will need javascript enabled in order for it 

  31.    to show up correctly. (If anyone out there knows a better way to do this, 

  32.    please open an issue!)

  33.  

  34.  - Field positions will not change the node view page for the created 

  35.    content. That information will still be displayed the traditional 

  36.    way (straight down the page).

  37. 

  38.  - This module doesn't try to work on Webform's submissions pages.  It just

  39.    uses the default display for those.

  40.    

  41.    

  42. ======================

  43. Directions

  44. ======================

  45. 

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

  47. 

  48. - Visit your modules page in Drupal and enable the module.

  49. 

  50. - Visit your permissions and give authorized users the

  51.   "administer arrange fields" permission, if desired.  (Otherwise, only the

  52.   admin user will be able to use it).

  53. 

  54. - To begin arranging fields just visit admin/config/arrange-fields to see a main menu page.

  55.   Visit the Settings tab on that page to add arbitrary form_id's to the list which

  56.   you can arrange.

  57.   OR...

  58.   - For Drupal content types:

  59.     - visit Administer -> Content Types (the link

  60.       is at the top of the page, as a tab).  You can also select "manage fields" 

  61.       for a content type, and then there will be a new tab at the top of 

  62.       this page as well.

  63.   - For Webform:

  64.     - Begin editing a new or existing webform.  There will be a subtab at the top

  65.       of the page that says "Arrange fields".  It should be next to the "Form components"

  66.       subtab.

  67. 

  68. 

  69. ======================

  70. Notes

  71. ======================

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