Download the PHP package discoverlance/filament-page-hints without Composer

Filament Page Hints for Filament Admin Panel

Create hints for your Filament pages that can serve as a guideline for users. You can create hints for each page and it will open a sidebar when the user clicks on it to view hints for a page.

Installation

You can install the package via composer:

Quickstart

To quickly get started, you can install the package config, migration and optionally run the your migrations with the commmand:

You can publish and run the migrations with:

Optionally, you can publish the config file with:

This is the contents of the published config file, find options such as setting a different table name, and updating the icon and class used for styling parts of the hint feature.

Optionally, you can publish the views using

Optionally, you can publish the translations using

Usage

To show hints in the application for users to access, you will need to have at least published your migration. You can change the table name using the config option:

Add a new Hint

To add a new hint:

• Click on the hint icon on the topbar.
• Click on New Hint.
• Fill in the form to create a new hint.

You can update the RichEditor component's toolbar used for the hint in your config option ('toolbar_buttons' => [...])

Edit a hint

To edit a hint:

• Click on the hint icon on the topbar.
• Click on Edit Hint.
• Make your updates and submit the form.

Edit a hint

To delete a hint:

• Click on the hint icon on the topbar.
• Click on Delete Hint.

Store and Seed database with page hints

As a convienient helper, you can run the command php artisan filament-page-hints:seeder and it will load all your current page hints into a seeder class, database\seeder\PageHintSeeder.

NOTE: If you have quotes, like single quote in your hint from the database, you might have to fix this more manually with escape (/). I was not able to find a way to fix that so for now as even addslashes was adding double // instead of one /, so ensure that after you generate your seeder class, you check the $allPageHints array (json) to make sure there are no issues with quotes.

Adding permissions to hint operations

Because there's not a global method for assigning permissions in filament admin panel as you might be using filament-shield or a different package to handle your user permissions, for now, this is a suggestive approach to handling this:

You can mostly do this in the blade:

An example to restrict the create action with create_hints permission will be:

If you want to also hide the edit/delete actions, you can do so in the views/vendor/filament-page-hints/components/modal/index.blade.php

Testing

Changelog

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

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

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

Credits

• Lance Armah-Abraham
• All Contributors

License

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