Enum Features

A simple trait to enable a feature system using Enums:

if(AppFeature::welcome_email->enabled()){
    Mail::to($newUser)->send(new WelcomeEmail($newUser));
}

Installation

You can install the package via composer:

composer require defstudio/enum-features

Usage

Features can be enabled on any enum by using the DefinesFeatures trait:

use DefStudio\EnumFeatures\EnumFeatures;

enum AppFeature
{
    use DefinesFeatures; // ← simply add this 

    case multi_language;
    case impersonate;
    case welcome_email;
    
    /* Feature resolution */
    
    //with a single method:
    protected function resolve(Authenticatable $user = null) {
        match($this){
            case self::multi_language => true,
            case self::impersonate => $user->isAdmin(),
            default => false;
        }
    }
    
    //or with a dedicated method:
    
    protected function resolveImpersonate(Authenticatable $user = null){
        return $user->isSuperAdmin();
    }
}

and should be registered in your Provider

class AppServiceProvider extends ServiceProvider
{
    //..
    
    public function boot(): void {
        AppFeature::defineFeatures();
    }
}

then, in code, a feature could be checked to be enabled:

if(AppFeature::multi_language->active()){
    //.. multi language specific code
}

or be disabled

if(AppFeature::impersonate->inactive()){
    throw(new Exception("Impersonate feature is not enabled"));
}

or enforced

AppFeature::impersonate->enforce(); //throws "Feature [impersonate] is not enabled"

Blade directives

In blade files, a feature can be checked with @feature directive:

@feature(AppFeature::multi_language)
<select name="language" xmlns="http://www.w3.org/1999/html">
    <option value="en">English</option>
    <option value="fr">French</option>
    <option value="it">Italian</option>
</select>
@endfeature

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently. Follow Us on Twitter for more updates about this package.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

• Fabio Ivona
• def:studio team
• All Contributors

License

The MIT License (MIT). Please see License File for more information.

Support us

We at def:studio strongly believe that open source is the foundation of all our business and we try to contribute to it by helping other projects to grow along with developing and maintaining our packages. You can support our work by sponsoring us on github!