[pmp-details] Reference #

The [pmp-details] shortcode displays a full profile for a single animal. Place it on your detail page — visitors reach it by clicking an animal in your search results.

Basic Usage #

[pmp-details]

Displays the animal's profile using the default detail template configured in your admin settings.

All Parameters #

Free Parameters (All Tiers) #

Junior Parameters (Junior License or Higher) #

These parameters are silently ignored on the Basic tier.

Title Behavior #

The title parameter controls the detail page heading (<h1 class="pmp-details-title">). It accepts three forms:

Auto-Generated Title Formats #

When the title parameter is omitted, the plugin builds a title based on the method type. Each format has a fallback chain for missing data:

Location handling: The in {Location} suffix is only appended when the plugin can resolve a location value. If no location data is available, the suffix is dropped entirely — titles never display “in Not Defined”.

Lost title format: Lost titles use a name-first format across all integration partners. When the animal has a known name (e.g., “Blackie”), the title leads with it: Blackie Lost in Eugene. This is more actionable on a lost-pet flyer than a species-first format. When no name is available, the title falls back to sex and species: Male Dog Lost in Eugene.

Found title format: Found titles always lead with sex and species because found animals rarely have a known name. Using a name would imply a known owner, which defeats the purpose of a found-pet notice.

Button Labels for Nameless Animals #

When an animal has no real name — the name field is empty or contains only a numeric shelter ID — button labels and the description heading fall back to shorter forms:

Hide Empty Field Behavior #

The hide_empty parameter controls how empty (null, blank, or unknown) field values are displayed on the detail page:

• hide_empty="false" — Empty fields render with the Not Defined placeholder. This matches the default behavior of prior releases.
• hide_empty="true" — Empty fields are dropped entirely, tightening the detail layout.

The setting applies to every detail zone on the page: the main details list, quick_fields, title_fields, stats_row, stats_full, and the description section. On related-animal grids (templates ending in -similar), the related grid inherits the detail page's setting.

For numeric fields where 0 is a data-entry placeholder rather than a real value (currently weight on PetPoint and AnimalsFirst), a zero value is also treated as empty. Currency fields such as fee and adoptionfee are exempt — a $0 adoption fee is a legitimate display.

Poster templates exempt the header and footer zones (heading, photo, QR code, call-to-action) from the toggle so flyers always print a complete layout. Only the poster body field loop honors the setting.

There is also a per-method admin checkbox on the General > Display Options tab that sets the default for every page rendering that method type. The shortcode hide_empty parameter overrides the admin checkbox for the specific shortcode instance.

Template Parameter Behavior #

Like the search shortcode, the template parameter displays a clear upgrade message rather than being silently removed if your license tier doesn't support the selected template.

Examples #

Basic detail page:

[pmp-details]

Detail page with specific fields:

[pmp-details details="Name,Breed,Sex,Age,Description,Photo"]

Detail page with thumbnails and poster:

[pmp-details thumbs="6" poster="enable"]

Detail page with social sharing (Junior+):

[pmp-details social="enable" thumbs="6"]

Detail page with quick fields and stats (Junior+):

[pmp-details quick_fields="Breed,Sex,Age" stats_row="Weight,Color" thumbs="6"]

Detail page with icons and overlays (Junior+):

[pmp-details icon="enable" icons="5" overlay="enable" overlays="3"]

Hide specific buttons (Junior+):

[pmp-details exclude_buttons="call,foster_app"]

Hide all conversion buttons (Junior+):

[pmp-details exclude_buttons="meet_greet,email,call"]

Full-featured detail page (Junior+):

[pmp-details thumbs="6" social="enable" quick_fields="Breed,Sex,Age" stats_row="Weight,Color,Size" icon="enable" overlay="enable" poster="enable"]

Custom icon size (Junior+):

[pmp-details icon="enable" icon_size="large"]

Custom title size (Junior+):

[pmp-details title_size="xl"]

Custom button hover text with field interpolation (Junior+):

[pmp-details hover_text_email="Ask about {AnimalName} today!" hover_text_adoption_app="Apply to adopt {AnimalName}"]

Detail page with empty fields hidden (Junior+):

[pmp-details hide_empty="true"]

Detail page overriding admin setting to always show empty fields (Junior+):

[pmp-details hide_empty="false"]

Custom title text:

[pmp-details title="Help Us Find Buddy"]

Suppress title entirely:

[pmp-details title=""]

Admin Setting Fallbacks #

Several parameters can also be configured in admin settings as defaults. The shortcode parameter always takes priority:

Next Steps #

• [pmp-detail] Reference — Display a single field value
• Detail Templates Gallery — Browse available detail templates
• Common Shortcode Recipes — Copy-paste examples