SilverStripe TripAdvisor Integration
This module provides a simple integration of TripAdvisor location profiles including awards, reviews, etc.
Basically it is a wrapper for the Content API of TripAdvisor., (*1)
Official API documentation: https://developer-tripadvisor.com/content-api/, (*2)
Maintainer
Installation
composer require level51/silverstripe-tripadvisor
If you don't like composer you can just download and unpack it to the root of your SilverStripe project., (*3)
Prerequisites
- Obtain a valid TripAdvisor API key at: https://developer-tripadvisor.com/content-api/request-api-access/
- Get the ID of your location. You won't find it anywhere on the location profile's page, just check the URL.
Setup
- Provide your API key and location profile ID in the "Trip Advisor" tab of systems settings section.
- Execute the "Load TripAdvisor profile" action. This will create one
TripAdvisorLocationProfile
and three TripAdvisorReview
records. Caution: This will drop the current profile data if already loaded.
- Go ahead and use it in your code (example snippets):
// Fetch location profile and output number of visits
$profile = TripAdvisorLocationProfile::current();
echo $profile->NumVisits;
// Fetch reviews and render with custom template
return TripAdvisorReview::get()->renderWith('ReviewGrid');
Notes
The logic uses the RestfulService
class and hence does API calls via cURL. It follows the API guidelines in terms of caching so you don't have to worry about that., (*4)