Download the PHP package zynqa/filament-jira-feedback without Composer
On this page you can find all versions of the php package zynqa/filament-jira-feedback. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download zynqa/filament-jira-feedback
More information about zynqa/filament-jira-feedback
Files in zynqa/filament-jira-feedback
Package filament-jira-feedback
Short Description A FilamentPHP package to collect user feedback and automatically create Jira issues
License MIT
Informations about the package filament-jira-feedback
Filament Jira Feedback
A FilamentPHP package to collect user feedback and automatically create Jira issues. Perfect for beta testing, feature requests, bug reports, and general user feedback.
Features
- Zero Configuration: Automatically displays feedback banner at the top of all Filament pages
- Filament Native: Built with Filament components, forms, modals, and notifications
- Dark Mode Support: Automatically adapts to your Filament theme
- Dynamic Issue Types: Fetches issue types from your Jira project with filtering and custom descriptions
- Flexible Positioning: Position banner anywhere using Filament render hooks
- User Context: Includes authenticated user information with feedback
- Fully Customizable: Colors, icons, messages, and positioning
Requirements
- PHP 8.2+
- Laravel (compatible with Laravel 11+)
- FilamentPHP (see
composer.jsonfor version compatibility) - Jira Cloud account with API access
Installation
Publish Configuration
Configure Environment Variables
Add to your .env file:
Get Your Jira API Token
- Log in to your Atlassian account
- Go to https://id.atlassian.com/manage-profile/security/api-tokens
- Click "Create API token"
- Copy the token and add it to your
.envfile
That's it! The feedback banner will automatically appear at the top of your Filament pages.
Usage
Basic Usage
Users can click the "Submit Feedback" button to open a modal with a form. The form includes:
- Issue type dropdown (dynamically fetched from Jira)
- Title field
- Description field
Upon submission, a Jira issue is automatically created with user context.
Using the Action Component
Use the feedback action in any Filament resource, page, or widget:
Customization
Banner Position
By default, the banner appears at the top of the page. To customize:
-
Disable auto-registration in
.env: - Register at custom position in your Panel Provider:
Available hooks: BODY_START, BODY_END, CONTENT_START, CONTENT_END, TOPBAR_START, TOPBAR_END, SIDEBAR_NAV_START, SIDEBAR_NAV_END, FOOTER
Colors
Use preset colors:
Or define custom Tailwind classes for light and dark modes:
Icons
Use any Heroicon:
Issue Types
Issue types are automatically fetched from Jira and cached for 1 hour.
Filter with whitelist:
Filter with blacklist:
Add descriptions:
Descriptions display as: "Bug - Report a software defect or error"
Conditional Display
Show banner only to specific users:
User Context
Include user's project key in issue summary:
This prefixes summaries with [PROJECT_KEY].
Troubleshooting
Banner doesn't appear:
- Check
FILAMENT_JIRA_FEEDBACK_ENABLED=truein.env - Clear cache:
php artisan config:clear && php artisan filament:cache-components
Feedback submission fails:
- Verify Jira credentials are correct
- Check that the project key exists
- Ensure your Jira user has create issue permissions
- Check
storage/logs/laravel.logfor detailed errors
Issue types not working:
- Issue types are cached for 1 hour - clear cache:
php artisan cache:clear - Verify issue types exist in your Jira project
- Issue type names are case-sensitive
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This package is open-sourced software licensed under the MIT license.