Shout

• Compatibility
• Installation
• Usage
• Custom Colors
• Icons
  • Changing the icon
  • Icon Size
  • Disabling the icon
• Headings
• Actions
• Changelog
• Contributing
  • Development
• Security Vulnerabilities
• Credits
• License

A simple inline contextual notice for Filament forms and infolist, basically just a fancy placeholder.

#Compatibility

#Installation

You can install the package via composer:

composer require awcodes/shout

[!IMPORTANT] If you have not set up a custom theme and are using Filament Panels follow the instructions in the Filament Docs first.

After setting up a custom theme add the plugin's views to your theme css file or your app's css file if using the standalone packages.

@source '../../../../vendor/awcodes/shout/resources/**/*.blade.php';

#Usage

Simply include the component in any of your form or infolists schema() methods.

use Awcodes\Shout\Components\Shout;

Shout::make('so-important')
    ->content('This is a test')

#Custom Colors

You can use the color() method to set a custom color using Filament's Color Object.

use Awcodes\Shout\Components\Shout;
use Filament\Support\Colors\Color;

Shout::make('so-important')
    ->content('This is a test')
    ->color(Color::Lime)

Shout::make('so-important')
    ->content('This is a test')
    ->color(Color::hex('#badA55'))

#Icons

#Changing the icon

use Awcodes\Shout\Components\Shout;

Shout::make('so-important')
    ->content('This is a test')
    ->icon('heroicon-s-circle-check')

#Icon Size

use Awcodes\Shout\Components\Shout;

Shout::make('so-important')
    ->content('This is a test')
    ->iconSize('sm|md|lg|xl')

#Disabling the icon

use Awcodes\Shout\Components\Shout;

Shout::make('so-important')
    ->content('This is a test')
    ->icon(false)

#Headings

You can add a heading to your shout using the heading() method. By default , the heading will be a h2 element, but you can override this by using an HtmlString object.

use Awcodes\Shout\Components\Shout;

Shout::make('so-important')
    ->heading('Important Notice')
    ->content('This is a test')

#Actions

You can add actions to your shout using the actions() method. This accepts an array of Filament Action objects.

use Awcodes\Shout\Components\Shout;
use Filament\Actions\Action;

Shout::make('so-important')
    ->content('This is a test')
    ->actions([
        Action::make('action1')
            ->label('Action 1')
            ->url('https://example.com'),
        Action::make('action2')
            ->label('Action 2')
            ->url('https://example.com'),
    ])

#Changelog

Please see CHANGELOG for more information on what has changed recently.

#Contributing

Please see CONTRIBUTING for details.

#Development

Install dependencies and run the test suite:

composer install
composer test

Start the Workbench application:

composer serve

The Workbench is available at /admin. Sign in with test@example.com and password.

#Security Vulnerabilities

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

#Credits

• Adam Weston
• All Contributors

#License

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