Modernize package for Laravel 8-12 with bug fixes and tests

- Fix namespace casing, createUniqueRating return type, countNegative return type
- Update composer.json for PHP 8+ and Laravel 8-12 support with auto-discovery
- Replace custom artisan command with publishesMigrations()
- Modernize migration to anonymous class with $table->id()
- Add proper type hints and return types throughout
- Add test suite with 13 tests using orchestra/testbench
- Add GitHub Actions CI workflow
- Update README with modern installation instructions

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: AbdullahGhanem

.github/workflows/tests.yml

@@ -0,0 +1,34 @@
+name: Tests
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        php: [8.1, 8.2, 8.3, 8.4]
+
+    name: PHP ${{ matrix.php }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          extensions: sqlite3
+          coverage: none
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-interaction
+
+      - name: Run tests
+        run: vendor/bin/phpunit

README.md

@@ -1,138 +1,124 @@
-[![Latest Stable Version](https://poser.pugx.org/ghanem/rating/v/stable.svg)](https://packagist.org/packages/ghanem/rating) [![License](https://poser.pugx.org/ghanem/rating/license.svg)](https://packagist.org/packages/ghanem/rating)
-
-[![Total Downloads](https://poser.pugx.org/ghanem/rating/downloads.svg)](https://packagist.org/packages/ghanem/rating)
+[![Latest Stable Version](https://poser.pugx.org/ghanem/rating/v/stable.svg)](https://packagist.org/packages/ghanem/rating) [![License](https://poser.pugx.org/ghanem/rating/license.svg)](https://packagist.org/packages/ghanem/rating) [![Total Downloads](https://poser.pugx.org/ghanem/rating/downloads.svg)](https://packagist.org/packages/ghanem/rating)
 
 # Laravel Rating
-![https://scontent-cai1-1.xx.fbcdn.net/v/t31.0-8/18192521_1536772739688541_5883708562629992092_o.jpg?oh=281577e64a1e326ff1989f047ab21df6&oe=59BAEBCA](https://scontent-cai1-1.xx.fbcdn.net/v/t31.0-8/18192521_1536772739688541_5883708562629992092_o.jpg?oh=281577e64a1e326ff1989f047ab21df6&oe=59BAEBCA)
-Rating system for laravel 5
 
-## Installation
+Rating system for Laravel 8, 9, 10, 11 & 12.
 
-First, pull in the package through Composer.
+## Installation
 
-```js
+```bash
 composer require ghanem/rating
 ```
-or add this in your project's composer.json file .
-````
-"require": {
-  "Ghanem/Rating": "1.*",
-}
-````
 
-And then include the service provider within `app/config/app.php`.
+The package uses Laravel's auto-discovery, so no need to manually register the service provider.
 
-```php
-'providers' => [
-    Ghanem\Rating\RatingServiceProvider::class
-];
-```
-
------
 ## Getting started
-After the package is correctly installed, you need to generate the migration.
-````
-php artisan rating:migration
-````
 
-It will generate the `<timestamp>_create_ratings_table.php` migration. You may now run it with the artisan migrate command:
-````
+Publish and run the migration:
+
+```bash
+php artisan vendor:publish --provider="Ghanem\Rating\RatingServiceProvider"
 php artisan migrate
-````
+```
 
-After the migration, one new table will be present, `ratings`.
+This creates the `ratings` table.
 
 ## Usage
+
 ### Setup a Model
+
+Add the `Ratingable` trait to any model you want to be ratable:
+
 ```php
 <?php
 
-namespace App;
+namespace App\Models;
 
-use Ghanem\Rating\Traits\Ratingable as Rating;
+use Ghanem\Rating\Traits\Ratingable;
 use Illuminate\Database\Eloquent\Model;
 
-class Post extends Model implements Rating
+class Post extends Model
 {
-    use Rating;
+    use Ratingable;
 }
 ```
 
 ### Create a rating
+
 ```php
 $user = User::first();
 $post = Post::first();
 
 $rating = $post->rating([
     'rating' => 5
 ], $user);
-
-dd($rating);
 ```
 
 ### Create or update a unique rating
-```php
-$user = User::first();
-$post = Post::first();
 
+Only one rating per author per model:
+
+```php
 $rating = $post->ratingUnique([
     'rating' => 5
 ], $user);
-
-dd($rating);
 ```
 
 ### Update a rating
+
 ```php
-$rating = $post->updateRating(1, [
+$rating = $post->updateRating($ratingId, [
     'rating' => 3
 ]);
 ```
 
-### Delete a rating:
+### Delete a rating
+
 ```php
-$post->deleteRating(1);
+$post->deleteRating($ratingId);
 ```
 
-### fetch the Sum rating:
-````php
-$post->sumRating
+### Average rating
 
-// $post->sumRating() also works for this.
-```` 
+```php
+$post->avgRating    // attribute
+$post->avgRating()  // method
+```
 
-### fetch the average rating:
-````php
-$post->avgRating
+### Sum rating
 
-// $post->avgRating() also works for this.
-````
+```php
+$post->sumRating    // attribute
+$post->sumRating()  // method
+```
 
-### fetch the rating percentage. 
-This is also how you enforce a maximum rating value.
-````php
-$post->ratingPercent
+### Rating percentage
 
-$post->ratingPercent(10)); // Ten star rating system
-// Note: The value passed in is treated as the maximum allowed value.
-// This defaults to 5 so it can be called without passing a value as well.
-````
+```php
+$post->ratingPercent       // defaults to max of 5
+$post->ratingPercent(10)   // ten star rating system
+```
 
-### Count positive rating:
-````php
-$post->countPositive
+### Count positive ratings
+
+```php
+$post->countPositive    // attribute
+$post->countPositive()  // method
+```
 
-// $post->countPositive() also works for this.
-````
+### Count negative ratings
 
-### Count negative rating:
-````php
-$post->countNegative
+```php
+$post->countNegative    // attribute
+$post->countNegative()  // method
+```
 
-// $post->countNegative() also works for this.
-````
+## Testing
 
+```bash
+composer test
+```
 
 ## Sponsor
 
-[💚️ Become a Sponsor](https://github.com/sponsors/AbdullahGhanem)
+[Become a Sponsor](https://github.com/sponsors/AbdullahGhanem)

composer.json

@@ -1,22 +1,43 @@
 {
     "name": "ghanem/rating",
-    "description": "Rating syetem for Laravel",
-    "keywords": ["rating", "Ratable", "laravel"],
+    "description": "Rating system for Laravel",
+    "keywords": ["rating", "ratable", "laravel", "stars", "review"],
     "license": "MIT",
     "authors": [
         {
             "name": "abdullah ghanem",
             "email": "3bdullah.ghanem@gmail.com"
         }
     ],
-    "minimum-stability": "dev",
     "require": {
-        "php": "^7.4|^8.0",
-        "illuminate/support": "^5.0|^7.0|^8.0"
+        "php": "^8.0",
+        "illuminate/support": "^8.0|^9.0|^10.0|^11.0|^12.0",
+        "illuminate/database": "^8.0|^9.0|^10.0|^11.0|^12.0"
+    },
+    "require-dev": {
+        "orchestra/testbench": "^6.0|^7.0|^8.0|^9.0|^10.0",
+        "phpunit/phpunit": "^9.0|^10.0|^11.0"
     },
     "autoload": {
         "psr-4": {
             "Ghanem\\Rating\\": "src/"
         }
-    }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Ghanem\\Rating\\Tests\\": "tests/"
+        }
+    },
+    "extra": {
+        "laravel": {
+            "providers": [
+                "Ghanem\\Rating\\RatingServiceProvider"
+            ]
+        }
+    },
+    "scripts": {
+        "test": "vendor/bin/phpunit"
+    },
+    "minimum-stability": "dev",
+    "prefer-stable": true
 }