web_search_gateway Shortcode
The web_search_gateway shortcode renders a GET form that sends selected search fields to a configured destination.
Usage
[web_search_gateway]Attributes
| Attribute | Default | Accepted values | Purpose |
|---|---|---|---|
context |
— | String unless stated otherwise | Selects the faceted-search context shared with related controls and results. |
destination_mode |
url |
String unless stated otherwise | Sets the destination mode value consumed by this shortcode. |
target_url |
— | String unless stated otherwise | Sets the target url value consumed by this shortcode. |
archive_type |
post_type |
String unless stated otherwise | Sets the archive type value consumed by this shortcode. |
archive_post_type |
— | String unless stated otherwise | Sets the archive post type value consumed by this shortcode. |
archive_taxonomy |
— | String unless stated otherwise | Sets the archive taxonomy value consumed by this shortcode. |
archive_term |
— | String unless stated otherwise | Sets the archive term value consumed by this shortcode. |
fields |
— | String unless stated otherwise | Sets the fields value consumed by this shortcode. |
field_overrides |
— | String unless stated otherwise | Sets the field overrides value consumed by this shortcode. |
facets |
all |
String unless stated otherwise | Sets the facets value consumed by this shortcode. |
show_submit |
yes |
String unless stated otherwise | Sets the show submit value consumed by this shortcode. |
button_text |
— | String unless stated otherwise | Sets the visible button label. |
button_style |
1 |
1 or a configured button-style slug |
Selects a button style defined in the POM design system. |
button_size |
default |
String unless stated otherwise | Selects the rendered button size. |
button_icon |
— | String unless stated otherwise | Selects the icon rendered with the button label. |
submit_col_lg |
12 |
String unless stated otherwise | Sets the submit col lg value consumed by this shortcode. |
submit_col_md |
12 |
String unless stated otherwise | Sets the submit col md value consumed by this shortcode. |
submit_col |
12 |
String unless stated otherwise | Sets the submit col value consumed by this shortcode. |
preserve_params |
— | String unless stated otherwise | Sets the preserve params value consumed by this shortcode. |
el_class |
— | String unless stated otherwise | Adds one or more custom CSS classes to the outer element. |
form_id |
— | String unless stated otherwise | Sets the form id value consumed by this shortcode. |
Faceted search context
Enable and configure Faceted Search in Settings → POM Theme → Content model → Faceted search. Controls, results, and gateways that belong together must use compatible context values.
A gateway sends a normal search request to another page; it does not render live results on the source page. Choose its context and fields through the visual builder so their stored configuration stays valid.
Verification
Test web_search_gateway with the configured Faceted Search context, active selections, no selections and an empty result set. Pay particular attention to context and destination_mode.