Skip to content

caendesilva/filament-simple-highlight-field-plugin

Repository files navigation

desilva/filament-simple-highlight-field

Latest Version on Packagist Total Downloads

Adds a simple read-only Highlight.js pseudo-field to FilamentPHP

Adds a simple form field that renders a read-only Highlight.js code block for FilamentPHP. The plugin is new and may be unstable and contain bugs. PRs and issue reports are welcome.

Installation

You can install the package via composer:

composer require desilva/filament-simple-highlight-field

This package supports Laravel 9 and Laravel 10.

Usage

Simply use the component as you'd use any other Filament field. It's especially perfect for the resource view page where it blends right in.

use Desilva\FilamentSimpleHighlightField\HighlightField;

class FileResource extends Resource
{
    public static function form(Form $form): Form
    {
        return $form
            ->schema([
                HighlightField::make('contents')
                    ->columnSpan('full'),
            ]);
    }
}

Roadmap

  • Add option to customize the theme
  • Dark mode support (doesn't work with custom theme)
  • Add method chain to specify the language

Configuration

You can publish the config file with:

php artisan vendor:publish --tag="filament-simple-highlight-field-config"

This is the contents of the published config file:

return [
    // By default, the plugin will load serve the assets from Filament. You can uncomment the following to specify
    // a custom theme that will then be loaded from the Highlight.js CDN. See https://highlightjs.org/static/demo
    // 'theme' => 'nord',
];

Optionally, you can publish the views using

php artisan vendor:publish --tag="filament-simple-highlight-field-views"

Changelog

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

Contributing

Contributing is pretty chill and is highly appreciated! Just send a PR and/or create an issue!

Security Vulnerabilities

Please review my General Security Policy on how to report security vulnerabilities.

Credits

License

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