web_fsearch_per_page Shortcode
The web_fsearch_per_page shortcode renders a result-count selector for faceted search.
Usage
[web_fsearch_per_page]
Attributes
| Attribute | Default | Accepted values | Purpose |
|---|---|---|---|
class |
— | String unless stated otherwise | Adds one or more custom CSS classes to the rendered control. |
label |
— | String unless stated otherwise | Sets the visible control label. |
options |
— | String unless stated otherwise | Defines the selectable values using the format documented for this control. |
default |
default |
String unless stated otherwise | Defines the initially selected value. |
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.
Define options through the builder as the supported page-size choices and select one of them as default. Keep values positive and conservative: very large pages increase query, rendering, image, and browser work and can make the interface slower than pagination.
Test every choice with filters active, the final partial page, URL restoration, reset behavior, and browser back/forward navigation. Changing page size should return the visitor to a valid page of the same filtered result set rather than preserving an out-of-range page number.
Verification
Test web_fsearch_per_page with the configured Faceted Search context, active selections, no selections and an empty result set. Pay particular attention to class and label.