toin0u / trustpilot
Trustpilot wrapper PHP 5.3+ library
Installs: 20 114
Dependents: 0
Suggesters: 0
Security: 0
Stars: 3
Watchers: 2
Forks: 3
Open Issues: 0
Requires
- php: >=5.3.0
- ext-curl: *
- ext-zlib: *
- toin0u/http-adapter: ~1.0
Requires (Dev)
- satooshi/php-coveralls: ~0.6
- symfony/filesystem: v2.2.0
- symfony/finder: v2.2.1
Suggests
- symfony/filesystem: Enabling Finder allows you to use the cache File
- symfony/finder: Enabling Finder allows you to use the cache File
README
Please note that the JSON feed has been discontinued
This PHP 5.3+ library helps you to interact with the Trustpilot Developer Feed.
Installation
This library can be found on Packagist. The recommended way to install this is through composer.
Run these commands to install composer, the library and its dependencies:
$ curl -sS https://getcomposer.org/installer | php
$ php composer.phar require toin0u/trustpilot:@stable
Now you can add the autoloader, and you will have access to the library:
<?php require 'vendor/autoload.php';
If you don't use neither Composer nor a ClassLoader in your application, just require the provided autoloader:
<?php require_once 'src/autoload.php';
Usage
First of all, you can set up a cache object which will cache your feed. There is no default cache and currently
there is only \Trustpilot\Cache\File
. You can provide your own cache by implementing
\Trustpilot\Cache\CacheInterface
.
- File cache (you need to install Symfony Finder and Filesystem components)
File($cacheTimeLimit = self::CACHE_TIME_LIMIT, $temporaryFolderName = self::TEMPORARY_FOLDER_NAME)
$cacheTimeLimit
must be something that strtotime() is able to parse, '> now - 3 hours' is set by default.$temporaryFolderName
must be a string, 'trustpilot' is set by default.
You need an HttpAdapter
which is responsible to get data from Trustpilot Feed.
You can provide your own adapter by implementing HttpAdapter\HttpAdapterInterface
.
<?php require 'vendor/autoload.php'; use Trustpilot\Trustpilot; use Trustpilot\Cache\File; use HttpAdapter\CurlHttpAdapter; $cache = new File('> now - 1 hour', 'my_temporary_folder'); // optional $adapter = new CurlHttpAdapter(); // the default one $trustpilot = new Trustpilot(917278, $cache, $adapter); try { printf("Last update: %s\n", $trustpilot->getLastUpdate()->getHuman()); printf("Domain name: %s\n", $trustpilot->getDomainName()); printf("Page url: %s\n", $trustpilot->getUrl()); printf("Total reviews: %u\n", $trustpilot->getTotalReviews()); $distributionOverStars = $trustpilot->getDistributionOverStars(); printf("- 1: %u\n", $distributionOverStars[0]); printf("- 2: %u\n", $distributionOverStars[1]); printf("- 3: %u\n", $distributionOverStars[2]); printf("- 4: %u\n", $distributionOverStars[3]); printf("- 5: %u\n", $distributionOverStars[4]); printf("Trust Score (between 0 and 100): %u\n", $trustpilot->getTrustScore()->getScore()); printf("Trust Score in stars (between 1 and 5): %u\n", $trustpilot->getTrustScore()->getStars()); printf("Trust Score: %s\n", $trustpilot->getTrustScore()->getReadableScore()); printf("Trust Score image url: %s\n", $trustpilot->getTrustScore()->getImageUrl('medium')); foreach ($trustpilot->getReviews() as $review) { printf("Review date: %s\n", $review->getTime()->getDateTime()->format('Y-m-d H:i:s')); printf("Review title: %s\n", $review->getTitle()); printf("Review content: %s\n", $review->getContent()); printf("Review company reply: %s\n", $review->getCompanyReply()); printf("Review url: %s\n", $review->getUrl()); printf("Review verified: %s\n", $review->isVerified() ? 'yes' : 'no'); printf("Review Trust Score (between 0 and 100): %u\n", $review->getTrustScore()->getScore()); printf("Review Trust Score in stars (between 1 and 5): %u\n", $review->getTrustScore()->getStars()); printf("Review Trust Score: %s\n", $review->getTrustScore()->getReadableScore()); printf("Review Trust Score image url: %s\n", $review->getTrustScore()->getImageUrl('medium')); printf("Review user name: %s\n", $review->getUser()->getName()); printf("Review user city: %s\n", $review->getUser()->getCity()); printf("Review user locale: %s\n", $review->getUser()->getLocale()); printf("Review user total reviews: %u\n", $review->getUser()->getTotalReviews()); printf("Review user verified: %s\n", $review->getUser()->isVerified() ? 'yes' : 'no'); printf("Review user profile image: %s\n", $review->getUser()->hasImage() ? 'yes' : 'no'); printf("Review user profile image url: %s\n", $review->getUser()->getImageUrl('i35')); } foreach ($trustpilot->getCategories() as $category) { printf("Category name: %s\n", $category->getName()); printf("Category position: %u\n", $category->getPosition()); printf("Category total domains: %u\n", $category->getTotalDomain()); printf("Category position image url: %s\n", $category->getImageUrl('i280')); } } catch (Exception $e) { die($e->getMessage()); }
You will get someting like:
Last update: 05 April 2013 12:14:17 GMT
Domain name: demoshop.com
Page url: http://www.trustpilot.co.uk/review/demoshop.com
Total reviews: 105
- 1: 3
- 2: 1
- 3: 11
- 4: 28
- 5: 62
Trust Score (between 0 and 100): 84
Trust Score in stars (between 1 and 5): 4
Trust Score: Good
Review date: 2013-03-07 13:58:36
Review title: Testing testing
Review content: Testing like a boss!!!!
Review company reply:
Review url: http://www.trustpilot.co.uk/review/demoshop.com#3943492
Review verified: no
Review Trust Score (between 0 and 100): 100
Review Trust Score in stars (between 1 and 5): 5
Review Trust Score: Excellent
Review Trust Score image url: //s3-eu-west-1.amazonaws.com/s.trustpilot.com/images/tpelements/stars/m/5.png
Review user name: Jacob Mortensen
Review user city: Amager
Review user locale: da-DK
Review user total reviews: 2
Review user verified: no
Review user profile image: yes
Review user profile image url: //s3-eu-west-1.amazonaws.com/images.trustpilot.com/CloudImages/User/881929/35x35.png
...
Category name: Accounting
Category position: 3
Category total domains: 7
Category position image url: //s3-eu-west-1.amazonaws.com/s.trustpilot.com/images/tpelements/category_badge/en_280_3.png
Category name: Bags and Luggage
Category position: 7
Category total domains: 21
Category position image url: //s3-eu-west-1.amazonaws.com/s.trustpilot.com/images/tpelements/category_badge/en_280_10.png
API
Trustpilot
getDomainName()
: The name of the domain. E.g. "demoshop.com".getLastUpdate()
: The time this feed was generated which is aTrustpilot\Time\Time
object.getUrl()
: The url for the review page of this domain on Trustpilot.getTotalReviews()
: The total number of reviews of this domain,integer
.getDistributionOverStars()
: An arraygetReviews()
: A list of up to 10 reviews of this domain. These reviews are selected by:- The reviews that the administrator of the domain have selected for the feed
- Select from the remaining reviews, order by rating descending, then by date descending
- It's an array of
Trustpilot\Review\Review
objects.
getCategories()
: The categories of this domain.- May contain zero to multiple elements.
- It's an array of
Trustpilot\Category\Category
objects.
getTrustScore()
: The score of this domain which is aTrustpilot\TrustScore\TrustScore
object.
Category
getName()
: The name of the category localized to the language of the domain.getPosition()
: The position in the category,integer
.getTotalDomain()
: The amount of domains in the category,integer
.getImageUrl($size = 'i100')
: The image in different sizes and can be found with the argument,i100
,i120
,i140
,i180
,i220
andi280
for the six different pixel sizes.
Time
getDateTime()
: The\DateTime
object.getHuman()
: A human readable representation of the time localized to the language of the domain. E.g.4 October 2011 10:16:52 GMT
getUnixTime()
: The number of seconds since January 1st, 1970 to this time,integer
.getHumanDate()
: A human readable representation of the date part of the time localized to the language of the domain. E.g. `15. Oct
TrustScore
getScore()
: A score from 0 to 100,integer
.getStars()
: A number of start from 1 to 5,integer
.getReadableScore()
: A description of the score, localized to the language of the domain. E.g.Excellent
orGood
.getImageUrl($size = 'small')
: The image that shows the number of stars. It comes in three different sizes which can be found on the argumentssmall
,medium
, andlarge
.
User
getName()
: The name of the user.getCity()
: The city of the user if any, null otherwise.getLocale()
: The locale or culture of the user. E.g. "en-GB" for British.getTotalReviews()
: The total number of reviews written by this user,integer
.isVerified()
: True if the user is verified, false otherwise.hasImage()
: True if the user have a profile image, false otherwise.getImageUrl($size = 'i24')
: The image url of the profile image. If the user does not have a profile picture, the url will point to a default profile image. The sizes can be found on these arguments:i24
,i35
,i64
andi73
.
Review
getTime()
: The creation date of the review which is aTrustpilot\Time\Time
object.getTitle()
: The title of the review.getContent()
: The main content of the review.getTrustScore()
: TheTrustpilot\TrustScore\TrustScore
object.getCompanyReply()
: The company reply of this review if any, null otherwise.getUser()
: The author of the review which is aTrustpilot\User\User
object.getUrl()
: The url to the review.isVerified()
: True if this review is verified, false otherwise.
Unit Tests
To run unit tests, you'll need cURL
and zlib
extensions and a set of dependencies,
you can install them using Composer:
$ php composer.phar install --dev
Once installed, just launch the following command:
$ phpunit --coverage-text
Contributing
Please see CONTRIBUTING for details.
Credits
Acknowledgments
Changelog
Support
Please open an issues in github
Contributor Code of Conduct
As contributors and maintainers of this project, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
We are committed to making participation in this project a harassment-free experience for everyone, regardless of level of experience, gender, gender identity and expression, sexual orientation, disability, personal appearance, body size, race, age, or religion.
Examples of unacceptable behavior by participants include the use of sexual language or imagery, derogatory comments or personal attacks, trolling, public or private harassment, insults, or other unprofessional conduct.
Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct. Project maintainers who do not follow the Code of Conduct may be removed from the project team.
Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by opening an issue or contacting one or more of the project maintainers.
This Code of Conduct is adapted from the Contributor Covenant, version 1.0.0, available at http://contributor-covenant.org/version/1/0/0/
License
Trustpilot is released under the MIT License. See the bundled LICENSE file for details.