modules/nodereference_asmselect/README.txt

// $Id$

CONTENTS OF THIS FILE
---------------------

 * Introduction
 * Installation
 * Usage


INTRODUCTION
------------

Author:
* Shai Yallin (electricmonk)

Module development has been sponserd by Ewave (http://www.ewave.co.il)

ASM Select (http://code.google.com/p/jquery-asmselect/) is a progressive enhancement 
to <select multiple> form elements. It provides a simpler alternative with the following
advantages:

* Easier for users to understand and interact with than regular <select multiple> form 
  elements. Users know how to interact with it sans instruction. 

* Doesn't require user to Ctrl-Click or Shift-Click multiple elements. Instead users of 
  your form can add or remove elements individually, without risk of losing those that
  have already been selected. 

* Selected elements are always visible (within the confines of your interface) while 
  unselected elements are always hidden (within a regular <select>). 

* Unlike regular <select multiple> option elements, those on asmSelect are optionally 
  sortable with drag and drop (this part requires jQuery UI). 

* asmSelect hides, maintains and updates the original <select multiple> so that no 
  changes are required to existing code. 

* If a user does not have javascript, then of course the regular <select multiple> form 
  element is used instead. 

* If the original <select multiple> form element is modified by some other jQuery or 
  javascript code, the change will be reflected in the asmSelect as well. 

This module adds a new CCK Node Reference widget option (in addition to Select and Auto
Complete) which seamlessly integrates ASM support into all Drupal forms.


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

1. Copy the nodereference_asmselect module directory to your sites/SITENAME/modules
   directory.

2. Download ASM Select from http://code.google.com/p/jquery-asmselect/ (last known version
   to work is 1.02 beta)

3. Extract it as a sub-directory called 'asmselect' in the module folder:

     /sites/all/modules/nodereference_asmselect/asmselect/

4. Enable the module at Administer >> Site building >> Modules.


USAGE
-----

Create a CCK Node Reference field and choose ASM Select as the form widget. You can then
control the different settings of yoru widget. The JQuery UI Module
(http://drupal.org/project/jquery_ui) is required in order to use the sort feature.
1	// $Id$
2
3	CONTENTS OF THIS FILE
4	---------------------
5
6	* Introduction
7	* Installation
8	* Usage
9
10
11	INTRODUCTION
12	------------
13
14	Author:
15	* Shai Yallin (electricmonk)
16
17	Module development has been sponserd by Ewave (http://www.ewave.co.il)
18
19	ASM Select (http://code.google.com/p/jquery-asmselect/) is a progressive enhancement
20	to <select multiple> form elements. It provides a simpler alternative with the following
21	advantages:
22
23	* Easier for users to understand and interact with than regular <select multiple> form
24	elements. Users know how to interact with it sans instruction.
25
26	* Doesn't require user to Ctrl-Click or Shift-Click multiple elements. Instead users of
27	your form can add or remove elements individually, without risk of losing those that
28	have already been selected.
29
30	* Selected elements are always visible (within the confines of your interface) while
31	unselected elements are always hidden (within a regular <select>).
32
33	* Unlike regular <select multiple> option elements, those on asmSelect are optionally
34	sortable with drag and drop (this part requires jQuery UI).
35
36	* asmSelect hides, maintains and updates the original <select multiple> so that no
37	changes are required to existing code.
38
39	* If a user does not have javascript, then of course the regular <select multiple> form
40	element is used instead.
41
42	* If the original <select multiple> form element is modified by some other jQuery or
43	javascript code, the change will be reflected in the asmSelect as well.
44
45	This module adds a new CCK Node Reference widget option (in addition to Select and Auto
46	Complete) which seamlessly integrates ASM support into all Drupal forms.
47
48
49	INSTALLATION
50	------------
51
52	1. Copy the nodereference_asmselect module directory to your sites/SITENAME/modules
53	directory.
54
55	2. Download ASM Select from http://code.google.com/p/jquery-asmselect/ (last known version
56	to work is 1.02 beta)
57
58	3. Extract it as a sub-directory called 'asmselect' in the module folder:
59
60	/sites/all/modules/nodereference_asmselect/asmselect/
61
62	4. Enable the module at Administer >> Site building >> Modules.
63
64
65	USAGE
66	-----
67
68	Create a CCK Node Reference field and choose ASM Select as the form widget. You can then
69	control the different settings of yoru widget. The JQuery UI Module
70	(http://drupal.org/project/jquery_ui) is required in order to use the sort feature.