=== ACF: Better Search ===
Contributors: mateuszgbiorczyk
Donate link: https://www.paypal.me/mateuszgbiorczyk/
Tags: acf, acf search, advanced custom fields, better search, search
Requires at least: 4.7.0
Tested up to: 5.2
Requires PHP: 5.6
Stable tag: trunk
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

This plugin adds to default WordPress search engine the ability to search by content from selected fields of Advanced Custom Fields plugin.

== Description ==

This plugin adds to default WordPress search engine the ability to search by content from selected fields of Advanced Custom Fields plugin.

Everything works automatically, no need to add any additional code.

Additionally you can search for whole phrases instead of each single word of phrase. As a result, search will be more accurate than before.

**New search core:** We modified the code of search engine. Content search is now faster by about 75% (depending on the level of complexity of searched phrase)!

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/acf-better-search` directory, or install plugin through the WordPress plugins screen directly.
2. Activate plugin through `Plugins` screen in WordPress Admin Panel.
3. Use `Settings -> ACF: Better Search` screen to configure the plugin.

== Frequently Asked Questions ==

= How does this work? =

Plugin changes all SQL queries by extending the standard search to selected fields of Advanced Custom Fields.

= Where working advanced search? =

It works for WP_Query class.

= Do I need to add some arguments to my function to activate advanced search? =

Everythings works automatically. For custom WP_Query loop and get_posts() function also if you add [Search Parameter](https://codex.wordpress.org/Class_Reference/WP_Query#Search_Parameter).

= Whether the plugin works in the admin panel? =

Yes. The plugin works same as for the search page.

= In what fields does the plugin search? =

Our plugin supports the following fields: Text, Text Area, Number, Email, Url, File, Wysiwyg Editor, Select, Checkbox and Radio Button. All these fields may be located in both the Repeater or Flexible Content field.

= How does searching for whole phrases? =

The default search in WordPress is to search for each of words listed. This feature allows you to search for occurrences of the whole phrase entered in the search field without word division.

= How does Lite mode work? =

In this mode, the plugin does not check the field types. Phrases are searched in all ACF fields. Thanks to this, the query to the database is smaller and faster by about 25%. However, we do not have control over which fields are taken into account when searching.

= What version of Advanced Custom Fields is supported? =

Advanced Custom Fields in version 5 (also free). ACF below version 5 has a different data structure in database and is not supported.

== Screenshots ==

1. Screenshot of the options panel

== Changelog ==

= 3.3.1 =
* Security changes

= 3.3.0 =
* New settings page
* New admin notice

= 3.2.0 =
* Changes in plugin structure
* New mode to ability using only selected fields for searching
* Filters to extend plugin capabilities

= 3.1.3 =
* Full path for loaded PHP files

= 3.1.2 =
* Support for free version of ACF 5

= 3.1.1 =
* Default hidden admin notice

= 3.1.0 =
* Improved search engine
* Support for AUTO_INCREMENT field in database other than 1
* Possibility of permanent turn off admin notice
* Modifications on settings page

= 3.0.1 =
* Withdrawal of support for old WordPress versions
* Minor fixes

= 3.0.0 =
* Search in admin panel
* Support for get_posts() function
* Support for internationalization
* Changes in plugin structure

= 2.2.0 =
* Cleaning database after removing plugin

= 2.1.3 =
* Compatibility fix for Polylang plugin

= 2.1.2 =
* Support for File type field

= 2.1.1 =
* Modification of admin notice

= 2.1.0 =
* Faster search using lite mode
* Improved PHP code

= 2.0.7 =
* Turn off plugin core while searching uploads media items

= 2.0.6 =
* Support for WordPress Multisite

= 2.0.5 =
* Changed closing notice in admin panel

= 2.0.4 =
* Support for WP AJAX
* Changed access to settings page

= 2.0.3 =
* Improved text search with apostrophe and quotation marks

= 2.0.2 =
* Withdrawal of support for get_posts()

= 2.0.1 =
* Fixes for PHP 7

= 2.0.0 =
* Improved search engine
* The ability to search whole phrases
* Changed plugin settings page
* Notifications in admin panel

= 1.0.0 =
* The first stable release

== Upgrade Notice ==

None.