PHPackages                             filaforge/filament-hello-widget - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Admin Panels](/categories/admin)
4. /
5. filaforge/filament-hello-widget

ActiveLibrary[Admin Panels](/categories/admin)

filaforge/filament-hello-widget
===============================

Example Filament panel plugin: Hello Widget

v1.0.0(9mo ago)00MITCSSPHP ^8.1

Since Aug 19Pushed 9mo agoCompare

[ Source](https://github.com/filaforge/filament-hello-widget)[ Packagist](https://packagist.org/packages/filaforge/filament-hello-widget)[ Docs](https://github.com/filaforge/hello-widget)[ RSS](/packages/filaforge-filament-hello-widget/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (3)Versions (5)Used By (0)

Filaforge Hello Widget
======================

[](#filaforge-hello-widget)

A simple and elegant Filament plugin that adds a customizable hello widget to your admin panel dashboard.

Features
--------

[](#features)

- **Dashboard Widget**: Beautiful hello widget for your Filament dashboard
- **Customizable Greeting**: Personalize the welcome message
- **User Information**: Display current user details and status
- **Responsive Design**: Works seamlessly on all device sizes
- **Dark Mode Support**: Full compatibility with Filament's dark mode
- **Easy Customization**: Simple configuration options
- **Performance Optimized**: Lightweight and fast loading
- **Accessibility**: Built with accessibility best practices

Installation
------------

[](#installation)

### 1. Install via Composer

[](#1-install-via-composer)

```
composer require filaforge/hello-widget
```

### 2. Publish & Migrate

[](#2-publish--migrate)

```
# Publish provider groups (config, views, migrations)
php artisan vendor:publish --provider="Filaforge\\HelloWidget\\Providers\\HelloWidgetServiceProvider"

# Run migrations
php artisan migrate
```

### 3. Register Plugin

[](#3-register-plugin)

Add the plugin to your Filament panel provider:

```
use Filament\Panel;

public function panel(Panel $panel): Panel
{
    return $panel
        // ... other configuration
        ->plugin(\Filaforge\HelloWidget\HelloWidgetPlugin::make());
}
```

Setup
-----

[](#setup)

### Configuration

[](#configuration)

The plugin will automatically:

- Publish configuration files to `config/hello-widget.php`
- Publish view files to `resources/views/vendor/hello-widget/`
- Publish migration files to `database/migrations/`
- Register necessary routes and middleware

### Widget Configuration

[](#widget-configuration)

Configure the hello widget in the published config file:

```
// config/hello-widget.php
return [
    'greeting' => 'Hello',
    'show_user_info' => true,
    'show_timestamp' => true,
    'custom_message' => 'Welcome to your dashboard!',
    'widget_position' => 'top',
    'refresh_interval' => 0, // 0 = no auto-refresh
    'allowed_roles' => [], // Empty = all authenticated users
];
```

### Environment Variables

[](#environment-variables)

Add these to your `.env` file if needed:

```
HELLO_WIDGET_GREETING=Hello
HELLO_WIDGET_CUSTOM_MESSAGE=Welcome to your dashboard!
HELLO_WIDGET_SHOW_USER_INFO=true
```

Usage
-----

[](#usage)

### Accessing the Hello Widget

[](#accessing-the-hello-widget)

1. Navigate to your Filament admin panel
2. The hello widget will appear on your dashboard
3. Customize the widget through the configuration

### Widget Features

[](#widget-features)

1. **Greeting Display**: Shows a personalized greeting message
2. **User Information**: Displays current user name and details
3. **Timestamp**: Shows current date and time
4. **Custom Messages**: Display custom welcome messages
5. **Responsive Layout**: Adapts to different screen sizes

### Customization Options

[](#customization-options)

- **Greeting Text**: Change the default greeting message
- **User Info Display**: Toggle user information visibility
- **Timestamp Format**: Customize date and time display
- **Widget Position**: Control where the widget appears
- **Auto-refresh**: Set automatic refresh intervals
- **Role Restrictions**: Limit widget access to specific user roles

Troubleshooting
---------------

[](#troubleshooting)

### Common Issues

[](#common-issues)

- **Widget not showing**: Ensure the plugin is properly registered
- **Configuration not loading**: Check if config file is published
- **User info missing**: Verify user authentication is working
- **Styling issues**: Clear view caches and check CSS conflicts

### Debug Steps

[](#debug-steps)

1. Check the plugin configuration:

```
php artisan config:show hello-widget
```

2. Verify routes are registered:

```
php artisan route:list | grep hello-widget
```

3. Check if widget is registered:

```
php artisan tinker
# Check widget registration
```

4. Clear caches:

```
php artisan optimize:clear
php artisan view:clear
```

5. Check logs for errors:

```
tail -f storage/logs/laravel.log
```

### Widget Customization

[](#widget-customization)

If you need to customize the widget appearance:

1. Publish the widget views:

```
php artisan vendor:publish --tag=hello-widget-views
```

2. Edit the published views in `resources/views/vendor/hello-widget/`
3. Customize the CSS in `resources/css/hello-widget.css`

Security Considerations
-----------------------

[](#security-considerations)

### Access Control

[](#access-control)

- **Role-based permissions**: Restrict widget access to authorized users
- **User data privacy**: Ensure sensitive user information is not exposed
- **Widget visibility**: Control who can see the widget content

### Best Practices

[](#best-practices)

- Use appropriate user role restrictions
- Avoid displaying sensitive information in the widget
- Implement proper user authentication
- Regularly review access permissions

Uninstall
---------

[](#uninstall)

### 1. Remove Plugin Registration

[](#1-remove-plugin-registration)

Remove the plugin from your panel provider:

```
// remove ->plugin(\Filaforge\HelloWidget\HelloWidgetPlugin::make())
```

### 2. Roll Back Migrations (Optional)

[](#2-roll-back-migrations-optional)

```
php artisan migrate:rollback
# or roll back specific published files if needed
```

### 3. Remove Published Assets (Optional)

[](#3-remove-published-assets-optional)

```
rm -f config/hello-widget.php
rm -rf resources/views/vendor/hello-widget
```

### 4. Remove Package and Clear Caches

[](#4-remove-package-and-clear-caches)

```
composer remove filaforge/hello-widget
php artisan optimize:clear
```

### 5. Clean Up Environment Variables

[](#5-clean-up-environment-variables)

Remove these from your `.env` file:

```
HELLO_WIDGET_GREETING=Hello
HELLO_WIDGET_CUSTOM_MESSAGE=Welcome to your dashboard!
HELLO_WIDGET_SHOW_USER_INFO=true
```

Support
-------

[](#support)

- **Documentation**: [GitHub Repository](https://github.com/filaforge/hello-widget)
- **Issues**: [GitHub Issues](https://github.com/filaforge/hello-widget/issues)
- **Discussions**: [GitHub Discussions](https://github.com/filaforge/hello-widget/discussions)

Contributing
------------

[](#contributing)

We welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.

License
-------

[](#license)

This plugin is open-sourced software licensed under the [MIT license](LICENSE).

---

**Made with ❤️ by the Filaforge Team**

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance58

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~0 days

Total

3

Last Release

271d ago

Major Versions

0.1.2 → v1.0.02025-08-19

### Community

Maintainers

![](https://www.gravatar.com/avatar/e7ccd0e302c517e0c6bc2b4ef05008e5beb1621bf5a64b17b82cdceb19566389?d=identicon)[filaforge](/maintainers/filaforge)

---

Top Contributors

[![blhk0532](https://avatars.githubusercontent.com/u/221689993?v=4)](https://github.com/blhk0532 "blhk0532 (5 commits)")

---

Tags

laravelplatformfilament

### Embed Badge

![Health badge](/badges/filaforge-filament-hello-widget/health.svg)

```
[![Health](https://phpackages.com/badges/filaforge-filament-hello-widget/health.svg)](https://phpackages.com/packages/filaforge-filament-hello-widget)
```

###  Alternatives

[bezhansalleh/filament-shield

Filament support for `spatie/laravel-permission`.

2.8k2.9M88](/packages/bezhansalleh-filament-shield)[awcodes/filament-quick-create

Plugin for Filament Admin that adds a dropdown menu to the header to quickly create new items.

246177.6k7](/packages/awcodes-filament-quick-create)[guava/filament-knowledge-base

A filament plugin that adds a knowledge base and help to your filament panel(s).

206120.5k1](/packages/guava-filament-knowledge-base)[a2insights/filament-saas

Filament Saas for A2Insights

161.1k](/packages/a2insights-filament-saas)[inerba/filament-db-config

A Filament plugin for database-backed application settings and editable content, with caching and easy page generation.

329.1k](/packages/inerba-filament-db-config)[caresome/filament-neobrutalism-theme

A neobrutalism theme for FilamentPHP admin panels

303.2k](/packages/caresome-filament-neobrutalism-theme)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)