Button Hover Text #
Customize the tooltip text that appears when visitors hover over action buttons on detail pages. Supports animal field value interpolation using {FieldName} syntax. Available to Junior license and above.
How It Works #
Each action button on the detail page has a title attribute that displays as a tooltip on hover. By default, PetMatchPro uses built-in text like “Visit Us to Meet Buddy” or “Call Us About Buddy”. You can customize this text per button per method type, with support for dynamic animal field values.
Admin Settings #
Navigate to General > Display Options. Text input fields appear per button per method type:
- Adopt method: Meet & Greet, Email, Call, Adoption App, Foster App, Donate, Return (7 fields)
- List method (PetPoint only): Meet & Greet, Email, Call, Adoption App, Foster App, Donate, Return (7 fields)
- Preferred method (AnimalsFirst only): Meet & Greet, Email, Call, Adoption App, Foster App, Donate, Return (7 fields)
- Lost method: Email, Call, Return (3 fields)
- Found method: Email, Call, Return (3 fields)
Method-specific fields only appear when that method type is enabled for your partner. List shares the adopt button set because it is an adoption-style listing for PetPoint; Preferred shares the adopt button set because it is the AnimalsFirst priority-adoption stream.
Field Interpolation #
Use {FieldName} placeholders to insert animal data into your hover text. Field names are partner-specific — the same shortcode that interpolates correctly on a PetPoint site will not work the same on an AnimalsFirst or RescueGroups site, because each partner’s API uses its own field key naming.
Tokens are case-sensitive and have no fallback: if the field is missing or blank for a particular animal, the token expands to an empty string. Unrecognized tokens are silently removed.
(Note: the search-card hover text feature shipped in 8.8.0 also accepts two universal tokens, {Name} and {Species}, that work across partners with a tooltip-safe fallback. Detail-page button hover text does not have those universal tokens — only the raw partner field keys below. See Search Card Hover Text if you want the universal-token behavior on search cards.)
Common tokens by partner #
This is the quick reference of the most common partner field keys you will reach for. The full field set for each partner is much larger — everything in the API response is available as a token.
| What you want | PetPoint | AnimalsFirst | RescueGroups |
|---|---|---|---|
| Animal name | {AnimalName} |
{name} |
{animalName} |
| Species | {species} |
{species} |
{animalSpecies} |
| Breed | {primarybreed} |
{breed} |
{animalBreed} |
| Sex / Gender | {sex} |
{gender} |
{animalSex} |
| Age | {ageinyears} |
{age} |
{animalAgeString} |
| Color | {primarycolor} |
{color} |
{animalColor} |
| Location / Jurisdiction | {Jurisdiction} or {location} |
{location} or {city} |
{animalLocation} |
| Adoption fee | {fee} |
{adoption_fee} |
{animalAdoptionFee} |
How to confirm a token works on your site: open any animal’s detail page, view the page source (right-click → View Page Source), and search for the field key. Anything PetMatchPro renders on the detail page is available as a button hover-text token. The fastest sanity check is to set a hover-text field to "Test: {YourTokenHere}" and reload — if the value shows up in the tooltip, the token is correct.
Examples #
PetPoint #
Apply to adopt {AnimalName} today!
Call us about {AnimalName} the {primarybreed}
Meet {AnimalName} at our shelter
Email about {AnimalName}, our {ageinyears}-year-old {Species}
AnimalsFirst #
Inquire about {name}
Call us about {name} the {breed}
Foster {name} ({age} years old)
RescueGroups #
Ask about {animalName}
Sponsor {animalName}'s care
Adopt {animalName} for {animalAdoptionFee}
When the field is empty #
Because button hover text has no fallback, a string like "Apply to adopt {AnimalName}" will render as "Apply to adopt " — with a trailing blank — for any animal whose name field is missing (most often newly-arrived strays). If your shelter regularly has unnamed intakes, prefer phrasing that reads sensibly even with the token blank, e.g. "Apply to adopt this {Species}" → “Apply to adopt this Dog” works whether the name is present or not.
Shortcode Parameters #
Override hover text per page using shortcode parameters:
| Parameter | Button |
|---|---|
hover_text_meet_greet |
Meet & Greet |
hover_text_email |
Email Inquiry |
hover_text_call |
Phone Call |
hover_text_adoption_app |
Adoption Application |
hover_text_foster_app |
Foster Application |
hover_text_donate |
Donate/Sponsor |
hover_text_return |
Return to Search |
Example:
[pmp-details hover_text_email="Ask about {AnimalName} today!" hover_text_adoption_app="Apply to adopt {AnimalName}"]
Priority Chain #
- Shortcode parameter
hover_text_{button}(highest priority, per-page) - Admin setting per button per method type (site-wide default)
- Built-in default (e.g., “Visit Us to Meet Buddy”)
Available Buttons by Method Type #
| Button Key | Button Label | Adopt | List (PP) |
Preferred (AF) |
Lost | Found |
|---|---|---|---|---|---|---|
meet_greet |
Meet & Greet | Yes | Yes | Yes | — | — |
email |
Email Inquiry | Yes | Yes | Yes | Yes | Yes |
call |
Phone Call | Yes | Yes | Yes | Yes | Yes |
adoption_app |
Adoption Application | Yes | Yes | Yes | — | — |
foster_app |
Foster Application | Yes | Yes | Yes | — | — |
donate |
Donate/Sponsor | Yes | Yes | Yes | — | — |
return |
Return to Search | Yes | Yes | Yes | Yes | Yes |
Next Steps #
- [pmp-details] Reference — Full detail shortcode parameter reference
- Common Shortcode Recipes — Copy-paste examples including hover text
- Understanding License Tiers — Feature comparison by tier
