PHPackages reevoo/reevoomark-php-api - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [API Development](/categories/api) 4. / 5. reevoo/reevoomark-php-api ActiveLibrary[API Development](/categories/api) reevoo/reevoomark-php-api ========================= The reevoomark-php-api is a PHP tag library for Reevoo Ratings & Reviews customers who want to quickly and easily integrate Reevoo content in to their sites server-side. 2.4.0(6y ago)849.4k8[2 issues](https://github.com/reevoo/reevoomark-php-api/issues)MITPHP Since Mar 29Pushed 6y ago20 watchersCompare [ Source](https://github.com/reevoo/reevoomark-php-api)[ Packagist](https://packagist.org/packages/reevoo/reevoomark-php-api)[ RSS](/packages/reevoo-reevoomark-php-api/feed)WikiDiscussions master Synced 2d ago READMEChangelog (8)DependenciesVersions (8)Used By (0) reevoomark-php-api ================== [](#reevoomark-php-api) [![Build Status](https://camo.githubusercontent.com/3efd49f7ecd320c5cb2bff744fdf3a16019d485ed962cd821692a7514b778624/68747470733a2f2f7472617669732d63692e6f72672f726565766f6f2f726565766f6f6d61726b2d7068702d6170692e706e673f6272616e63683d6d6173746572)](https://travis-ci.org/reevoo/reevoomark-php-api) Description ----------- [](#description) The reevoomark-php-api is a PHP tag library for Reevoo Ratings & Reviews customers who want to quickly and easily integrate Reevoo content in to their sites server-side. Other Languages --------------- [](#other-languages) Tag libraries are also available for [.NET](https://github.com/reevoo/reevoomark-dotnet-api) and [Java](https://github.com/reevoo/reevoomark-java-api). Features -------- [](#features) - Server-side inclusion of Reevoo content. - Included CSS for display of Reevoo content. - Server-side caching of content that respects the cache control rules set by Reevoo. Support ------- [](#support) For Reevoo Ratings & Reviews customers, support can be obtained by emailing . There is also a [bug tracker](https://github.com/reevoo/reevoomark-php-api/issues) available. Installation ------------ [](#installation) Get Composer from [here](https://getcomposer.org/download/) and install it. Add the reevoo tag lib to your composer.json like so: ``` { "require": { "reevoo/reevoomark-php-api": "2.4.0" } } ``` and then do: ``` $ php composer.phar install ``` Implementation -------------- [](#implementation) Require the PHP library (make sure you use the correct path to the reevoo\_mark.php file) and create new instance of ReevooMark class with your TRKREF and path to your cache directory (or false if you do not want to use cache) as a contructor attributes: ``` ``` ReevooMark supports multiple retailers content on the same page, it such case you can specify multiple TRKREFs in the constructor: ``` ``` To include the relevant CSS call the method `cssAssets()` inside `` section of your page: ``` ... ``` To include the relevant JavaScript call the method `javascriptAssets()` before the closing `` tag your page: ``` ... ``` ### Alternate Implementation [](#alternate-implementation) The standard implementation calls echo internally so is less flexible if you want to use the data in contexts other than your pages. Alternatively you may use the `ReevooMarkApi` class that works in a similar way to `ReevooMark` but returns values directly eg: ``` ``` ### Standard Badges [](#standard-badges) #### Product Badge [](#product-badge) To render "product badges" you can use any of the examples below. The `sku` is compulsory but `trkref` and `variant` are optional. Specify `trkref` only if you are using multiple TRKREFs in `ReevooMark` constructor. ``` ``` #### Conversations Badge [](#conversations-badge) To render "conversations badges" you can use any of the examples below. The `sku` is compulsory but `trkref` and `variant` are optional. Specify `trkref` only if you are using multiple TRKREFs in `ReevooMark` constructor. ``` ``` ### Series Badges [](#series-badges) #### Product Badges [](#product-badges) To render "product series badges" you can use any of the examples below. The `sku` is compulsory and should be set to the series id. The `trkref` and `variant` are optional. Specify `trkref` only if you are using multiple TRKREFs in `ReevooMark` constructor. ``` ``` #### Conversations Badges [](#conversations-badges) To render "conversation series badges" you can use any of the examples below. The `sku` is compulsory and should be set to the series id. The `trkref` and `variant` are optional. Specify `trkref` only if you are using multiple TRKREFs in `ReevooMark` constructor. ``` ``` ### Overall Service Rating Badges [](#overall-service-rating-badges) To render "Overall Service Rating badges" you can use any of the examples below. The `trkref` and `variant` are optional. Specify `trkref` only if you are using multiple TRKREFs in `ReevooMark` constructor. ``` ``` ### Customer Service Rating Badges [](#customer-service-rating-badges) To render "Customer Service Rating badges" you can use any of the examples below. The `trkref` and `variant` are optional. Specify `trkref` only if you are using multiple TRKREFs in `ReevooMark` constructor. ``` ``` ### Delivery Rating Badges [](#delivery-rating-badges) To render "Delivery Rating badges" you can use any of the examples below. The `trkref` and `variant` are optional. Specify `trkref` only if you are using multiple TRKREFs in `ReevooMark` constructor. ``` ``` ### Embedded Product Review Content [](#embedded-product-review-content) To render "embedded review content" you can use any of the examples below. The `sku` attribute is compulsory but `trkref`, `locale`, `numberOfReviews` and `paginated` are optional. Any combination of the optional attributes is possible. Specify `trkref` only if you are using multiple TRKREFs in `ReevooMark` constructor. ``` ``` If you set the `paginated` attribute to true, the embedded reviews will show pagination links. If no reviews are available we will display default message in language specified by your `locale`. If you would like to specify your own message you can pass attribute `showEmptyMessage` with value false and use return value of the `productReviews()` method that is false in this case. ``` Sorry, no product reviews here ``` ### Price Offers Widget [](#price-offers-widget) To render "price offers" you can use the example below. Please provide the `sku` attribute. The `trkref` attribute is only compulsory if you are using multiple TRKREFs in `ReevooMark` constructor. ``` ``` If there are no offers to display you can display your own custom message as in the example below: ``` Sorry, no price offers available for this product ``` ### Embedded Customer Experience Review Content [](#embedded-customer-experience-review-content) To render "embedded customer experience review content" you can use any of the examples below. The `trkref`, `locale`, `numberOfReviews` and `paginated` a attributes are optional. Any combination of the optional attributes is possible. Specify `trkref` only if you are using multiple TRKREFs in `ReevooMark` constructor. ``` ``` If you set the `paginated` attribute to true, the embedded reviews will show pagination links. If no reviews are available we will display default message in language specified by your `locale`. If you would like to specify your own message you can pass attribute `showEmptyMessage` with value false and use return value of the `customerExperienceReviews()` method that is false in this case. ``` Sorry, no customer experience reviews here ``` ### Embedded Conversation Content [](#embedded-conversation-content) To render "embedded conversations content" you can use any of the examples below. The `sku` attribute is compulsory but `trkref` and `locale` are optional. Any combination of the optional attributes is possible. Specify `trkref` only if you are using multiple TRKREFs in `ReevooMark` constructor. ``` ``` If no conversations are available we will display default message in language specified by your `locale`. If you would like to specify your own message you can pass attribute `showEmptyMessage` with value false and use return value of the `conversations()` method that is false in this case. ``` Sorry, no conversations here ``` Tracking -------- [](#tracking) If you display the reviews in a tabbed display, or otherwise require visitors to your site to click an element before seeing the embedded reviews, add the following onclick attribute to track the clickthroughs: If your trkref value is for example "REV" you would add: ``` onclick="ReevooMark_REV.track_click_through(‘’)” ``` If your trkref value is for example "PIU" you would add: ``` onclick="ReevooMark_PIU.track_click_through(‘’)” ``` See how in examples above you need to put your trkref value as a suffix to the `ReevooMark_` part. Also remember to replace `` by the sku of the actual product. ### Purchase Tracking [](#purchase-tracking) If your site includes online shopping functionality you can use `purchaseTrackingEvent()` method on your "Order Confirmation Page". ``` ``` - `skus` attribute value is with a comma separated list of all the skus that have been purchased as part of the order. - `value` attribute value is total price of the order, you don't need to include currency symbol. - `trkref` attribute value you need to specify only if you are using multiple TRKREFs in `ReevooMark` constructor. All this tracking information will be available to you on your Reevoo Analytics account. ### Propensity to Buy Tracking [](#propensity-to-buy-tracking) This type of tracking is used as a substitute of purchase tracking for retailers that do not offer online purchase in their stores and therefore do not have an order confirmation page. These retailers can use `propensityToBuyTrackingEvent()` method which can be added to any page they wish on the site. ``` ``` - `action` attribute value is the type of event that you want to track, can be anything you want like "user visited the buy now page" or "user requested brochure" or "user requested a test drive", etc... - `sku` attribute is optional, you only have to include it if you want to link the tracking event to a specific product SKU - `trkref` attribute value you need to specify only if you are using multiple TRKREFs in `ReevooMark` constructor. All this tracking information will be available to you on your Google Analytics account. More examples ------------- [](#more-examples) Click [here](https://github.com/reevoo/reevoomark-php-api/tree/master/example/index.php) for a full page example of implementation in PHP. \##License This software is released under the MIT license. Only certified Reevoo partners are licensed to display Reevoo content on their sites. Contact for more information. (The MIT License) Copyright (c) 2008 - 2014: - [Reevoo](http://www.reevoo.com) Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ### Health Score 37 — LowBetter than 81% of packages Maintenance15 Infrequent updates — may be unmaintained Popularity31 Limited adoption so far Community26 Small or concentrated contributor base Maturity68 Established project with proven stability Bus Factor4 4 contributors hold 50%+ of commits How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~263 days Recently: every ~379 days Total 7 Last Release 2531d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/032f716d8273a04e8ad67ba5184611f9866cbcb03c0a72b0387c5869b71e3917?d=identicon)[reevoo](/maintainers/reevoo) --- Top Contributors [![errm](https://avatars.githubusercontent.com/u/115280?v=4)](https://github.com/errm "errm (16 commits)")[![pkqk](https://avatars.githubusercontent.com/u/5235?v=4)](https://github.com/pkqk "pkqk (8 commits)")[![pipt](https://avatars.githubusercontent.com/u/640878?v=4)](https://github.com/pipt "pipt (6 commits)")[![tomlea](https://avatars.githubusercontent.com/u/20390?v=4)](https://github.com/tomlea "tomlea (6 commits)")[![davidsevcik](https://avatars.githubusercontent.com/u/116192?v=4)](https://github.com/davidsevcik "davidsevcik (4 commits)")[![zetter](https://avatars.githubusercontent.com/u/149785?v=4)](https://github.com/zetter "zetter (4 commits)")[![lamp](https://avatars.githubusercontent.com/u/80943?v=4)](https://github.com/lamp "lamp (4 commits)")[![tuzz](https://avatars.githubusercontent.com/u/892251?v=4)](https://github.com/tuzz "tuzz (3 commits)")[![kylemcginn](https://avatars.githubusercontent.com/u/477130?v=4)](https://github.com/kylemcginn "kylemcginn (3 commits)")[![gtempesta-pixartprinting](https://avatars.githubusercontent.com/u/32170885?v=4)](https://github.com/gtempesta-pixartprinting "gtempesta-pixartprinting (2 commits)")[![lpil](https://avatars.githubusercontent.com/u/6134406?v=4)](https://github.com/lpil "lpil (2 commits)")[![everythingbehind](https://avatars.githubusercontent.com/u/16871?v=4)](https://github.com/everythingbehind "everythingbehind (2 commits)")[![reneklacan](https://avatars.githubusercontent.com/u/1935686?v=4)](https://github.com/reneklacan "reneklacan (2 commits)")[![ZoeFeltham](https://avatars.githubusercontent.com/u/6154337?v=4)](https://github.com/ZoeFeltham "ZoeFeltham (1 commits)")[![amalkov](https://avatars.githubusercontent.com/u/423236?v=4)](https://github.com/amalkov "amalkov (1 commits)")[![Antti](https://avatars.githubusercontent.com/u/29559?v=4)](https://github.com/Antti "Antti (1 commits)")[![irikuo](https://avatars.githubusercontent.com/u/2143608?v=4)](https://github.com/irikuo "irikuo (1 commits)")[![peteratdennis](https://avatars.githubusercontent.com/u/24475027?v=4)](https://github.com/peteratdennis "peteratdennis (1 commits)")[![robinbortlik](https://avatars.githubusercontent.com/u/228502?v=4)](https://github.com/robinbortlik "robinbortlik (1 commits)")[![adhamu](https://avatars.githubusercontent.com/u/4592613?v=4)](https://github.com/adhamu "adhamu (1 commits)") ### Embed Badge ![Health badge](/badges/reevoo-reevoomark-php-api/health.svg) ``` [![Health](https://phpackages.com/badges/reevoo-reevoomark-php-api/health.svg)](https://phpackages.com/packages/reevoo-reevoomark-php-api) ``` ### Alternatives [exsyst/swagger A php library to manipulate Swagger specifications 35816.3M7](/packages/exsyst-swagger)[hubspot/api-client Hubspot API client 24015.5M18](/packages/hubspot-api-client)[pocketmine/bedrock-protocol An implementation of the Minecraft: Bedrock Edition protocol in PHP 172437.8k11](/packages/pocketmine-bedrock-protocol)[botman/driver-telegram Telegram driver for BotMan 94452.6k6](/packages/botman-driver-telegram) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)