=== Searchcraft ===
Donate link: https://searchcraft.io/
Contributors: searchcraft
Tags:         search, fuzzy search, better search, instant search, custom search
Requires at least: 5.3
Tested up to: 7.0
Stable tag:   1.5.1
License:      Apache 2.0
License URI:  LICENSE.txt

Bring fast, relevant search to your site. Searchcraft replaces the default search with a customizable, tunable, highly relevant search experience.


== Description ==
Searchcraft brings fast, relevant search to your site. You can choose between a near-instant keyword search or utilize AI to generate post summaries that are powered by your own content. Searchcraft doesn't add any bloat to your database, it's index data is stored remotely and is designed to be a drop-in replacement for the default search.

https://www.youtube.com/watch?v=22PixVQpsSU

== Features ==

* Fast, relevant search that can scale to hundreds of millions of posts.
* Drop-in replacement for default search.
* Instant results.
* Choose which content is searchable and which to exclude. Supports both posts and pages.
* Supports custom taxonomy and author plugins.
* Multiple layout options including full page, modal, and inline search experiences.
* Highly configurable filter panel with collapsible sections and faceted search.
* Customizable search fields and weighting.
* Custom result templates for full control over search result markup.
* Synonyms (configured via Searchcraft Cloud).
* Stopwords (configured via Searchcraft Cloud).
* Optional AI summaries using your content (via a Searchcraft Cloud paid plan).
* Search analytics (via Searchcraft Cloud).
* Import and export settings to simplify migrations between environments.
* Works with Searchcraft Cloud or self-hosted Searchcraft Core.

== Installation ==

