TextInputAwesomplete by macrura

Enables autocomplete configured text inputs.

Text Input Awesomplete

Key Points:

Uses Awesomplete JS library for instantiating autocomplete suggestions on text input fields in Processwire CMS.

Supports any text field, including Page Title (FieldtypePageTitle).

Allows admins to configure a list of suggestions (textarea input), or pull suggestions from Processwire pages, by configuring which pages to pull from and which field's value to use.

Table of Contents


About Awesomplete


https://leaverou.github.io/awesomplete/

https://github.com/LeaVerou/awesomplete

Benefits & Uses


Can be helpful for fields where users may need to enter the same text in the same field on multiple pages, and you can't or don't want to use a Page Reference field. One example could be a site where you send emails using various boilerplate subjects; Another place to use this would be if you had an existing site with a text field that has some inconsistency when same values are added. The autocomplete would help editors to always use the same format as the other pages with the same value.

Installation


Upload or install from Modules directory.

Usage & Configuration


Once installed, on any text input field (including Page Title), you will see an option to enable autocomplete.

Once enabled you will have the option to type a list of items for autocomplete suggestions, or enable the module to search pages for suggestions.

Note that if you enter any items in the Items List field, those will always be part of the autocomplete suggestions, in addition to pages if configured.

If you elect to use pages for the suggestions, you have these options:

  • Choose a template to limit by (adds a template=sometemplate to the pages find selector).

  • Override which field to pull suggestions from (by default it will use the field you are configuring). Sets the $field!= in the selector.

  • Setup a Selector for finding the pages for the autocomplete suggestions.

    – This overrides the template selected. – Note that the selector needs to return pages that use the field being configured, or the field selected for override.

Support


ProcessWire Support Thread

https://processwire.com/talk/topic/21697-textinputawesomplete/

Contributing


Please contribute using Github Flow. Create a branch, add commits, and open a pull request.

Install and use modules at your own risk. Always have a site and database backup before installing new modules.

Latest news

  • ProcessWire Weekly #520
    In the 520th issue of ProcessWire Weekly we'll check out some of the latest additions to the ProcessWire module's directory, share some highlights from the latest weekly update from Ryan, and more. Read on!
    Weekly.pw / 27 April 2024
  • ProFields Table Field with Actions support
    This week we have some updates for the ProFields table field (FieldtypeTable). These updates are primarily focused on adding new tools for the editor to facilitate input and management of content in a table field.
    Blog / 12 April 2024
  • Subscribe to weekly ProcessWire news

I just love the easy and intuitive ProcessWire API. ProcessWire rocks!” —Jens Martsch, Web developer