Added getReviewsByRating.

Author: codebyray

src/Contracts/ReviewRateableContract.php

@@ -150,4 +150,15 @@ public function ratingCounts(?string $department = null, bool $approved = true):
      * @return array
      */
     public function ratingStats(?string $department = null, bool $approved = true): array;
+
+    /**
+     * Return reviews based on star ratings.
+     *
+     * @param int $starValue
+     * @param string|null $department
+     * @param bool $approved
+     * @param bool $withRatings
+     * @return Collection
+     */
+    public function getReviewsByRating(int $starValue, string $department = null, bool $approved   = true, bool $withRatings = true): Collection;
 }

src/Services/ReviewRateableService.php

@@ -236,4 +236,19 @@ public function ratingStats(?string $department = null, bool $approved = true):
     {
         return $this->getModel()->ratingStats($department, $approved);
     }
+
+    /**
+     * Return reviews based on star ratings.
+     *
+     * @param int $starValue
+     * @param string|null $department
+     * @param bool $approved
+     * @param bool $withRatings
+     * @return Collection
+     * @throws Exception
+     */
+    public function getReviewsByRating(int $starValue, string $department = null, bool $approved = true, bool $withRatings = true): Collection
+    {
+        return $this->getModel()->getReviewsByRating($starValue, $department, $approved, $withRatings);
+    }
 }

src/Traits/ReviewRateable.php

@@ -472,4 +472,29 @@ public function ratingStats(?string $department = null, bool $approved = true):
             'total'       => $total,
         ];
     }
+
+    /**
+     * Return reviews based on star ratings.
+     *
+     * @param int $starValue
+     * @param string|null $department
+     * @param bool $approved
+     * @param bool $withRatings
+     * @return Collection
+     */
+    public function getReviewsByRating(int $starValue, string $department = null, bool $approved   = true, bool $withRatings = true): Collection
+    {
+        $query = $this->reviews()
+            ->when($approved, fn($q) => $q->where('approved', $approved))
+            ->when($department, fn($q) => $q->where('department', $department))
+            ->whereHas('ratings', fn($q) =>
+            $q->where('value', $starValue)
+            );
+
+        if ($withRatings) {
+            $query->with('ratings');
+        }
+
+        return $query->get();
+    }
 }