Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/randomecho/petfinder-via-kohana
Kohana 3.2 module to wrap around the Petfinder.com API
https://github.com/randomecho/petfinder-via-kohana
Last synced: about 1 month ago
JSON representation
Kohana 3.2 module to wrap around the Petfinder.com API
- Host: GitHub
- URL: https://github.com/randomecho/petfinder-via-kohana
- Owner: randomecho
- License: bsd-3-clause
- Created: 2012-01-14T04:08:16.000Z (almost 13 years ago)
- Default Branch: master
- Last Pushed: 2012-10-18T02:14:14.000Z (about 12 years ago)
- Last Synced: 2024-10-16T07:55:01.251Z (3 months ago)
- Language: PHP
- Homepage: http://randomecho.com/source/petfinder
- Size: 141 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Petfinder via Kohana
Use this module to easily connect a Kohana 3.2 powered website with the Petfinder API and display pet or shelter information as needed from its database.
Initially developed for use at [KentuckyAnimalRescue.org](http://kentuckyanimalrescue.org/ "Little Hills of Kentucky Animal Rescue, Inc.")
## Install
To add this to your site, you'll need to adjust your bootstrap.php file accordingly.
### Kohana::Modules
Enable the module by adding it to the `Kohana::modules` array. Name it as you please, but the path should match its location.
Kohana::modules(array(
'petfinder' => MODPATH.'petfinder', // Petfinder API
));### Route::set
Here is an example route you can drop into the `Route::set` rules
Route::set('petfinder', 'petfinder(/(/))')
->defaults(array(
'controller' => 'petfinder',
'action' => 'index',
));## Calling the API
There are many method calls you can issue to the API. In this showing, we're calling the method of the module that will pluck a pet's details at random:
Petfinder::random();
The initial result will be an object data of the pet's information in either XML or JSON format. What's ultimately sent back after the module has its way will be an homogenised array for easier handling in the controller and/or view.
More examples on how to call up the Petfinder module can be found in the **application/classes/controller/petfinder.php** file.
## Configuration
With your API key and secret, head on over to **modules/petfinder/config/petfinder.php** and drop them in.
You can select either XML or JSON format for the Petfinder API return results, but as the module will render the data in a no fuss, single format whatever you choose, it doesn't really matter.
## API key
For a developer API key, go to [petfinder.com/developers/api-key](http://www.petfinder.com/developers/api-key)
### Petfinder API documentation
To get a breakdown of the GET methods and parameters used to connect with the Petfinder API, you can read the documentation found at [petfinder.com/developers/api-docs](http://www.petfinder.com/developers/api-docs)