HXSE \u2014 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.<\/p>\n\n
Why HXSE?<\/strong><\/p>\n\n Filter Types<\/strong><\/p>\n\n UI Types<\/strong><\/p>\n\n Pagination Modes<\/strong><\/p>\n\n Basic Usage<\/strong><\/p>\n\n Define a schema in your theme's Then place the shortcode on any page:<\/p>\n\n 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.<\/p>\n\n No. HXSE handles all htmx configuration automatically. You only write PHP to define your filters.<\/p><\/dd>\n Yes. Use the Create Yes. Use \n
DESIGN.md<\/code> for a complete variable reference and customization examples.<\/li>\n<\/ul>\n\n\n
search<\/code> \u2014 Keyword search<\/li>\ntaxonomy<\/code> \u2014 Filter by taxonomy \/ category<\/li>\nmeta<\/code> \u2014 Filter by custom field value or range<\/li>\ndate<\/code> \u2014 Filter by year<\/li>\nrelation<\/code> \u2014 Filter by related post<\/li>\n<\/ul>\n\n\n
select<\/code> \u2014 Dropdown<\/li>\nradio<\/code> \u2014 Radio buttons<\/li>\ncheckbox<\/code> \u2014 Multiple selection<\/li>\nrange<\/code> \u2014 Min\/max slider (for numeric meta fields)<\/li>\n<\/ul>\n\n\n
pager<\/code> \u2014 Numbered page links with count display<\/li>\nloadmore<\/code> \u2014 \"Load more\" button<\/li>\n<\/ul>\n\nfunctions.php<\/code>:<\/p>\n\nadd_filter( 'hxse_schemas', function( $schemas ) {\n $schemas['staff_search'] = [\n 'post_type' => 'staff',\n 'filters' => [\n ['key' => 'keyword', 'type' => 'search', 'label' => '\u30ad\u30fc\u30ef\u30fc\u30c9'],\n ['key' => 'department', 'type' => 'taxonomy', 'label' => '\u90e8\u7f72',\n 'taxonomy' => 'department',\n 'ui' => 'checkbox',\n ],\n ],\n 'pagination' => [\n 'mode' => 'pager',\n 'per_page' => 12,\n ],\n 'template' => 'hxse-staff.php',\n ];\n return $schemas;\n} );\n<\/code><\/pre>\n\n[hxse id=\"staff_search\"]\n<\/code><\/pre>\n\nExternal Services<\/h3>\n\n
\n
\n
hxse-code-first-search<\/code> folder to \/wp-content\/plugins\/<\/code>.<\/li>\nhxse_schemas<\/code> filter to your theme's functions.php<\/code> or a custom plugin.<\/li>\n[hxse id=\"your_schema_id\"]<\/code> shortcode to any page.<\/li>\n<\/ol>\n\n\n\n
Do I need to write JavaScript?<\/h3><\/dt>\n
Can I use multiple search instances on one page?<\/h3><\/dt>\n
prefix<\/code> option in url_params<\/code> to avoid parameter conflicts.<\/p><\/dd>\nHow do I customize the result template?<\/h3><\/dt>\n
hxse\/your-template.php<\/code> in your theme directory and specify it in the schema's template<\/code> key.<\/p><\/dd>\nDoes it work with custom fields from ACF?<\/h3><\/dt>\n
type: 'meta'<\/code> with the appropriate meta_key<\/code>.<\/p><\/dd>\n\n<\/dl>\n\n\n1.6.0<\/h4>\n\n
\n
?hxse_embed={schema_id}<\/code> to output a list-only, self-contained HTML page for embedding on external landing pages<\/li>\nembed<\/code> schema key \u2014 enabled<\/code>, allowed_origins<\/code>, title<\/code>, per_page<\/code><\/li>\nContent-Security-Policy: frame-ancestors<\/code> restricts which domains may embed the view (same-origin only when no origins are specified)<\/li>\nincludes\/embed.php<\/code> \u2014 embed view rendering and frame security headers<\/li>\n<\/ul>\n\n1.5.0<\/h4>\n\n
\n
sources<\/code> key) \u2014 combine WordPress posts, RSS feeds, and APIs into a single chronological list<\/li>\nhxse_fetch_merged_data()<\/code> \u2014 fetches, normalizes, and merges multiple data sources<\/li>\norderby<\/code> \/ order<\/code> \/ limit<\/code> keys for merge mode sorting<\/li>\nmap<\/code> key \u2014 maps API\/XML response keys to the common format<\/li>\ntemplates\/merged.php<\/code> \u2014 default template with source badges<\/li>\n1.4.0<\/h4>\n\n
\n
source: 'rss'<\/code> mode \u2014 fetches RSS 2.0 and Atom feeds and converts to PHP array automatically<\/li>\nsource: 'xml'<\/code> mode \u2014 fetches any XML and converts to PHP array using xpath<\/code> key<\/li>\nhxse_parse_rss()<\/code> \u2014 RSS 2.0 \/ Atom parser<\/li>\nhxse_parse_xml()<\/code> \u2014 generic XML parser with xpath support<\/li>\nhxse_simplexml_to_array()<\/code> \u2014 recursive SimpleXMLElement to array converter<\/li>\nhxse_do_remote_fetch()<\/code> now handles json \/ rss \/ xml based on source<\/code> key<\/li>\nhxse_do_api_request()<\/code> alias retained<\/li>\n<\/ul>\n\n1.3.0<\/h4>\n\n
\n
hxse_cache_map<\/code> option) \u2014 tracks schema ID \u2192 filename relationships to detect orphaned files<\/li>\nhxse_delete_static_cache()<\/code> now also removes the mapping entry<\/li>\nuninstall.php<\/code> now also deletes the hxse_cache_map<\/code> option<\/li>\n<\/ul>\n\n1.2.0<\/h4>\n\n
\n
cache_mode: 'static'<\/code> \u2014 saves API responses as JSON files in wp-content\/hxse-cache\/<\/code> (blocked from web access via .htaccess)<\/li>\ncache_file<\/code> key \u2014 custom filename for the static JSON cache<\/li>\nincludes\/cache.php<\/code> \u2014 cache directory management (init, load, save, delete)<\/li>\nuninstall.php<\/code> \u2014 removes wp-content\/hxse-cache\/<\/code> directory on plugin uninstall<\/li>\nhxse_fetch_api_data()<\/code> to support both transient and static cache modes<\/li>\n<\/ul>\n\n1.1.0<\/h4>\n\n
\n
source: 'api'<\/code> mode \u2014 fetch data from external APIs (GAS, REST API, etc.) via PHP and render with a custom theme template<\/li>\ntoken<\/code> key \u2014 appended as _token<\/code> GET parameter for simple API authentication<\/li>\ncache<\/code> key \u2014 transient-based caching for API responses (seconds, 0 to disable)<\/li>\n<\/ul>\n\n1.0.2<\/h4>\n\n
\n
1.0.1<\/h4>\n\n
\n
columns<\/code> schema key (CSS variable injection).<\/li>\ntable_columns<\/code> schema key.<\/li>\n1.0.0<\/h4>\n\n
\n