laravel-model-status GitHub Details, Stars and Alternatives | OpenRepoFinder
thefeqy / repository
laravel-model-status
A Laravel package to automate adding configurable status columns to models and migrations. This package provides an easy-to-use HasActiveScope trait, a Status enum, middleware for ensuring active users, and a custom Artisan command to streamline your workflow.
A transparent discovery signal based on current public GitHub metadata.
Recent activity35% weight
30
Community adoption25% weight
25
Maintenance state20% weight
100
License clarity10% weight
100
Project information10% weight
100
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
README preview
🔁 Laravel Model Status
A Laravel package that simplifies status management for Eloquent models.
Now, the package will automatically adapt to your setup.
Usage
Using the HasActiveScope Trait
To enable status management in a model:
use Thefeqy\ModelStatus\Traits\HasActiveScope;
class Product extends Model
{
use HasActiveScope;
protected $fillable = ['name'];
}
Now, inactive models are automatically excluded from queries.
Querying Models
Get Active Models (Default Behavior)
$activeProducts = Product::all(); // Returns only active products
Get All Models (Including Inactive)
$allProducts = Product::inActive()->get();
Manually Activating / Deactivating a Model
$product = Product::find(1);
$product->activate(); // Set status to "active"
$product->deactivate(); // Set status to "inactive"
Checking a Model's Status
if ($product->status->isActive()) {
echo "Product is active!";
}
if ($product->status->isInactive()) {
echo "Product is inactive!";
}
Using Status Casting
To ensure status is always cast to a Status object, use the StatusCast class.
Apply Status Casting in Models
use Thefeqy\ModelStatus\Casts\StatusCast;
class Product extends Model
{
use HasActiveScope;
protected $fillable = ['name', 'status', 'category_id'];
protected $casts = [
'status' => StatusCast::class,
];
}
Example Usage
$product = Product::find(1);
if ($product->status->isActive()) {
echo "Product is active!";
}
Now, $product->status is an instance of Status, allowing method calls like isActive() and isInactive().
Cascade Deactivation
If a model is deactivated, its related models can also be automatically deactivated.
Example
class Category extends Model
{
use HasActiveScope;
protected $fillable = ['name', 'status'];
protected array $cascadeDeactivate = ['products'];
public function products()
{
return $this->hasMany(Product::class);
}
}
Now, deactivating a category will also deactivate all products under it:
The package includes the EnsureAuthenticatedUserIsActive middleware, which enforces that only users with an active status can access certain routes.
Add Middleware to Routes
Instead of registering a string alias for the middleware, you can reference it by class name in your route definition:
use Illuminate\Support\Facades\Route;
use Thefeqy\ModelStatus\Middleware\EnsureAuthenticatedUserIsActive;
Route::middleware(['auth', EnsureAuthenticatedUserIsActive::class])->group(function () {
Route::get('/dashboard', function () {
return 'Welcome to your dashboard!';
});
});
Admin Bypass for Active Scope
By default, admin users can see inactive models.
This behavior is controlled in config/model-status.php:
'admin_detector' => function () {
return auth()->check() && auth()->user()->is_admin;
},
Advanced Configuration
If you need a different column name or status values, update .env:
