Common Shortcode Recipes #

Ready-to-use shortcode examples for the most common PetMatchPro configurations. Copy and paste these directly into your WordPress pages.

Basic Adoption Search #

The simplest search page. Shows all adoptable animals with default settings.

[pmp-search type="adopt"]

Species-Specific Search Pages #

Create separate pages for different animal types:

Dogs only:

[pmp-search type="adopt" species="Dog"]

Cats only:

[pmp-search type="adopt" species="Cat"]

Search with Custom Fields #

Control which fields display in search results:

[pmp-search type="adopt" details="Name,Breed,Sex,Age,Photo"]

Search with Filters Enabled #

Let visitors narrow results by species, breed, and more:

[pmp-search type="adopt" filter="enable"]

Paginated Search Results (Junior+) #

Display results across multiple pages:

[pmp-search type="adopt" pagination="enable" rows="3" row="4"]

This shows 3 rows of 4 animals per page with pagination controls.

Search with Subtitle and Banner (Junior+) #

Add a custom heading and banner to your search results:

[pmp-search type="adopt" subtitle="Find Your New Best Friend" banner="All animals are spayed/neutered and up to date on vaccinations."]

Search with Icons and Overlays (Junior+) #

Display status icons and photo overlays:

[pmp-search type="adopt" icon="enable" icons="4" overlay="enable" overlays="3" overlay_position="top-right"]

Hide a Specific Animal (Junior+) #

The exclude parameter takes a single animal ID and drops that one animal from the results. It is most useful inside related-animal layouts (a “similar animals” grid below a detail page) so the current animal is not duplicated. It does not filter by species, status, breed, or any other field.

[pmp-search type="adopt" exclude="60100465"]

To filter by species use species="Dog" (or speciesid="1" on PetPoint). To hide a status site-wide, use the Filter Values tab customization. See Excluding Values for full details.

Featured Carousel (Junior+) #

Display featured animals in a carousel format:

[pmp-search type="featured" template="featured-search-carousel"]

Lost and Found Search (Junior+) #

Lost animals:

[pmp-search type="lost"]

Found animals:

[pmp-search type="found"]

Detail Page with Thumbnails and Poster #

Basic detail page with photo gallery and print option:

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

Detail Page with Hidden Buttons (Junior+) #

Hide specific action buttons on the detail page:

Hide call and foster buttons:

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

Hide all conversion buttons (email, call, meet & greet):

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

Full-Featured Detail Page (Junior+) #

Detail page with all display options:

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

Detail Page with Stats Layout (Junior+) #

Organize animal data into a stats display:

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

Multi-Shortcode Page Layout #

You can use multiple shortcodes on a single page. For example, a featured carousel above the main search:

[pmp-search type="featured" template="featured-search-carousel"]

[pmp-search type="adopt" filter="enable" pagination="enable"]

Single Field Display #

Use [pmp-detail] to display individual field values:

This animal's name is [pmp-detail detail="Name"] and they are a [pmp-detail detail="Breed"].

Custom Icon Sizes (Junior+) #

Override icon display sizes on search or detail pages:

Large icons on search:

[pmp-search type="adopt" icon="enable" icon_size="large"]

Specific pixel size on detail:

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

Custom Font Sizes (Junior+) #

Override title and subtitle sizes via shortcode:

[pmp-search type="adopt" title_size="xl" subtitle_size="large" subtitle="Adopt Your New Best Friend"]

Extra large detail title:

[pmp-details title_size="xl"]

For full font size control across all text elements, use the Fonts tab in admin settings.

Admin Exclude Buttons with Shortcode Override (Junior+) #

Set default button exclusions in admin (General > Display Options), then override per page:

Admin default hides foster_app and donate for adopt method. Override on a specific page to show all buttons:

[pmp-details exclude_buttons=""]

Admin shows all buttons. Hide call and meet on a specific page:

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

Custom Button Hover Text (Junior+) #

Customize the tooltip that appears when visitors hover over action buttons. Uses partner-specific field names for interpolation.

PetPoint example:

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

AnimalsFirst example:

[pmp-details hover_text_email="Inquire about {Name}" hover_text_call="Call about {Name}"]

RescueGroups example:

[pmp-details hover_text_email="Ask about {animalName}" hover_text_donate="Sponsor {animalName}'s care"]

Hover text can also be configured as defaults per button per method type in admin settings (General > Display Options).

Next Steps #

• [pmp-search] Reference — Full search parameter reference
• [pmp-details] Reference — Full details parameter reference
• Search Templates Gallery — See all available templates