web_finder Shortcode
The web_finder shortcode renders the finder component.
The attributes below match the current Page Builder controls and public output. Use raw syntax only for reviewed content that cannot be maintained through the visual controls.
Allowed child shortcodes: web_finder_content.
Usage
[web_finder]
Content
[/web_finder]Attributes
| Attribute | Default | Accepted values | Purpose |
|---|---|---|---|
web_finder_action |
— | String unless stated otherwise | The page to open when the form is submitted. Leave blank to reload the current page. This setting is not used when AJAX is enabled. |
web_auto_submit |
— | yes |
Indicates whether the form should submit automatically whenever a field is updated. |
web_finder_ajax |
— | yes |
When AJAX is enabled, there's no need to reload the page. |
web_finder_ajax_show_default_results |
— | yes |
If checked, search results will display on page load. Available when web_finder_ajax is yes. |
web_finder_ajax_loading_img |
Theme loading SVG | Media URL | Image to display before results are loaded. Available when web_finder_ajax is yes. |
web_finder_ajax_button_style |
1 |
1 or a configured button-style slug |
Selects the Load More button style. Available when web_finder_ajax is yes. |
web_finder_ajax_button_text |
Load more results |
String unless stated otherwise | Custom text for the Load More button. Available when web_finder_ajax is yes. |
taxonomy_relation |
OR |
OR, AND |
Specifies the relationship between taxonomies. This not only takes into account those chosen in the taxonomy module but also includes those specified in the selected query. |
web_query |
1 |
String unless stated otherwise | You can create new queries from the Custom queries section in Theme settings. |
device_visibility |
— | String unless stated otherwise | Applies the selected responsive visibility rule. |
el_id |
— | Valid unique HTML ID | Enter element ID (Note: make sure it is unique and valid according to w3c specification). |
el_class |
— | String unless stated otherwise | If you wish to style a particular content element differently, then use this field to add a class name and then refer to it in your CSS file. |
style |
default |
String unless stated otherwise | Sets the style value consumed by this shortcode. |
results_columns |
4 |
String unless stated otherwise | Sets the results columns value consumed by this shortcode. |
Enclosed content
Content between the opening and closing tags is processed as WordPress shortcode content. Keep the parent/child structure shown by the visual builder so nested components receive the context they expect.
Finder composition
This tag belongs to the Finder component family. Preserve its generated parent, row, column, and field nesting when editing raw shortcode content.
Verification
Populate web_finder with web_finder_row and confirm every child remains reachable in the intended order. Pay particular attention to web_finder_action and web_auto_submit.