{"id":31785472,"url":"https://github.com/filaforge/filament-hello-widget","last_synced_at":"2025-10-10T11:55:25.043Z","repository":{"id":310710872,"uuid":"1040960040","full_name":"filaforge/filament-hello-widget","owner":"filaforge","description":"Filament plugin for hello widget functionality","archived":false,"fork":false,"pushed_at":"2025-08-19T20:32:25.000Z","size":89,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-08-19T20:35:03.633Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/filaforge.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.md","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-08-19T19:07:55.000Z","updated_at":"2025-08-19T20:32:22.000Z","dependencies_parsed_at":"2025-08-19T20:35:06.078Z","dependency_job_id":"0e925a02-d52a-4c45-83ce-b432083d4ce4","html_url":"https://github.com/filaforge/filament-hello-widget","commit_stats":null,"previous_names":["filaforge/filament-hello-widget"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/filaforge/filament-hello-widget","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filaforge%2Ffilament-hello-widget","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filaforge%2Ffilament-hello-widget/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filaforge%2Ffilament-hello-widget/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filaforge%2Ffilament-hello-widget/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/filaforge","download_url":"https://codeload.github.com/filaforge/filament-hello-widget/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/filaforge%2Ffilament-hello-widget/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279003716,"owners_count":26083610,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-10T02:00:06.843Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-10-10T11:55:17.293Z","updated_at":"2025-10-10T11:55:25.031Z","avatar_url":"https://github.com/filaforge.png","language":"CSS","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Filaforge Hello Widget\n\nA simple and elegant Filament plugin that adds a customizable hello widget to your admin panel dashboard.\n\n## Features\n\n- **Dashboard Widget**: Beautiful hello widget for your Filament dashboard\n- **Customizable Greeting**: Personalize the welcome message\n- **User Information**: Display current user details and status\n- **Responsive Design**: Works seamlessly on all device sizes\n- **Dark Mode Support**: Full compatibility with Filament's dark mode\n- **Easy Customization**: Simple configuration options\n- **Performance Optimized**: Lightweight and fast loading\n- **Accessibility**: Built with accessibility best practices\n\n## Installation\n\n### 1. Install via Composer\n\n```bash\ncomposer require filaforge/hello-widget\n```\n\n### 2. Publish \u0026 Migrate\n\n```bash\n# Publish provider groups (config, views, migrations)\nphp artisan vendor:publish --provider=\"Filaforge\\\\HelloWidget\\\\Providers\\\\HelloWidgetServiceProvider\"\n\n# Run migrations\nphp artisan migrate\n```\n\n### 3. Register Plugin\n\nAdd the plugin to your Filament panel provider:\n\n```php\nuse Filament\\Panel;\n\npublic function panel(Panel $panel): Panel\n{\n    return $panel\n        // ... other configuration\n        -\u003eplugin(\\Filaforge\\HelloWidget\\HelloWidgetPlugin::make());\n}\n```\n\n## Setup\n\n### Configuration\n\nThe plugin will automatically:\n- Publish configuration files to `config/hello-widget.php`\n- Publish view files to `resources/views/vendor/hello-widget/`\n- Publish migration files to `database/migrations/`\n- Register necessary routes and middleware\n\n### Widget Configuration\n\nConfigure the hello widget in the published config file:\n\n```php\n// config/hello-widget.php\nreturn [\n    'greeting' =\u003e 'Hello',\n    'show_user_info' =\u003e true,\n    'show_timestamp' =\u003e true,\n    'custom_message' =\u003e 'Welcome to your dashboard!',\n    'widget_position' =\u003e 'top',\n    'refresh_interval' =\u003e 0, // 0 = no auto-refresh\n    'allowed_roles' =\u003e [], // Empty = all authenticated users\n];\n```\n\n### Environment Variables\n\nAdd these to your `.env` file if needed:\n\n```env\nHELLO_WIDGET_GREETING=Hello\nHELLO_WIDGET_CUSTOM_MESSAGE=Welcome to your dashboard!\nHELLO_WIDGET_SHOW_USER_INFO=true\n```\n\n## Usage\n\n### Accessing the Hello Widget\n\n1. Navigate to your Filament admin panel\n2. The hello widget will appear on your dashboard\n3. Customize the widget through the configuration\n\n### Widget Features\n\n1. **Greeting Display**: Shows a personalized greeting message\n2. **User Information**: Displays current user name and details\n3. **Timestamp**: Shows current date and time\n4. **Custom Messages**: Display custom welcome messages\n5. **Responsive Layout**: Adapts to different screen sizes\n\n### Customization Options\n\n- **Greeting Text**: Change the default greeting message\n- **User Info Display**: Toggle user information visibility\n- **Timestamp Format**: Customize date and time display\n- **Widget Position**: Control where the widget appears\n- **Auto-refresh**: Set automatic refresh intervals\n- **Role Restrictions**: Limit widget access to specific user roles\n\n## Troubleshooting\n\n### Common Issues\n\n- **Widget not showing**: Ensure the plugin is properly registered\n- **Configuration not loading**: Check if config file is published\n- **User info missing**: Verify user authentication is working\n- **Styling issues**: Clear view caches and check CSS conflicts\n\n### Debug Steps\n\n1. Check the plugin configuration:\n```bash\nphp artisan config:show hello-widget\n```\n\n2. Verify routes are registered:\n```bash\nphp artisan route:list | grep hello-widget\n```\n\n3. Check if widget is registered:\n```bash\nphp artisan tinker\n# Check widget registration\n```\n\n4. Clear caches:\n```bash\nphp artisan optimize:clear\nphp artisan view:clear\n```\n\n5. Check logs for errors:\n```bash\ntail -f storage/logs/laravel.log\n```\n\n### Widget Customization\n\nIf you need to customize the widget appearance:\n\n1. Publish the widget views:\n```bash\nphp artisan vendor:publish --tag=hello-widget-views\n```\n\n2. Edit the published views in `resources/views/vendor/hello-widget/`\n\n3. Customize the CSS in `resources/css/hello-widget.css`\n\n## Security Considerations\n\n### Access Control\n\n- **Role-based permissions**: Restrict widget access to authorized users\n- **User data privacy**: Ensure sensitive user information is not exposed\n- **Widget visibility**: Control who can see the widget content\n\n### Best Practices\n\n- Use appropriate user role restrictions\n- Avoid displaying sensitive information in the widget\n- Implement proper user authentication\n- Regularly review access permissions\n\n## Uninstall\n\n### 1. Remove Plugin Registration\n\nRemove the plugin from your panel provider:\n```php\n// remove -\u003eplugin(\\Filaforge\\HelloWidget\\HelloWidgetPlugin::make())\n```\n\n### 2. Roll Back Migrations (Optional)\n\n```bash\nphp artisan migrate:rollback\n# or roll back specific published files if needed\n```\n\n### 3. Remove Published Assets (Optional)\n\n```bash\nrm -f config/hello-widget.php\nrm -rf resources/views/vendor/hello-widget\n```\n\n### 4. Remove Package and Clear Caches\n\n```bash\ncomposer remove filaforge/hello-widget\nphp artisan optimize:clear\n```\n\n### 5. Clean Up Environment Variables\n\nRemove these from your `.env` file:\n```env\nHELLO_WIDGET_GREETING=Hello\nHELLO_WIDGET_CUSTOM_MESSAGE=Welcome to your dashboard!\nHELLO_WIDGET_SHOW_USER_INFO=true\n```\n\n## Support\n\n- **Documentation**: [GitHub Repository](https://github.com/filaforge/hello-widget)\n- **Issues**: [GitHub Issues](https://github.com/filaforge/hello-widget/issues)\n- **Discussions**: [GitHub Discussions](https://github.com/filaforge/hello-widget/discussions)\n\n## Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n## License\n\nThis plugin is open-sourced software licensed under the [MIT license](LICENSE).\n\n---\n\n**Made with ❤️ by the Filaforge Team**\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffilaforge%2Ffilament-hello-widget","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffilaforge%2Ffilament-hello-widget","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffilaforge%2Ffilament-hello-widget/lists"}