Parameters by License Tier #
This reference shows which shortcode parameters are available at each license tier. Parameters above your tier are silently removed (except template, which shows an upgrade message).
Basic Tier (Free) #
All users can use these parameters with both [pmp-search] and [pmp-details]:
[pmp-search] — Basic Parameters #
| Parameter | Description |
|---|---|
type |
Search method type (adopt is free; others require Junior+) |
template |
Template selection (default templates only; shows upgrade message for others) |
details |
Fields to display |
filter |
Enable/disable search filters |
species |
Filter by species |
poster |
Enable/disable print poster |
[pmp-details] — Basic Parameters #
| Parameter | Description |
|---|---|
template |
Template selection (default templates only) |
details |
Fields to display |
poster |
Enable/disable print poster |
thumbs |
Photo thumbnails |
[pmp-detail] — Basic Parameters #
| Parameter | Description |
|---|---|
detail |
Field name to display |
value |
Specific value within the field |
Junior Tier Adds #
Upgrading to Junior unlocks these additional parameters:
[pmp-search] — Junior Parameters #
| Parameter | Description |
|---|---|
subtitle |
Subtitle text below search heading |
banner |
Banner text in search results |
dynamic_banner |
Override the per-method Dynamic Banners toggle (true/false). Drives each card’s banner from an animal field value. A static banner= takes priority. |
row |
Results per row |
rows |
Number of rows |
pagination |
Enable pagination |
count |
Maximum result count |
labels |
Show/hide field labels |
separator |
Field separator character |
client |
Client-specific options |
exclude |
Exclude specific values from results |
icon_size |
Override icon display size (small, large, xl, or number) |
title_size |
Override search title font size |
subtitle_size |
Override search subtitle font size |
banner_size |
Override search banner font size |
card_hover_text |
Override the search-card name/photo/image hover text. Supports {Name}, {Species}, and partner-specific field tokens. See Search Card Hover Text. |
Shared Parameters (Search & Details) — Junior #
| Parameter | Description |
|---|---|
icon |
Enable/disable icons |
icons |
Maximum icon count |
overlay |
Enable/disable photo overlays |
overlays |
Maximum overlay count |
overlay_filter |
Filter which icons show as overlays |
overlay_position |
Overlay position on photo |
hide_empty |
Hide empty fields entirely (true) or render them as Not Defined (false). Overrides the per-method admin checkbox. |
[pmp-details] — Junior Parameters #
| Parameter | Description |
|---|---|
social |
Social sharing buttons |
quick_fields |
Quick-view summary fields |
title_fields |
Title/header area fields |
stats_row |
Horizontal stats bar fields |
stats_full |
Full statistics section fields |
exclude_buttons |
Hide specific action buttons (meet_greet, email, call, adoption_app, foster_app, donate, return). Also configurable per method type in admin settings. |
icon_size |
Override icon display size (small, large, xl, or number) |
title_size |
Override detail title font size |
hover_text_{button} |
Custom hover text per button with {FieldName} interpolation. Buttons: meet_greet, email, call, adoption_app, foster_app, donate, return. Also configurable per method type in admin settings. |
Junior Admin Settings #
In addition to shortcode parameters, Junior tier unlocks these admin settings:
- Fonts tab — Font size controls for all search and detail text elements
- Icon Sizes — Size controls for pet icons, overlay icons, and label icons (General > Display Options)
- Exclude Buttons — Default button exclusions per method type (General > Display Options)
- Button Hover Text — Custom hover text per button per method type with field interpolation (General > Display Options)
- Search Card Hover Text — Custom hover text per method type for the search-card name link, photo link, and image, with
{Name}/{Species}/field interpolation (General > Display Options > Search Card Hover Text) - Hide Empty Fields — Per-method checkboxes that default empty-field handling for every page rendering that method type (General > Display Options)
Preferred Tier Adds #
The Preferred tier unlocks all parameters above, plus access to:
- The
preferredmethod type (AnimalsFirst only) - Lost/found combination search templates
- Filter value management
- Detail page instructions
- Field primary/fallback selection
These are primarily configured through admin settings rather than shortcode parameters.
How Tier Enforcement Works #
- Silently stripped: Most paid parameters are simply removed from the shortcode output on lower tiers. The page still renders, just without the paid feature.
- Upgrade message: The
templateparameter is an exception. If you select a template above your tier, PetMatchPro shows a clear message explaining which license is needed instead of rendering the page.
Method Type Availability #
The type parameter value also depends on your tier and partner:
| Type | Basic | Junior | Preferred | Partners |
|---|---|---|---|---|
adopt |
Yes | Yes | Yes | All |
lost |
— | Yes | Yes | PetPoint, AnimalsFirst |
found |
— | Yes | Yes | PetPoint, AnimalsFirst |
list |
— | Yes | Yes | PetPoint only |
featured |
— | Yes | Yes | PetPoint, AnimalsFirst |
preferred |
— | — | Yes | AnimalsFirst only |
Next Steps #
- Understanding License Tiers — Full feature comparison
- [pmp-search] Reference — Complete search parameter reference
- [pmp-details] Reference — Complete details parameter reference
Parameters by License Tier
ultima modifica: 2026-03-24T13:46:14-04:00
da
