=== Datalumo ===
Contributors: jeffreyvanrossum
Tags: search, semantic search, ai search, woocommerce, sync
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.1
Stable tag: 0.1.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Sync your WordPress content into a Datalumo index and optionally power native site search with semantic results.

== Description ==

Datalumo connects your WordPress site to a Datalumo index. It keeps your content in sync and can take over the native WordPress search to return semantic, relevance-ranked results — with full WooCommerce support.

**Features**

* Pick an existing Datalumo index and search app from your settings.
* Choose which post types, taxonomies and meta fields get indexed (sensible defaults: Posts, all public taxonomies, no meta).
* Real-time sync — posts are upserted or removed from the index as they are published, updated, trashed or deleted.
* Bulk reindex of all existing content, built to scale to large sites.
* Optional native search takeover: maps semantic results back to your posts, with working pagination and ordering.
* WooCommerce-aware: catalog sorting (price, popularity, rating), category/attribute filters, the price-range widget, and exclude-from-search visibility are all respected.

Content sync and search both run against your own Datalumo instance, configured with an API key and base URL.

== Installation ==

1. Upload the `datalumo` folder to `/wp-content/plugins/`, or install the plugin through the Plugins screen.
2. Activate the plugin through the **Plugins** screen.
3. Go to **Settings → Datalumo** and enter your API key and base URL, then click **Test connection**.
4. Select the index to sync into and the app to search against.
5. Choose your post types (and optionally meta fields), then save.
6. Click **Reindex all content** to perform the first full sync.
7. Optionally enable **Native search** to replace WordPress search with Datalumo results.

== Frequently Asked Questions ==

= Does it work without WooCommerce? =

Yes. WooCommerce-specific behaviour (catalog sorts, product filters, price widget, visibility) only loads when WooCommerce is active. On a regular site, post type and taxonomy filtering still apply.

= How are search results paginated? =

Datalumo returns a single ranked pool of results (the "Max results" setting). The plugin resolves those to posts and paginates them locally across your normal page size. Increase Max results for a deeper pool.

= How do large sites get indexed? =

The bulk reindex runs as a single self-chaining background job that walks posts by ascending ID, so it stays light even with hundreds of thousands of posts. Action Scheduler handles the queue.

= Can I customise what gets indexed or how search is filtered? =

Yes, via filters: `datalumo_item`, `datalumo_searchable_text`, `datalumo_item_metadata`, `datalumo_search_filter`, `datalumo_search_request`, `datalumo_sort_map`, and `datalumo_resolve_args`.

== Changelog ==

= 0.1.0 =
* Initial release