bridgetwes

Petfinder is a free site where shelters and rescues can post pets for adoption. The List Petfinder Pets plugin takes advantage of the Petfinder API to list your available pets on your website. All you need is your Petfinder shelter id and free Petfinder API v2.0 API key and secret.
The List Petfinder Pets plugin allows you to:
<ol>
<li>Display all your shelter’s Petfinder pets on your own website</li>
<li>Display a featured or random pet from Petfinder in a widget</li>
</ol>
<h4>Sign up to be notified when the Petfinder plugin is updated</h4>
You can sign up to receive notices when this plugin is updated or other important changes here: (https://unboxinteractive.com/petfinder-plugin-email-list/)
<h4>Demos</h4>
<ul>
<li><a href="https://midwestigrescue.com/adoption/available-igs-in-missouri-and-kansas/" rel="nofollow ugc">Midwest Italian Greyhound Rescue</a></li>
</ul>
<h4>Shortcode</h4>
[shelter_list] displays a list of pets from your shelter. You must enter your shelter ID, Petfinder v2.0 API key and secret on the List Petfinder Pets’ settings page for this shortcode to work. You may also need to edit your Petfinder settings to enable sharing your data with third parties. See Petfinder settings under Frequently Asked Questions below. 
Optional attributes for shortcode are:
<ul>
<li>
shelter_id – Allows you to list adoptable pets from a shelter different from the shelter id defined in your List Petfinder Pets Settings.
</li>
<li>
breed – If you wish to list only one breed on a page, or leave blank/don’t set to get all breeds. Note: adding ! before breed to exclude breeds was removed when plugin was updated to support Petfinder API v2.0 in version 1.0.13.
</li>
<li>
count – The maximum number of pets to return. Defaults to 75 and must be a number. Petfinder API v2.0 added ability to filter before retrieving results so you can set the count to the real number you want to list on the page now. Max returned is 100.
</li>
<li>
page – Which page of pets to return. If you have over 100 pets, or want to break up your pets into multiple pages, you can put the shortcode on multiple pages, each with a different page number. You’ll need to add a link to each page so your users can navigate between pages. NOTE: Don’t set ‘sort_by’ parameter when using page. Sorting only sorts the pets returned on the current page. Petfinder does not provide a way to sort by pet’s name. It can only sort by recent and distance in the initial call. I sort by name after the results are returned so it won’t work with paging.
</li>
<li>
animal – Type of animal. Value should be one of the following or blank/don’t set to get all: Dog, Cat, Rabbit, Small & Furry, Horse, Bird, Scales, Fins & Other, Barnyard.
</li>
<li>
include_info – Value should be set to “yes” or “no”; default is “yes”. If set to “yes”, Breeds, Spayed/Neutered, Up-to-date with routine shots, Housebroken, kid safe, cat safe, dog safe, special needs are displayed in list below photo thumbnails. Each list item has a different CSS class so you can hide any you do not want to show.
</li>
<li>
css_class – Set your own class name on div containing all pets. The default value is ‘pets’. This allows you to control the styles separately on different pages.
</li>
<li>
status – For backwards compatability values can be one of [A, H, P, X], and new values of [adoptable, adopted, found]. Petfinder API V1 used: ‘A’ = adoptable, ‘H’ = hold, ‘P’ = pending, ‘X’ = adopted/removed. Petfinder API V2 only accepts adoptable, adopted, and found, so values of H and P switch to adoptable now.
</li>
<li>
sort_by – Value can be: newest, last_updated or name. Value can also be set globally in Petfinder Settings.
</li>
<li>
age – Accepts values of: baby, young, adult, or senior. Can separate with commas to display pets that match more than one age group. If not set, will display pets from all age groups.
</li>
<li>
Note – parameter include_mixes was removed with Petfinder API v2.0 in plugin version 1.0.13
</li>
<li>
Note – parameter contact was removed with version 1.0.19.
</li>
</ul>
Example: 
[shelter_list breed=”Italian Greyhound”] – other breeds are not displayed
Example: [shelter_list count=20 page=1] and on another page [shelter_list count=20 page=2] – would list the first 20 pets on page with first shortcode, and the 2nd 20 pets on page with second shortcode.
Example using all attributes: [shelter_list shelter_id=”WI185″ breed=”Italian Greyhound” count=75 page=2 animal=”Dog” include_info=”no” css_class=”cats” status=”adoptable” sort_by=”newest” age=”baby”]
You can also list a single pet with the following shortcode 
[get_pet pet_id=”numeric value”]
<ul>
<li>
pet_id – Required. You can get this id from the pet’s Petfinder URL. URL will look like the following: https://www.petfinder.com/dog/nanook-45732995/mo/kansas-city/missouri-kansas-ig-rescue-mo306/ – 45732995 is the pet_id.
</li>
<li>
css_class – Set your own class name on div containing single pet. The default value is ‘pets’. This allows you to control the styles separately on different pages.
</li>
<li>
include_info – Value should be set to “yes” or “no”; default is “yes”. If set to “yes”, Breeds, Spayed/Neutered, Up-to-date with routine shots, Housebroken, kid safe, cat safe, dog safe, special needs are displayed in list below photo thumbnails. Each list item has a different CSS class so you can hide any you do not want to show.
</li>
</ul>
Example using all attributes: [get_pet pet_id=”23367571″ include_info=”no” css_class=”cats”]
<h4>Widget</h4>
Add the List Petfinder Pets Featured Pet widget under Appearance -> Widgets. After adding the widget to a widget area you can set a featured pet id to display a featured pet, or leave blank to display a random pet from your shelter. 
Featured Pet Widget Settings:
Featured Pet ID – You can get this id from the pet’s Petfinder URL. URL will look like the following: https://www.petfinder.com/dog/nanook-45732995/mo/kansas-city/missouri-kansas-ig-rescue-mo306/?referrer_id=cca97ef9-e23d-4d0b-b29d-52afa8f7d70e – 45732995 is the pet id.
Your Listing Page URL – The page where your shortcode [shelter_list] can be found. If this is set, your featured pet will link directly to this pet on your shelter list page. (Optional)
Featured Pet Image Size – The size of the Featured Pet image. (Required)
Featured Pet PDF Link – If you would like to create a PDF with more information about your Featured Pet. Link to the PDF uploaded separately through WordPress’ Media here.
<h3>Filters</h3>
Need to change your pets’ description? Perhaps you want to remove/replace special characters that are not displaying correctly, or want to add a paragraph to the end of all pets’ descriptions? You can do so with the following filter. Add it to your functions.php file. The filter name is petf_replace_description and it acts on all pets’ descriptions.
function replace_pet_description( $description ) { 
 return $description . ” Add me to end of all pets’ descriptions”; 
} 
add_filter( ‘petf_replace_description’, ‘replace_pet_description’ );

List Petfinder Pets

The List Petfinder Pets plugin takes advantage of the Petfinder API to list your available pets on your website.

Alex Raven

WP Petfinder plugin was designed to integrate Petfinder.com database with your WordPress site via Petfinder API v2. It will be useful for pet shelters and volunteers to help Pets to get adopted.
<h3>Shortcodes</h3>
[pf_search_form]
Displays Pet search form. Available options:
location: default location. For this option, you can use: city, state; latitude,longitude; or postal code. Example: [pf_search_form location=”33025″].
type: default animal type. Possible values: dog, cat and more (refer to https://www.petfinder.com/developers/v2/docs/#get-animal-types).
gender: default gender. Possible values: male, female.
[pf_search_results]
Displays search results. Available options:
cache: set cache expiration time in seconds. Default value is 86400 seconds (24 hours). To disable caching (not recommended), set cache=1.
location: display animals from specific location. For this option, you can use: city, state; latitude,longitude; or postal code. Example: [pf_search_form location=”33025″]. This option will override value set in URL variable.
type: animal type. Possible values: dog, cat and more (refer to https://www.petfinder.com/developers/v2/docs/#get-animal-types). This option will override value set in URL variable.
gender: display animals of specific gender. Possible values: male, female. This option will override value set in URL variable.
shelter_id: display animals from shelter with specific ID. If shelter_id is set, any location value will be ignored. Example: [pf_search_results shelter_id=”NY606″]
size: display animals of specific size. Possible values: small, medium, large, xlarge. This option will override value set in URL variable.
view: display animals as grid or list. This option will override value set in URL variable.
status: display animals with specific status. Values: adoptable, adopted.
sort: sorting order. Values: recent, -recent, distance, -distance, random. Default is recent.
[pf_details]
Displays animal details. After setting the page, go to plugin options and choose it in Animal details page drop down list. The page with animal details will be automatically created on first plugin activation.
<h3>Widgets</h3>
<h4>WPPF Animals From Shelter</h4>
Widget that displays animals. Its output is similar to [pf_search_results] shortcode (you can also use shortcode in a widget). Available options:
Shelter ID: display animals from specific shelter. Optional.
Number of animals: display specified number of animals (1 to 10). Default is 1.
Animal type: display specified animal type. By default, displays all animal types.
IDs: display animals with specified IDs (IDs can be taken from Petfinder.com). Example: 12345, 432546.
Template: display widget using selected template.
<h4>WPPF Search Form</h4>
Works similar to [pf_search_form] shortcode (you can use shortcode instead of a widget). Available options:
Shelter ID: display animals from specific shelter.
Animal Name: search for animal by name.
Location: search for animals in specified location (see location field from shortcode for options).
Type: search for animals of specific type.
Gender: search for animals of specific gender.
Breed: search for animals of specific breed (list is available when Type is selected).
Size: search for animals of specific size.
Hide fields: hide specific fields from search form. Values can be any combination of the following (comma separated): name, location, type, breed, size.
<h3>Plugin options</h3>
Options are available under WP Petfinder menu.
<h4>General Options</h4>
Petfinder API key, Petfinder API secret: you can find these values under your account at Petfinder.com. Please set these keys first, otherwise plugin won’t work.
WP Petfinder Cache: will significantly speed up API calls by caching results using local database. If you are using third party caching plugins such as WP Total Cache, Redis Object Catche, etc – you can turn this option Off. Otherwise keep it On.
Turn Off permalinks: enable it, if you are getting empty page instead of animal details page.
Search Results page: users will be redirected to this page when they click Submit in search form (both shortcode and widget). If page is not set, it will use current page for search results.
Animal details page: users will be redirected to this page when they click animal profile in search results.
Cat adoption page: redirect to this page if user clicks Adopt me button on cat’s page. Can be the same as below.
Dog adoption page: redirect to this page if user clicks Adopt me button on dog’s page. Can be the same as above.
Detail page title: rewrite page title (for seo). Default: [name] – [gender] [age] [type]
<h4>Look & Feel</h4>
WP Petfinder Icon: you can choose between cat and dog icons that will be displayed in Admin menu.
Custom CSS: you can put your CSS here to override plugin’s styles. Plugin’s styles are located in css/wp-petfinder.css.
<h3>Actions</h3>
wppf_before_search_form, wppf_after_search_form, wppf_before_search_results, wppf_after_search_results, wppf_animal_gallery
<h3>Donate</h3>
My name is Alex and I am a volunteer that helps stray cats. This plugin will always be free for everyone. If you want to support plugin’s development and help animals, you can donate some amount via PayPal by clicking Donation link.

WP Petfinder

WP Petfinder plugin was designed to integrate Petfinder.com database with your Wordpress site via Petfinder API v2. It will be useful for pet shelters …

List Petfinder Pets vs WP Petfinder