
-- SUMMARY --

The Simple hierarchical select module displays selected taxonomy fields as
hierarchical selects on node creation/edit forms and as exposed filter in views.


-- REQUIREMENTS --

Taxonomy module (Drupal core) needs to be enabled.


-- INSTALLATION --

* Install as usual, see http://drupal.org/documentation/install/modules-themes/modules-7
  for further information.


-- CONFIGURATION --

* Create a new field (type "Term reference") and select
  "Simple hierarchical select" as widget type.

* Field settings
  - "Allow creating new terms"
    Terms may be created directly from within the dropdowns (user needs to have
    permission to create terms in the vocabulary).
  - "Allow creating new levels"
    If selected users with permission to create terms in the vocabulary will be
    able to create a new term as child of the currently selected term.
  - "Force selection of deepest level"
    Force users to select terms from the deepest level.

* Views (exposed filter)
  - add a new filter using the field set-up as "Simple hierarchical select" or
    use "Content: Has taxonomy terms (with depth; Simple hierarchical select)"
    as a new filter
  - use "Simple hierarchical select" as selection type
  - select "Expose this filter to visitors, to allow them to change it"
  - enjoy :)


-- INTEGRATION WITH OTHER MODULES --

* Chosen (http://drupal.org/project/chosen)
  - If you have installed the module "Chosen" (>= 7.x-2.x) all elements of
    "Simple hierarchical select" are modified, so the user can search for items
    within the list. See http://drupal.org/project/chosen for more information.
  - If you have configured "Chosen" to apply always but do not want to apply it
    to the dropdowns created by "Simple hierarchical select" you may use the
    following CSS selector in the "Chosen" configuration:
    <code>select:visible:not(.shs-select)</code>
  - Apart from that you can select whether to use chosen on a per-field base by
    setting the option "Output this field with Chosen" in the field
    configuration.
    - "let chosen decide"
      The field is modified by Chosen if it matches the Chosen configuration.
    - "always"
      The field is always modified by Chosen.
    - "never"
      The field is not modified by Chosen even if it matches the Chosen
      configuration.

* High-performance JavaScript callback handler (http://drupal.org/project/js)
  - If you have lots of terms and a huge hierarchy you could increase the
    performance of "Simple hierarchical select" by installing "JS". It routes
    all javascript callbacks needed by "Simple hierarchical select" through a
    custom handler to avoid loading of all Drupal functions and speed up
    loading.

* Entity reference (https://www.drupal.org/project/entityreference)
  - "Simple hierarchical select" works out of the box with simple entity
    reference fields. In case you use Views as entity selection mode for your
    field there may be some problems, though.
    Your reference view needs at least one filter for the vocabulary. Otherwise
    "Simple hierarchical select" has no chance to retrieve the list of possible
    options to display.
    More complex reference views may cause "Simple hierarchical select" to fail,
    so its best to keep it as simple as possible.


-- CONTACT --

Current maintainers:
* Stefan Borchert (stborchert) - http://drupal.org/user/36942

This project has been sponsored by:
* undpaul
  Drupal experts providing professional Drupal development services.
  Visit http://www.undpaul.de for more information.

