Download the PHP package salmanalmajali/jokes-widget without Composer
On this page you can find all versions of the php package salmanalmajali/jokes-widget. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download salmanalmajali/jokes-widget
More information about salmanalmajali/jokes-widget
Files in salmanalmajali/jokes-widget
Package jokes-widget
Short Description A fun Filament PHP plugin to display Dad Jokes (Bahasa Indonesia & English) via API. Make your filament dashboard tell a joke
License MIT
Homepage https://github.com/salmanalmajali/jokes-widget
Informations about the package jokes-widget
Filament Jokes Widget 🎤
Add a touch of fun and lightweight Filament PHP widget that brings "Dad Jokes" humor directly to your dashboard and make your Filament Dashboard tell a joke. This plugin is designed to add a bit of humor to the administrative experience by displaying jokes tailored to your application's language settings.
Key Features
- Automatic Localization:
- Bahasa Indonesia: Displays a collection of iconic local "bapak-bapak" jokes. Collected from Candaan API Repository by Ardhi Putra
- English: Dynamically fetches fresh dad jokes from the
icanhazdadjoke.comAPI.
- Interactive Refresh: Includes a button to instantly swap jokes without reloading the page using Livewire.
- Filament V4 and V5 Ready: Optimized to run seamlessly on the latest version of Filament.
Installation
You can install the package via Composer:
(Optional) Publish the translation files if you wish to customize the widget text:
Usage
Register the plugin in your Filament Panel Provider (typically AdminPanelProvider.php):
Localization and Screenshoot
The widget automatically detects your application's locale:
- If the locale is set to id, the widget uses the local joke collection.
- or any other locale (default en), the widget fetches data from the external API.
Testing
Run the package tests using Pest:
Changelog
Please see CHANGELOG for more information on what has changed recently.
Contributing
Please see CONTRIBUTING for details.
Security
If you discover any security-related issues, please email [email protected] instead of using the issue tracker.
Credits
- Salman Al Majali
- Ardhi Putra
- All Contributors
All versions of jokes-widget with dependencies
filament/filament Version ^3.0|^4.0|^5.0
guzzlehttp/guzzle Version ^7.10
spatie/laravel-package-tools Version ^1.15.0