=== datalumo ===
Contributors: jeffreyvr
Tags: search, ai, chatbot, indexing, content
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.1
Stable tag: 0.5.1
License: MIT
License URI: https://opensource.org/licenses/MIT

Integrate your WordPress site with Datalumo to sync content and power search and AI experiences.

== Description ==

This plugin helps you connect WordPress content to the datalumo platform.

Features include:

- Content sync for posts and pages
- Search integration
- Embeddable chatbot and widget support

Documentation:
https://datalumo.app/docs/wordpress

== Installation ==

1. Upload the plugin files to the /wp-content/plugins/datalumo directory, or install the plugin through WordPress.
2. Activate the plugin through the Plugins screen in WordPress.
3. Open Datalumo settings and enter your API credentials.
4. Run a content sync.

== Frequently Asked Questions ==

= Where can I find setup instructions? =

Use the official documentation:
https://datalumo.app/docs/wordpress

== Changelog ==

= 0.5.2 =

- Fix embed URL.

= 0.5.1 =

- Fixed Enhanced Native Search returning the same result set for every query when a theme forces `orderby=date` via `pre_get_posts`. Search queries now default to semantic relevance ranking unless `orderby` is explicitly set in the request URL.
- Changed synced taxonomy values (categories, tags, custom taxonomies) from display names to slugs. Slugs are stable across renames and better suited for API-side filtering.

= 0.5.0 =

- Added Cancel button to stop a running bulk sync from the admin UI. Pending batches are unscheduled; any in-flight batch finishes cleanly.
- Changed bulk sync to strip shortcodes from synced content by default. Shortcodes often render widgets or forms rather than body text, and in a background context they lack the request globals they expect. Sites that need the previous behavior can opt in via the `datalumo_render_shortcodes` filter.
- Improved bulk sync load profile: batches are now staggered (default 10 seconds apart) so a full sync doesn't saturate PHP workers and upstream API. Tunable via the `datalumo_bulk_sync_stagger_seconds` filter.
- Added `datalumo_bulk_sync_batch_size` filter for tuning batch size on constrained hosting.

= 0.4.0 =

- Added Search Box admin tab for managing embedded search widget integrations separately from Enhanced Native Search.
- Added chatbot display options: popup or sidebar mode, position/side, push-content behavior, and avatar toggle.
- Added sort support to Enhanced Native Search — WP orderby (date, modified, title, meta_value, meta_value_num) is translated to Datalumo's sort API; unmappable values fall back to native WP search.
- Added modified_at to synced entries so orderby=modified is honored.
- Added [datalumo_search mode="modal"] for Cmd/Ctrl+K modal search boxes.
- Migrated search and chatbot shortcodes to the fluent SDK API (Datalumo.search(...).inline() / .modal(), Datalumo.chat(...).popup() / .sidebar()).
- Added filters: datalumo_relevance_orderby_values, datalumo_map_orderby_to_sort for customising how WP sort maps to Datalumo.
- Improved bulk sync reliability: transient API failures now reschedule the batch instead of silently advancing the processed counter.
- Improved real-time sync reliability: failed upserts and deletes now reschedule after 5 minutes instead of being swallowed.
- Fixed real-time sync dropping custom meta mappings. The datalumo_sync_entry hook was registered with accepted_args=3, so the fourth argument (meta_mappings) was silently discarded, causing post publish/update events to re-sync entries without their configured custom fields or taxonomy values.
- Improved bulk sync performance: post author cache is primed per batch to reduce database queries.
- Polished admin UI across all tabs: WP-native card layout, two-line sync rows with aggregated metadata, empty state, destructive button styling.
- Right-aligned the Documentation link in the admin header.
- Replaced em dashes with ASCII equivalents in user-facing strings.

= 0.3.0 =

- Added configurable meta mappings to content sync (custom fields and taxonomies).
- Added searchable_meta support for including metadata in search results.
- Added WooCommerce preset for quick meta mapping setup (SKU, price, categories, tags).
- Added taxonomy dropdown for meta mapping source selection.
- Redesigned content sync UI with collapsible sync blocks and inline post type checkboxes.
- Improved dirty state detection for meta mapping changes.

= 0.2.0 =

- Added post type filtering for enhanced native search.
- Added programmatic search API for custom WP_Query usage.
- Added datalumo_enqueue_summary() for AJAX-powered AI summaries on custom pages.
- Added datalumo_enqueue_click_tracking() for standalone click tracking.
- Added integration attribute to [datalumo_chat] and [datalumo_search] shortcodes.
- Added shortcode usage hints on chatbot and search settings tabs.
- Added documentation link to admin settings page.
- Improved sync flow: "Sync Now" is disabled until settings are saved.
- Limited the configuration notice to the plugins and settings pages only.

= 0.1.0 =

- Initial public release.
