alt-three/badger

A Badge Generator For Laravel 5

v4.0.0 2017-08-06 19:28 UTC

README

A badge generator for Laravel 5.

Installation

This version requires PHP 7, and supports Laravel 5.1, 5.2, 5.3, 5.4, or 5.5.

To get the latest version, simply require the project using Composer:

$ composer require alt-three/badger

Once installed, you need to register the AltThree\Badger\BadgerServiceProvider service provider in your config/app.php, or if you're using Laravel 5.5, this can be done via the automatic package discovery.

Examples

Get started immediately:

// Using the facade
Badger::generate('license', 'MIT', 'blue', 'plastic')

// Dependency injection example
$badger->generate('license', 'MIT', '#ff69b4', 'plastic')

License Blue MIT License Custom MIT

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.

  • brightgreen
  • green
  • yellow
  • yellowgreen
  • orange
  • red
  • blue
  • grey
  • lightgray

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, flat
  • plastic
  • social (without links)

Security

If you discover a security vulnerability within this package, please e-mail us at support@alt-three.com. All security vulnerabilities will be promptly addressed.

License

Alt Three Badger is licensed under The MIT License (MIT).

Based on the work done at badges/poser.