Added Reviews Tag

README.md

@@ -46,6 +46,16 @@ Our customers give us a {{ $reviews['score'] }}/10 across {{ $reviews['count'] }
 
 You can also use `$reviews['scores'][7]` to display how many reviews have a 7/10 rating.
 
+## Tag
+
+We integrated a Statamic Tag called `Reviews` which will allow you to get some basic data from the reviews like ratings and review content.
+
+Blade example:
+
+```php
+Statamic::tag('reviews:get_rating_data')->fetch();
+```
+
 ## Publishables
 
 You can publish all of the publishables with:

src/ServiceProvider.php

@@ -4,10 +4,15 @@
 
 use JustBetter\StatamicFeedbackCompany\Commands\HarvestReviewsCommand;
 use JustBetter\StatamicFeedbackCompany\Commands\RemoveReviewsCommand;
+use JustBetter\StatamicFeedbackCompany\Tags\Reviews;
 use Statamic\Providers\AddonServiceProvider;
 
 class ServiceProvider extends AddonServiceProvider
 {
+    protected $tags = [
+        Reviews::class
+    ];
+
     public function bootAddon()
     {
         $this->bootCommands()

src/Tags/Reviews.php

@@ -0,0 +1,56 @@
+<?php
+
+namespace JustBetter\StatamicFeedbackCompany\Tags;
+
+use Illuminate\Support\Facades\Cache;
+use Statamic\Eloquent\Entries\Entry;
+use Statamic\Entries\EntryCollection;
+use Statamic\Facades\Entry as EntryFacade;
+use Statamic\Tags\Tags;
+
+class Reviews extends Tags
+{
+    public string $reviewTitleId = 'main_open';
+
+    public string $reviewTextId = 'open';
+
+    public function getReviews(int $count = 3): EntryCollection
+    {
+        /* @var EntryCollection $reviews */
+        $reviews = EntryFacade::query()
+            ->where('collection', 'reviews')
+            ->orderBy('review_date', 'DESC')
+            ->limit($count)
+            ->get(['name', 'product', 'review_date', 'questions', 'total_score']);
+
+        return $reviews;
+    }
+
+    public function getReviewData(): array
+    {
+        /** @var Entry $review */
+        $review = $this->params->get('review');
+        $questionsData = $review->questions ?? [];
+
+        return ['title' => $questionsData[$this->reviewTitleId] ?? '', 'text' => $questionsData[$this->reviewTextId] ?? ''];
+    }
+
+    public function getRatingData(): array
+    {
+        return Cache::remember('feedback-company-rating-data', now()->addHour(), function () {
+            $starCounts = [];
+
+            for ($star = 1; $star <= 5; $star++) {
+                $maxScore = $star * 2;
+                $minScore = $maxScore - 2;
+                $reviewsCount = EntryFacade::query()
+                    ->where('collection', 'reviews')
+                    ->whereBetween('total_score', [$minScore, $maxScore])
+                    ->count();
+                $starCounts[$star] = $reviewsCount;
+            }
+
+            return $starCounts;
+        });
+    }
+}