README.txt 2.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354
  1. Search API autocomplete
  2. -----------------------
  3. Adds autocomplete capabilities for Search API searches.
  4. Information for users
  5. ---------------------
  6. - Necessary server feature
  7. The server on which the search will be executed has to support the
  8. "search_api_autocomplete" feature in order for autocompletion to work. Searches
  9. on other servers won't be affected by this module.
  10. Currently, only the Solr service class [1] is known to support this feature.
  11. [1] http://drupal.org/project/search_api_solr
  12. - Necessary setup
  13. After having installed and enabled the module, you have to do some
  14. administrative steps to activate the autocomplete functionality. Autocompletion
  15. can be enabled and configured for each search separately.
  16. To activate autocompletion for an index's searches, go to the index's
  17. „Autocomplete“ tab. There, you see all available searches for the index and can
  18. enable (and afterwards configure) autocompletion for each of them. All fulltext
  19. key fields on the searches should then become autocompletion fields.
  20. - Supported searches
  21. Currently, only search forms built by search pages or search views are
  22. supported directly. However, other modules can easily also use this
  23. functionality. See the "Information for developers" for details.
  24. Information for developers
  25. --------------------------
  26. - Supporting autocompletion with a service class
  27. To support autocompletion with a service class, the class has to support the
  28. "search_api_autocomplete" feature. This will necessitate the service class to
  29. have a getAutocompleteSuggestions() method as detailed in the interface in
  30. search_api_autocomplete.interface.php.
  31. - Supporting autocompletion on a search form
  32. If you have a search form not generated by the Search views or Search pages
  33. modules, you can use hook_search_api_autocomplete_types() to tell this module
  34. about it. For details, see the hook documentation in the
  35. search_api_autocomplete.api.php file, or look at the existing implementations
  36. in search_api_autocomplete.search_api_page.inc and
  37. search_api_autocomplete.search_api_views.inc.