[%#-
     Autocompletion

  This template enables auto completion for input fields.
  Calling Syntax is:

    INCLUDE 'generic/autocomplete', [
      { SPEC_1 },
      { SPEC_2 },
      ...
    ]

  where SPEC is a hash containing the following keys:

   script   : the script that is called for autocompletion, defaults to the invoking script
   action   : action in the ajax script, defaults to 'ajax_autocomplete'
   selector : a jquery selector, specifying the input fields
   column   : specifies the column that is represented by the bound field. typically description or name.
   params   : additional params that should be included in the request, like customer/vendor information. expects a hash.

  TODO FIELDS:
   - addition fields like type, vc etc.
   - additional dependencies, see jquery.autocomplete documentation
   - hook function on select, again see jquery documentation
   - limit: maximum number of results shown.

  a simple SPEC would look like this:

   { selector => '#description', column => 'description' }
     # field with id="description" should be autocompleted with descriptions

   { script => 'ic.pl', selector => '[name^="partnumber_"]', column => 'partnumber' }
     # let ic.pl autocomplete by partnumbers, bind this to all fields where the name begins with "partnumber_"



    The Backend Side

  The called function will recieve the queried string as hashkey "q" in form, as well as every other param specified here.
  It should generate a generic ajax header (see form), followed by newline separated list of possible completion values.

%]
<script type='text/javascript'>
[%- FOREACH token = AUTOCOMPLETES %]
[%- DEFAULT token.script         = script              %]
[%- DEFAULT token.action         = 'ajax_autocomplete' %]
[%- DEFAULT token.INPUT_ENCODING = 'utf8'              %]
[%- FOREACH key = token.params.keys %]
[%- token.additional_url = token.additional_url _ '&' _ key _ '=' _ token.params.$key %]
[%- END %]
[%- token.url = token.script
              _ '?action=' _ token.action
              _ '&INPUT_ENCODING=' _ token.INPUT_ENCODING %]
[%- SET token.url = token.url _ '&column=' _ token.column IF token.column %]
[%- SET token.url = token.url _ token.additional_url IF token.additional_url %]
$(document).ready( $('[% token.selector %]').autocomplete('[% token.url %]'));
[%- END %]
</script>