HXSE — Code-First Search
·
Code-first search & filter for WordPress. Define filters with PHP arrays, output with a shortcode. Powered by htmx — no page reloads.
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.
- Fully customizable — All styles use CSS custom properties (design tokens). Ships with
DESIGN.mdfor a complete variable reference and customization examples.
Filter Types
search— Keyword searchtaxonomy— Filter by taxonomy / categorymeta— Filter by custom field value or rangedate— Filter by yearrelation— Filter by related post
UI Types
select— Dropdownradio— Radio buttonscheckbox— Multiple selectionrange— Min/max slider (for numeric meta fields)
Pagination Modes
pager— Numbered page links with count displayloadmore— ”Load more” button
Basic Usage
Define a schema in your theme’s functions.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;
} );
Then place the shortcode on any page:
[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