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 #548
    In the 548th issue of ProcessWire Weekly we're going to check out a couple of new third party modules, introduce the latest ProcessWire core updates, and more. Read on!
    Weekly.pw / 9 November 2024
  • Custom Fields Module
    This week we look at a new ProFields module named Custom Fields. This module provides a way to rapidly build out ProcessWire fields that contain any number of subfields/properties within them.
    Blog / 30 August 2024
  • Subscribe to weekly ProcessWire news

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