Title: List Item Filter
Author: zachwtx
Published: <strong>October 14, 2016</strong>
Last modified: December 2, 2016

---

Search plugins

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.

![](https://ps.w.org/list-item-filter/assets/icon-256x256.png?rev=1515037)

# List Item Filter

 By [zachwtx](https://profiles.wordpress.org/zachwtx/)

[Download](https://downloads.wordpress.org/plugin/list-item-filter.1.4.zip)

 * [Details](https://sa.wordpress.org/plugins/list-item-filter/#description)
 * [Reviews](https://sa.wordpress.org/plugins/list-item-filter/#reviews)
 *  [Installation](https://sa.wordpress.org/plugins/list-item-filter/#installation)
 * [Development](https://sa.wordpress.org/plugins/list-item-filter/#developers)

 [Support](https://wordpress.org/support/plugin/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

![](https://secure.gravatar.com/avatar/44d246b54cc8b38cc59f183ee903cdbe95c2705c9aaa4aea6ae4a2280eb31abf?
s=60&d=retro&r=g)

### 󠀁[I find it usefull](https://wordpress.org/support/topic/i-find-it-usefull/)󠁿

 [andrew72nd](https://profiles.wordpress.org/andrew72nd/) 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 ](https://wordpress.org/support/plugin/list-item-filter/reviews/)

## Contributors & Developers

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

Contributors

 *   [ zachwtx ](https://profiles.wordpress.org/zachwtx/)

[Translate “List Item Filter” into your language.](https://translate.wordpress.org/projects/wp-plugins/list-item-filter)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/list-item-filter/),
check out the [SVN repository](https://plugins.svn.wordpress.org/list-item-filter/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/list-item-filter/)
by [RSS](https://plugins.trac.wordpress.org/log/list-item-filter/?limit=100&mode=stop_on_copy&format=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

## Meta

 *  Version **1.4**
 *  Last updated **9 वर्षाः ago**
 *  Active installations **10+**
 *  WordPress version ** 2.5 or higher **
 *  Tested up to **4.6.30**
 *  Language
 * [English (US)](https://wordpress.org/plugins/list-item-filter/)
 * Tags
 * [filter](https://sa.wordpress.org/plugins/tags/filter/)[javascript](https://sa.wordpress.org/plugins/tags/javascript/)
   [list](https://sa.wordpress.org/plugins/tags/list/)[search](https://sa.wordpress.org/plugins/tags/search/)
   [shortcode](https://sa.wordpress.org/plugins/tags/shortcode/)
 *  [Advanced View](https://sa.wordpress.org/plugins/list-item-filter/advanced/)

## Ratings

 5 out of 5 stars.

 *  [  1 5-star review     ](https://wordpress.org/support/plugin/list-item-filter/reviews/?filter=5)
 *  [  0 4-star reviews     ](https://wordpress.org/support/plugin/list-item-filter/reviews/?filter=4)
 *  [  0 3-star reviews     ](https://wordpress.org/support/plugin/list-item-filter/reviews/?filter=3)
 *  [  0 2-star reviews     ](https://wordpress.org/support/plugin/list-item-filter/reviews/?filter=2)
 *  [  0 1-star reviews     ](https://wordpress.org/support/plugin/list-item-filter/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/list-item-filter/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/list-item-filter/reviews/)

## Contributors

 *   [ zachwtx ](https://profiles.wordpress.org/zachwtx/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/list-item-filter/)