https://github.com/zofe/ticket-module
ticket module for rapyd-livewire laravel application
https://github.com/zofe/ticket-module
Last synced: about 1 year ago
JSON representation
ticket module for rapyd-livewire laravel application
- Host: GitHub
- URL: https://github.com/zofe/ticket-module
- Owner: zofe
- Created: 2023-03-22T13:48:38.000Z (about 3 years ago)
- Default Branch: main
- Last Pushed: 2023-06-05T08:52:05.000Z (almost 3 years ago)
- Last Synced: 2025-01-15T22:28:59.779Z (over 1 year ago)
- Language: PHP
- Size: 89.8 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Ticket Module
This is a Ticket module for a Laravel application (>= 8)
it use layout module and auth module.
# Installation & configuration
Your can require this module in your laravel application using:
```
composer require zofe/ticket-module
php artisan migrate
```
create a configuration file "ticket.php" in your config folder and customize :
```
'operators_roles'=>['admin'],
'notification_email' => 'notification@email.it',
```
then add roles/permissions in the auth.php configuration file :
By default, tickets can be created by "user" (role) users and managed by "admin" (role) users.
A minimal configuration for your config/auth.php file is:
```
'role_permissions' => [
'admin' => [
'view tickets', 'edit tickets',
],
'user' => [
'view own tickets', 'edit own tickets',
],
]
```
then you can seed some default data using:
```
php artisan db:seed --class="App\\Modules\\Ticket\\Database\\Seeders\\TicketCategories"
```
# Layout
Note that this module will install/use layout-module, you may need to do:
```
cd app/Modules/Layout/
npm i
npm run dev
```
this will compile scss and copy css assets to your public project folder
# Charts
this module use livewire charts, so you need to publish some assets:
```bash
php artisan vendor:publish --tag=livewire-charts:public
```
if you customize your layout make sure you include this directive
```
@livewireChartsScripts
```
# Customizing Module
To customize the module code, we recommend forking the original package repository on GitHub and making changes there. This way, you can maintain a separate branch for your changes, while also keeping up-to-date with the latest releases of the package.
To install your forked version of the package in your Laravel application, you can reference your forked repository in the composer.json file of your Laravel application using the "vcs" package type. Here's an example of what you can add to your composer.json:
```json
"repositories": [
{
"type": "vcs",
"url": "https://github.com//"
}
],
```
Replace `` with your GitHub username and `` with the name of your forked package repository.
After adding your forked repository to composer.json, you can require your customized package in the same way you would require the original package:
```php
composer require /:dev-
```
Replace ``, ``, and `` with the appropriate values for your forked repository and branch.
By using this approach, you can easily customize the module code while also keeping your code up-to-date with the latest releases of the package.
We encourage developers to make changes that could be useful to the wider community and contribute back to the original package repository via pull requests. This can help improve the package for everyone and ensure that your changes are integrated with the latest releases of the package.