HXSE — Code-First Search

HXSE — Code-First Search lets you define search filters with PHP arrays and output them with a simple shortcode. No JavaScript configuration required. Powered by htmx for seamless, no-reload filtering.

Why HXSE?

• Code-first — Define everything in PHP arrays. Version-control friendly.
• No page reloads — htmx handles all filtering and pagination seamlessly.
• AI-friendly — Simple, consistent schema structure that AI agents can read and write.
• No dependencies — htmx is bundled. No jQuery required.

Filter Types

• search — Keyword search
• taxonomy — Filter by taxonomy / category
• meta — Filter by custom field value or range
• date — Filter by year
• relation — Filter by related post

UI Types

• select — Dropdown
• radio — Radio buttons
• checkbox — Multiple selection
• range — Min/max slider (for numeric meta fields)

Pagination Modes

• pager — Numbered page links with count display
• loadmore — “Load more” button

Basic Usage

`php

add_filter( ‘hxse_schemas’, function( $schemas ) {
$schemas[‘staff_search’] = [
‘post_type’ => ‘staff’,
‘filters’ => [
[‘key’ => ‘keyword’, ‘type’ => ‘search’, ‘label’ => ‘キーワード’],
[‘key’ => ‘department’, ‘type’ => ‘taxonomy’, ‘label’ => ‘部署’,
‘taxonomy’ => ‘department’,
‘ui’ => ‘checkbox’,
],
],
‘pagination’ => [
‘mode’ => ‘pager’,
‘per_page’ => 12,
],
‘template’ => ‘hxse-staff.php’,
];
return $schemas;
} );
`

`

[hxse id=”staff_search”]
`

External Services

This plugin bundles htmx (https://htmx.org/) for handling AJAX requests without page reloads. htmx is included locally within the plugin and does not make any external network requests. It is licensed under the BSD 2-Clause License.

• htmx: https://htmx.org/
• htmx License: https://github.com/bigskysoftware/htmx/blob/master/LICENSE