1. Create an account on [Searchcraft Cloud](https://vektron.searchcraft.io/) via the Vektron dashboard.
2. Within Vektron, follow onboarding steps to create a new application and index, selecting the "Wordpress" template on index creation. Copy the provided endpoint url, index name, ingest key and read key values.
3. Activate the plugin in WordPress.
4. Within Wordpress navigate to the Searchcraft settings page and fill in the cluster url, API keys and index name.
5. That's it! Searchcraft will automatically prepare your post content for search.

== Frequently Asked Questions ==

= How does Searchcraft work? =

The Searchcraft plugin is a drop-in replacement for the default search experience on WordPress. It is intended to be used with the Searchcraft Cloud SaaS service. Functionally, it will work with self-hosted Searchcraft instances but it will require manual configuration on the Searchcraft Core engine side.

= Can I use Searchcraft with WooCommerce? =

Woocommerce is not supported with the Searchcraft plugin at this time, this plugin is intended for use with standard WordPress posts.

= Can I use the Searchcraft plugin with custom post types? =

Yes! Custom post types and custom taxonomy are both supported.

= How do I use the Searchcraft plugin with multiple domains? =

If you are hosting WordPress in a multi-environment setting (eg, live and staging) you should setup an index for both domains.

= If I want to self-host Searchcraft Core to use with the Searchcraft plugin, what do I need to do? =

Contact the Searchcraft team on our [Discord server](https://discord.gg/y3zUHkBk6e) and we can help! For self-hosted Searchcraft Core there are support plans available.

= Where can I find the Searchcraft plugin documentation? =

Documentation for the Searchcraft plugin can be found on our [developer documentation](https://docs.searchcraft.io/).

= I would like to report a bug or request a feature =

If you would like to report an issue or suggest an enhancement you may contact the team on our [issues GitHub repository](https://github.com/searchcraft-inc/searchcraft-issues). We do not provide support on the WordPress.org forums.

Searchcraft Cloud customers may also reach out via our Discord server for assistance or to request a custom feature.

== Changelog ==

= 1.5.1 =
* Performance - Searchcraft stylesheets are now loaded as non-render-blocking resources using the browser preload API, improving page load performance.

= 1.5.0 =
* New Feature - Analytics Overview tab with Daily Active Users, Monthly Active Users, Total Articles, Search Volume chart, and Popular Search Terms table.
* New Feature - Re-sync all and delete all index management controls moved to dedicated Documents tab.
* Searchcraft PHP client upgraded to 0.8.1
* WordPress 7.0 compatibility
* Bugfix - Allow access to import/export settings tab when an install is unconfigured.

= 1.4.0 =
* Updated internal JavaScript SDK usage to 0.15.1.
* Updated internal Searchcraft PHP client to 0.8.0.
* New Feature - AI results summary component is now available within the modal search experience when enabled in the plugin config.
* New Feature - Modal footer background color is now configurable from the layout settings.
* New Feature - Spacing and color styles for search forms are now available to both inline and modal experiences, not just the full experience.
* Improvement - Removed deprecated Cortex URL settings in favor of the unified cluster URL configuration.
* Bugfix - Fixes issue where searching with quotes in the full experience and sending to a results page could cause issues.
* Enhancement- UTM parameters attribution.

Important upgrade note: If you are currently using AI search summaries via the stand alone Cortex service you will need to update your settings in the AI tab within the Vektron dashboard before upgrading your plugin.

= 1.3.7 =
* Updated internal SDK usage to 0.14.0.
* New Feature - Changes the search experience options from full/popover to full/modal/inline. Installs that previously used 'popover' will be migrated to 'modal'.
* New Feature - Inline and modal variants now have a "view all results" option.
* New Feature - New configuration option to control result items in the inline and modal experiences separately from the results per page on the results page.

= 1.3.6 =
* New Feature - Filter panel facet sections are now collapsible and have a configuration option to set the default behavior.
* New Feature - Added "view more" for long filter panel facet lists. The threshold for when this takes effect is configurable.

= 1.3.5 =
* Enhancement - Adds capability for tag based (non-hierarchical) taxonomies to add an additional search field for the values as a multi-value field. This allows search queries to match against these tag names. Works with both stock and custom tag taxonomies.

= 1.3.4 =
* Enhancement - Invalid configuration values don't prevent post publishing, they now just throw a notice.
* Bugfix - Strip out embedded HTML from custom fields sent into search index.
* Bugfix - Get oldest date of any published content not just posts for date range options.
* Bugfix - Fix unexpected date shift in query sent on paginated requests.

= 1.3.3 =
* Bugfix - Fix race condition on first time initialization.

= 1.3.2 =
* New Feature - Adds a search field to filter and locate custom fields in the configuration modal.
* New Feature - Add ability to override the excerpt shown in search results for custom types with a custom field value.

= 1.3.1 =
* Bugfix - Fixes issue where going back from clicking a search result to the results page inserted an encoded space instead of an actual space value into the input.
* Bugfix - Fixes issue where filter taxonomy was interfering with the default post type checkbox in admin configuration tab.

= 1.3.0 =
* New Feature - You can now import and export settings to ease migrations between environments.
* New Feature - Add ability to exclude stock page and post content types. This is useful for sites that only want custom types in search.
* New Feature - Adds a unique content type class per search result to allow targeting CSS for that type.
* New Feature - Adds ability to exclude the stock category taxonomy.
* New Feature - Field selection modal for custom type fields. Now you can select only the fields you need for your index schema.
* New Feature - Additional search requests on results page now update the query string parameter in the url.
* New Feature - Ability to show/hide author name on results.
* New Feature - Additional data attributes added to default result template to allow developer customizations.
* Improvement - Improves spacing of several elements in desktop and mobile layouts.

= 1.2.2 =
* Minor bugfixes

= 1.2.1 =
* Bugfix - Filter panel start date bug.

= 1.2.0 =
* New Feature - Add support for Molongui Authorship authors
* New Feature - Add support to add search input to multiple elements on a page when "send to search page" option is used
* New Feature - Add option to retain stock get_search_form under advanced options
* Improvement - Added cache control headers to reduce browser caching issues after plugin updates
* Updates Searchcraft JavaScript SDK to v0.13.2

= 1.1.3 =
* Additional bugfixes

= 1.1.2 =
* Bugfix - option check for PublishPress authors.

= 1.1.1 =
* New Feature - Custom post type and custom fields support is here! If you have a custom type you can now add it to the same search index as the standard WordPress post type. You can also optionally include custom fields from these types.
* New Feature - Filter panel items are now re-orderable.
* New Feature - Search requests now differentiate between signed in and signed out users.
* New Feature - Filter label colors are now editable via layout GUI.
* Updates Searchcraft JavaScript SDK to v0.13.1
* Bugfix - option check for PublishPress authors.
* Bugfix - Precision fix for float values ending with zeros (via Searchraft PHP client update).
* WP 6.9 compatibility.

= 1.1.0 =

* Adds support for multiple authors on a post and and a configuration option for using PostPublish authors instead of the stock WP authors if the plugin is present.

= 1.0.3 =

* Update Searchcraft JavaScript SDK to v0.12.2 (related to facet exclusion feature)
* Add ability to exclude "Uncategorized" category facet from the search filter panel.

= 1.0.2 =

* Memory usage optimization for systems with large amounts of posts and small memory allocated to PHP

= 1.0.1 =

* Update Searchcraft JavaScript SDK to v0.12.1
* Layout configuration screen is now a single form with a unified save button
* Added ability to choose a DOM elemnent by ID to inject the search form into. This overrides the default auto-detect behavior when used.
* Additional layout customization options and more color settings.
* Support for initialQuery.
* Added additional layout advanced options and support for submitting to the stand alone WordPress search page.
* Added documentation link for custom result templates.
* Added support to choose between column and grid layouts, hiding showing primary category and pub date without needing a custom result template.
* Filter panel and summary box customization features.
* Re-arranged layout admin tab to group AI summary settings together.
* Made first load of overview tab more intuitive.
* Support for custom taxonomies as facet fields.
* General bug-fixes and improvments.

= 1.0.0 =

* Initial release. Uses Searchcraft JavaScript SDK v0.11.1 and Searchcraft PHP Client v0.7.5

== External services ==

This plugin connects to an API either hosted by Searchcraft, Inc. or self-hosted by the user. Post and Page content is sent to the API for indexing on an opt-in basis. No user data or site content is shared with any third parties.
