In January, 2025, PetPress Version 2 will be released. Users still using version 1.x can find information for Version 1 here.
PetPress: a PetPoint / PetFinder plugin for WordPress
The following information pertains to version 2 of PetPress. It is currently in an “under construction” state, but will be complete prior to the schedule rollout at the end of January, 2025.
PetPress is a plugin for WordPress that enables integration of PetPoint Web services (and, beginning with version 2, PetFinder as an alternative). For shelters that use the PetPoint kennel management services or manage their animal rosters on PetFinder, this is the missing piece which can enable you to include animal listings on your WordPress-based website.
If you are researching options for a website for your animal shelter, please contact us. We can consult with your web developer / agency, or we can assist you with your integration.
PetPress is featured in the WordPress.org plugin catalog (the first of its kind to get the WordPress.org stamp of approval!) and can be downloaded at http://www.wordpress.org/plugins/petpress.
Latest Update
Read about changes in version 1.8.
PetPoint Staus
Having trouble with your PetPoint data? Check the PetPoint system status. Scroll down to the section titled “Online Animal Listings (PetPoint) and check the sub-item “Webservices”.
PetPress in the Wild
Over 30 shelters in the USA and Canada are currently using PetPress. Some use the plugin as it is “out of the box”, and others customize it. Examples:
- Calgary Humane Society – Canada
- Main Line Animal Rescue / PSPCA – PA
- Marshall County Animal Shelter – WV
- Mayfield – Graves County Animal Shelter – KY
- Pets on Board – PA
- Routt County Humane Society – CO
- San Antonio Humane Society – TX
Sign up for PetPress Notifications
Add your name to the mailing list to be notified about news and updates regarding the PetPress plugin. Your email address will not be used for any other purpose but to communicate information about PetPress or related software and services, and will not be sold or given to any third parties.
For any other topics, or to send a message, please contact us.
Requirements – Can I use PetPress?
(There are two requirements for an organization to use PetPress:
1) A WordPress website.
2) A data source. This can be the PetPoint shelter management software (www.PetPoint.com) or PetFinder (www.PetFinder.com). The PetPress plugin calls the PetPoint / PetFinder web services to retrieve all of its animal data. (Note that PetPoint and PetFinder are separate entities from AirdrieMedia and the respective organizations do not provide technical support for the others’ software.)
How to install PetPress
PetPress can be installed like any other WordPress plugin, either by accessing it through the catalog (you can search by name) or by uploading the .zip file. Once you install PetPress, there is a configuration step before you can use it on your site.
Note for PetPoint Users: Be aware that PetPoint web services have to be enabled for you to use this plugin. To enable web services, you need to make a request to the PetPoint support team (have your group name or shelter ID ready). If web services is not enabled on the PetPoint side, you will get “Access Denied” errors.
Configuring PetPress (PetPoint users)
The following are PetPoint-specific settings
- PetPoint AuthKey – The aforementioned authorization key. This key can be found in PetPoint under “Admin > Admin Options > Setup > Online Animal Listing Options“. You can also contact PetPoint support to get your code.
- List Options: Display specific values for Age / Weight: If checked, the list page will show specific ages and weights rather than generalized size and weights. For example, “2 yr – female – 44 lb” vs “adult – female – medium”.
- List Options: Display Site Name: If checked, the list page will show the site name along with the animal data. This is useful for organizations who want to show animals from multiple sites. Checking this box will have no effect if you have only one site in your organization.
- List Options: Show information on days in shelter, and allow sorting by days in shelter: Check this box if you want to show information about how many days a particular animal has been in the shelter (as reckoned by PetPoint). If unchecked, “days in” information will not be shown, and the button for sorting by days in will also not appear.
Configuring PetPress (PetFinder users)
The following is a PetFinder-specific setting
- List Options: Show “Shots current” information: “Shots current” is a unique field for PetFinder, and if you check this checkbox the information will appear in the “additional information” area of the detail pages.
General PetPress Options
PetPress overs a number of options for displaying your data. Not all are available for both PetPoint and PetFinder, because each data source has unique data fields.
Measurement Units
- Weight information can be displayed in pounds or kilograms. Note that this only affects the label, and doesn’t change the data you are using. For example, if you use pounds with PetPoint and have an animal that weighs 10 pounds, changing this option “kilograms” will result in the weight being displayed as “10 kilograms”.
List Page Options
- Number of animals per page: This is the number of animals that will be shown when the web page is first loaded, and also the number of additional animals that will be shown each time the “show more” button is clicked. If all the animals are shown, the “show more” button will not appear.
- Do not show animals that are marked “on hold”: If this option is checked, then animals that are marked “on hold” in PetPoint will not be displayed on the website. If it is unchecked, the animals will be shown.
- Show video icon for animals that have videos: If this option is checked, then animals that have videos on their profiles will have a small “play” icon next to their names on the list page.
- “Adoption pending” post-it notes: if the PetPoint stage of an animal begins with the word “adopted” and this checkbox is checked, a sticky note will appear over the animal’s photo that says “adoption pending”.
- “In a Foster Home” post-it notes: “In a Foster Home” messages will be displayed only if the animal’s location or sublocation in PetPoint contains the word “foster”. If this is checked, and the animal qualifies, there will be a message on the detail page as well.
Detail Page Options
- “Show Fields” detail page: This series of checkboxes allow you to select which fields of PetPoint data should be shown on your WordPress page. Note that if “Site name” is checked then the animal’s site will be shown on all list and detail pages. To show site on only some lists and detail pages, see the shortcode parameter “showsite”. Note, also, that some of the data snet from PetPoint may not be complete, so some longer text fields such as “behavior test result” may be truncated.
Randomize Photo
- Randomize the photos…: If this box is checked, any time PetPress displays a list of animals, it will choose at random which of the (up to three) photos of the animal to use as the image in the tile. This may help to give some animals a second (or even third) chance to catch the eye of a prospective adopter who re-visits the site. It is not necessary for animals to have more than one photo to use this feature (though if an animal has only one photo, that photo will always be the one shown). Note that “photo 1” is more likely to be shown than the others. If there are two photos, it has a 66% chance of being the image shown, and if there are three photos the chance is 50% (with the other two an equal 25% chance each).
Premium Options
PetPress overs a number of options for displaying your data. Not all are available for both PetPoint and PetFinder, because each data source has unique data fields.
Display Options
- Hide “select by name” selector control: You can choose to hide this list.
Premium Reports
There are several additional reports available to premium subscribers:
- Featured Pets report: (description soon)
- Found Animals report: (description soon)
Using PetPress
The syntax for PetPress is as follows (remember the “[” and the “]“):
PETPRESS species=”1″ heading=”Adoptable Dogs”
Note that shortcode parameters (always lower case) are:
- heading – Appears at the top of the list page.
- id – The PetPoint ID of a specific animal. If you provide an “id” parameter, you do not need to also pass a species parameter.
- report – (BETA FEATURE) If set to “found” (ie: report=”found”), the page will list the found animals data (see below).
- showsite – if this is set to true in the shortcode, then the site will be shown for animals in the resulting list and detail pages even if the global “site” checkbox is unchecked. Note that the reverse is not true: you cannot use this parameter to turn the site off situationally when the global checkbox is checked.
- site – the site code for the location for which you want to display animals. If your organization has multiple sites, you can have different pages for each. NOTE: the site ID is numeric and not the same as your organization ID (that usually starts with “US”). If you don’t know what site ID to use, try “0” which will get all animals (of the specified species) from all sites within the organization.
- sort – The sort order for display. Valid arguments are “age”, “name”, and “weight”. The default value is “name”.
- species – If this field is present, the page will list all available animals of that species for the specified site. Valid arguments are: 1 = dogs, 2 = cats, 3 = rabbits, 4 = horses, 5 = small & furry, 6 = pigs, 7 = reptiles, 8 = birds, 9 = barnyard animals, and 1003 = animals that are not dogs or cats.
Either “species” or “id” is always required. Other parameters are optional.
Troubleshooting
Troubleshooting on setup
The most common problem with new setups relates to the enabling of web services by PetPoint. Web services are not turned on by default; you must contact PetPoint support and ask them to enable web services for you. This will probably take 24 hours to perform. Note that the IFRAME approach does not require web services, so do not assume that web services are on just because you have been using the IFRAME.
If you have confirmed that web services are on, check your Auth Key. If your Auth Key is missing or invalid, you should get a warning from the plugin. Also, make sure that your shortcode includes either a species or an individual animal ID. Finally, make sure that the quotation marks in your shortcode are actual “straight quotes” and not “curly quotes”.
Troubleshooting after setup
Although PetPoint web services are generally reliable, they are prone to occasional outages. This may result in empty rosters or the inability to view individual animals (whether or not they appear on the roster). Most outages resolve within a few hours. PetPoint has set up a health monitor page, though it does not always show short outages. If your installation of PetPress has been working fine and suddenly has problems, it is likely an issue on the PetPoint side. The caching routine will not discard old cache data until new data is available, so theoretically the plugin should continue to work through a PetPoint outage.
Troubleshooting data issues
PetPress reports the data sent to it from PetPoint. If your shelter is using PetPoint in a non-standard way, certain display fields in PetPress may not function the way that you want. Also, some longer text fields in PetPoint may be truncated when they are sent to PetPress, and this is unavoidable.
There may be a delay between updating data in PetPoint and seeing the change on your site. Asking PetPoint for data on every click taxes the PetPoint service and results in a slower user experience (because of the extra communication that has to happen). See “understanding caching” below for more information.
Tips and hints
Create links directly to specific animals
“id”, the parameter you can include to show details on a specific animal, and “sort” can also be sent as query string parameters (eg: www.yoursite.com/petpresspage/?id=XXXXXXXXX). By including the querystring “id” parameter, you can create links to specific animals, but be aware that such links will only be useful as long as the animal in question is available for adoption.
Using the “heading” shortcode parameter
You may be wondering why you would want to use the “heading” shortcode parameter rather than simply putting a heading on your webpage above the shortcode. The answer is that the “heading” parameter will be shown above the animal lists and not the animal details, giving you additional flexibility in customizing your list pages.
Understanding caching
For best performance, PetPress refreshes the animal data every thirty minutes in the background. To distribute the load on PetPoint, dogs, cats, and other animals are fetched at different times during this thirty-minute window. In order to see when the refreshes will happen (or to force a refresh) I recommend the WP-Crontrol plugin. Administrators, note that the very first background cache will happen approximately thirty minutes from your activating PetPress. If you begin to view animals before this background task is executed, you may see a short delay in your first page load as the cache is built for the first time.
Interactions with other plug-ins
SEO tools such as Yoast
PetPress generates specific page titles (eg: “Hambone the Dog (Redbone Coonhound)”) for animal detail pages. These page titles may be overwritten by SEO plugins which generate their own page titles. It is recommended that you do not use SEO plugins on the page(s) that use PetPress if they interfere with this plugin’s title generation. SEO plugins may also overwrite the canonical URLs, making it impossible to create Facebook posts for individual animals.
Page caching plugins
PetPress caches animal data in order to maximize the responsiveness (calls to PetPoint are time consuming). If you are having difficulty with your PetPress pages showing the wrong information (eg: listing animals that are no longer available for adoption) and you are using a third party caching system, try excluding the web pages that use PetPress from the list of pages being cached.
Future Functionality / Roadmap
The current version of PetPress has been heavily tested and should be particularly reliable. Going forward, reliability will continue to be the top priority, though there will be some additional features added in upcoming revisions.
We are looking for feedback by current users of PetPress to help establish the roadmap. If you are a current or prospective user of this plugin, please contact us and let us know about your experience.
Of course, if you really love it, please leave a review on the WordPress.org site, and consider making a donation to support future enhancements. The animals you’ll be helping thank you!
Where to get more help
Airdrie Media would be more than happy to consult on your PetPoint-integrated website project, whether as the primary agency or as a specialist subcontractor. Contact us to learn more.
As far as changes and enhancements go, these fall into three categories:
- Bug fixes are the top priority. Please report any bugs, and these will move to the top of the to-do list. Note, please, that we do use the developer’s definition of bug, rather than the more general “it doesn’t do what I want it to do” !
- Enhancements are extensions of the plug-in functionality to better integrate PetPoint with WordPress. An enhancement will –at least theoretically– improve the user experience for all PetPress users. Please request whatever enhancements you think would make this a better plug-in. If you really want an enhancement, a donation might be just the thing to move your request higher up in the priority queue.
- Customizations are site or shelter-specific changes to the plug-in to fit your particular needs. This may be important to you if your shelter is not using PetPoint is a completely orthodox way. For a fee, Airdrie Media can create a customized version of the plug-in for you to suit your particular needs. Contact us for a free consultation.