Title: WP Petfinder Author: Alex Raven Published: January 27, 2020 Last modified: January 29, 2022 --- Search plugins ![](https://ps.w.org/wp-petfinder/assets/banner-772x250.jpg?rev=2385220) This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://ps.w.org/wp-petfinder/assets/icon.svg?rev=2385219) # WP Petfinder By [Alex Raven](https://profiles.wordpress.org/esiteq/) [Download](https://downloads.wordpress.org/plugin/wp-petfinder.zip) * [Details](https://wordpress.org/plugins/wp-petfinder/#description) * [Reviews](https://wordpress.org/plugins/wp-petfinder/#reviews) * [Installation](https://wordpress.org/plugins/wp-petfinder/#installation) * [Development](https://wordpress.org/plugins/wp-petfinder/#developers) [Support](https://wordpress.org/support/plugin/wp-petfinder/) ## Description 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. ### Shortcodes [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. ### Widgets #### WPPF Animals From Shelter 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. #### WPPF Search Form 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. ### Plugin options Options are available under WP Petfinder menu. #### General Options **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] #### Look & Feel **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. ### Actions wppf_before_search_form, wppf_after_search_form, wppf_before_search_results, wppf_after_search_results, wppf_animal_gallery ### Donate 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. ## Installation Like any other plugins, just unpack plugin to your WordPress ‘plugins’ directory and activate it. ## FAQ ### Question Answer. ## Reviews ![](https://secure.gravatar.com/avatar/0370b510d6836c7c07e5e266facf8d4fb9c002d5e03f161a43ab5676909bc696? s=60&d=retro&r=g) ### 󠀁[Works Great](https://wordpress.org/support/topic/works-great-6591/)󠁿 [ChipH](https://profiles.wordpress.org/chiph/) March 27, 2020 I’m moving a site that used the old Petfinder API over to WordPress, and this plugin saved me all of the trouble. Took a little big of figuring out with the shortcodes and setting up separate pages, but in the end it’s a fantastic setup. [ Read all 1 review ](https://wordpress.org/support/plugin/wp-petfinder/reviews/) ## Contributors & Developers “WP Petfinder” is open source software. The following people have contributed to this plugin. Contributors * [ Alex Raven ](https://profiles.wordpress.org/esiteq/) [Translate “WP Petfinder” into your language.](https://translate.wordpress.org/projects/wp-plugins/wp-petfinder) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/wp-petfinder/), check out the [SVN repository](https://plugins.svn.wordpress.org/wp-petfinder/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/wp-petfinder/) by [RSS](https://plugins.trac.wordpress.org/log/wp-petfinder/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 0.7 * Improved error reporting. #### 0.6 * Improved theme compatibility. #### 0.5 * Bugfix: Search Results page creation on plugin activation. #### 0.4 * Improved compatibility with other plugins and themes, especially jQuery v1.9 and newer. * Added cache parameter to pf_search_results shortcode. * Added forced Disable permalinks to plugin options. Turn it on if clicking on search results redirects to an empty page. #### 0.3 * Varous bugfixes #### 0.2 * Support of different pages for Cat & Dog adoption. You can still use the same page for all animal types. * Added new Options page: Look & Feel. * Widgets now supports templates. #### 0.1 * Initial release. ## Meta * Version **0.8** * Last updated **4 years ago** * Active installations **30+** * WordPress version ** 4.0 or higher ** * Tested up to **5.3.21** * PHP version ** 5.6 or higher ** * Tag * [petfinder](https://wordpress.org/plugins/tags/petfinder/) * [Advanced View](https://wordpress.org/plugins/wp-petfinder/advanced/) ## Ratings 5 out of 5 stars. * [ 1 5-star review ](https://wordpress.org/support/plugin/wp-petfinder/reviews/?filter=5) * [ 0 4-star reviews ](https://wordpress.org/support/plugin/wp-petfinder/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/wp-petfinder/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/wp-petfinder/reviews/?filter=2) * [ 0 1-star reviews ](https://wordpress.org/support/plugin/wp-petfinder/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/wp-petfinder/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/wp-petfinder/reviews/) ## Contributors * [ Alex Raven ](https://profiles.wordpress.org/esiteq/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/wp-petfinder/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=FHF5UF699YTSW&source=url)