cachethq / badger
A badge generator for Laravel.
Requires
- php: ^8.0
- illuminate/contracts: ^8.0|^9.0|^10.0
- illuminate/support: ^8.0|^9.0|^10.0
Requires (Dev)
- orchestra/testbench: ^8.8
- pestphp/pest: ^2.13
- pestphp/pest-plugin-laravel: ^2.2
README
An SVG badge generator for Laravel.
Installation
This version requires PHP 8.2 and Laravel 11.0 and above. For older versions of PHP or Laravel, check out the 3.x branch.
To get the latest version, simply require the project using Composer:
composer require cachethq/badger
Once installed, if you are not using automatic package discovery, then you need to register the Cachet\Badger\BadgerServiceProvider service provider in your config/app.php.
Examples
Get started immediately:
// Using the Facade Badger::generate('license', 'MIT', 'blue', 'plastic') // Dependency injection example $badger->generate('license', 'MIT', '#ff69b4', 'plastic')
Usage
The generate method takes four parameters:
Badger::generate('license', 'MIT', 'blue', 'flat-square')
The first parameter is the subject, or what it is the badge is showing. In the example above this is the license. The second parameter is the value (the right hand of the badge). Next is the color of the badge. This can be one of the following preset colors or a valid hex string.
brightgreengreenyellowyellowgreenorangeredbluegreylightgray
And finally the fourth parameter is the badge type. This determines the style of the badge and can be one of the four values below.
flat-square(default)plastic-flat,flatplasticsocial(without links)
Security
If you discover a security vulnerability within this package, please e-mail us at support@cachethq.io. All security vulnerabilities will be promptly addressed.
License
Cachet Badger is licensed under The MIT License (MIT).
Based on the work done at badges/poser.