You are here

Home » API reference » Multiselect 8

README.txt in Multiselect 8

Same filename and directory in other branches
  1. 6 README.txt
  2. 7 README.txt
  3. 2.x README.txt
CONTENTS OF THIS FILE
---------------------

 * Introduction
 * Requirements
 * Installation
 * Configuration
 * Maintainers


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

The Multiselect module defines a widget to be used with CCK fields. It allows
the user to select multiple items in an easy way. It consists of two lists, one
of all available items, the other of selected items. The user can select an item
by moving it from the unselected list to the selected list.

 * For a full description of the module visit:
   https://www.drupal.org/project/multiselect

 * To submit bug reports and feature suggestions, or to track changes visit:
   https://www.drupal.org/project/issues/multiselect


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

This Multiselect module requires no modules outside of Drupal core.


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

 * Install the Multiselect module as you would normally install a contributed
   Drupal module. Visit https://www.drupal.org/node/1897420 for further
   information.


CONFIGURATION
-------------

    1. Navigate to Administration > Extend and enable the module.
    2. Navigate to Administration > Configuration > Content authoring >
       Multiselect to configure how multiselect fields are displayed to content
       editors.
    3. Select the width of Select Boxes (in pixels). Save configuration.
    4. Navigate to Content types > Content type to add field to > Manage fields
    5. Add new field of type List, List (Text), List (Number), Node reference,
       Taxonomy term reference, and User reference.
    6. Navigate to Manage form display > Select Multiselect as the field
       widget. Save configuration.

Methods of Implementing a Multiselect Widget:

Method 1: Using CCK
When creating a new content field, select "Multiselect" as your widget type. You
can use Multiselect on fields of type "list", "list_text", "list_number",
"node_reference", "taxonomy_term_reference", and "user_reference".

Method 2: Coding Your Own Module
If you're developing a custom module and wish to use the Multiselect widget in
place of a traditional "select" widget, you may use the Drupal 8 Form API.


MAINTAINERS
-----------

 * Adam Bergstein (nerdstein) - https://www.drupal.org/u/nerdstein
 * Mark W. Jarrell (attheshow) - https://www.drupal.org/u/attheshow
 * Alex Weber (alexweber) - https://www.drupal.org/u/alexweber

Supporting organizations:

 * Drupal 8 porting support: CivicActions - https://www.drupal.org/civicactions
 * Drupal 6, 7, & 8 support (attheshow): FleetThought -
   https://www.drupal.org/fleetthought
 * Module maintenance: Hook 42 - https://www.drupal.org/hook-42

File

README.txt
View source 
  1. CONTENTS OF THIS FILE

  2. ---------------------

  3. 

  4.  * Introduction

  5.  * Requirements

  6.  * Installation

  7.  * Configuration

  8.  * Maintainers

  9. 

  10. 

  11. INTRODUCTION

  12. ------------

  13. 

  14. The Multiselect module defines a widget to be used with CCK fields. It allows

  15. the user to select multiple items in an easy way. It consists of two lists, one

  16. of all available items, the other of selected items. The user can select an item

  17. by moving it from the unselected list to the selected list.

  18. 

  19.  * For a full description of the module visit:

  20.    https://www.drupal.org/project/multiselect

  21. 

  22.  * To submit bug reports and feature suggestions, or to track changes visit:

  23.    https://www.drupal.org/project/issues/multiselect

  24. 

  25. 

  26. REQUIREMENTS

  27. ------------

  28. 

  29. This Multiselect module requires no modules outside of Drupal core.

  30. 

  31. 

  32. INSTALLATION

  33. ------------

  34. 

  35.  * Install the Multiselect module as you would normally install a contributed

  36.    Drupal module. Visit https://www.drupal.org/node/1897420 for further

  37.    information.

  38. 

  39. 

  40. CONFIGURATION

  41. -------------

  42. 

  43.     1. Navigate to Administration > Extend and enable the module.

  44.     2. Navigate to Administration > Configuration > Content authoring >

  45.        Multiselect to configure how multiselect fields are displayed to content

  46.        editors.

  47.     3. Select the width of Select Boxes (in pixels). Save configuration.

  48.     4. Navigate to Content types > Content type to add field to > Manage fields

  49.     5. Add new field of type List, List (Text), List (Number), Node reference,

  50.        Taxonomy term reference, and User reference.

  51.     6. Navigate to Manage form display > Select Multiselect as the field

  52.        widget. Save configuration.

  53. 

  54. Methods of Implementing a Multiselect Widget:

  55. 

  56. Method 1: Using CCK

  57. When creating a new content field, select "Multiselect" as your widget type. You

  58. can use Multiselect on fields of type "list", "list_text", "list_number",

  59. "node_reference", "taxonomy_term_reference", and "user_reference".

  60. 

  61. Method 2: Coding Your Own Module

  62. If you're developing a custom module and wish to use the Multiselect widget in

  63. place of a traditional "select" widget, you may use the Drupal 8 Form API.

  64. 

  65. 

  66. MAINTAINERS

  67. -----------

  68. 

  69.  * Adam Bergstein (nerdstein) - https://www.drupal.org/u/nerdstein

  70.  * Mark W. Jarrell (attheshow) - https://www.drupal.org/u/attheshow

  71.  * Alex Weber (alexweber) - https://www.drupal.org/u/alexweber

  72. 

  73. Supporting organizations:

  74. 

  75.  * Drupal 8 porting support: CivicActions - https://www.drupal.org/civicactions

  76.  * Drupal 6, 7, & 8 support (attheshow): FleetThought -

  77.    https://www.drupal.org/fleetthought

  78.  * Module maintenance: Hook 42 - https://www.drupal.org/hook-42