This plugin hasn’t been tested with the latest 3 major releases of WordPress. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress.

List Item Filter

Description

This plugin provides a shortcode that generates a text input field, which filters out list items that do not contain that field’s text. Any sibling elements of the shortcode, or children of those siblings, that are “li” elements will be searched by the text field it generates. As you type, each word in the text field is matched against the readable text of the list items (and optionally their title attributes). Any list items which don’t match that text are hidden.

Example: [list_item_filter placeholder="Filter this list by terms" searchtitles="true"]

Shortcode parameters:

  • label (string): Define the search field’s label text. Default value: Filter list items:
  • showlabel (boolean): Determine whether or not the search field’s label is visible. Default value: true
  • placeholder (string): Define the search field’s placeholder text. Default value: Search
  • noresultsmsg (string): Define the message shown when no list items are found. Provide an empty string to disable this feature. Default value: no results
  • searchtitles (bool): Expand text matching to include the first title attribute of the list item’s HTML. Default value: false
  • formclass (string): Define one or more class names for the form. Default value: search-form
  • inputclass (string): Define one or more class names for the search field. Default value: search-field

If you like this plugin or have a request, let me know!

Installation

Upload the plugin to your blog, activate it, then use the shortcode in a page or post!

Reviews

April 21, 2017
I used it in a internal server webpage to ease the content finding in some long lists. One thing I noticed: when I erase the searching key-phrase it shows the full list. when I click on the x button it shows only the filtered results. I would expect to show the full list since it erases the key-phrase. but it's working nce!
Read all 1 review

Contributors & Developers

“List Item Filter” is open source software. The following people have contributed to this plugin.

Contributors

Translate “List Item Filter” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

Version 1.4

  • Add label parameter for defining label text
  • Show search field label
  • Add showlabel parameter to allow users to hide the search field label
  • Add magnifying glass icon to search box to improve accessibility
  • Add aria-describedby text to search box to improve accessibility, informing screen reader users of what will happen to the page’s content when they type in the box

Version 1.3

  • Fix text input case matching issue

Version 1.2

  • Add label to search field to improve accessibility
  • Add notes to Javascript
  • Improve readability of documentation
  • Add tags

Version 1.1

  • Add message informing users that no items were found that matched their text
  • Add noresultsmsg parameter so users can customize the text displayed when no matching items are found
  • Rename data attribute for searchtitles parameter
  • Add class names to items for show and hide states
  • Change visibility manipulation to remove inline styling in favor of a stylesheet

Version 1.0

  • Provide shortcode parameters for class names, placeholder text, and searching title attributes
  • Refactor Javascript to allow multiple instances per page
  • Ensure Javascript file is only added to page when shortcode is in use
  • Add support for IE9 placeholder attribute