initial commit

Author: samberrry

.gitignore

@@ -0,0 +1,3 @@
+/vendor
+/.idea
+/.vscode

LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2023 BINSHOPS
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -0,0 +1,70 @@
+# Laravel Ticket System
+A simple helpdesk ticketing system for Laravel 5.1+ (5.1 – 5.8 and 6.* - 7.* - 8.* - 9.* - 10.*) which integrates smoothly with Laravel default users and auth system. 
+It will integrate into your current Laravel project within minutes, and you can offer your customers and your team a nice and simple support ticket system. 
+
+## Features:
+1. Three main users roles users, agents, and admins
+2. Users can create tickets, keep track of their tickets status, giving comments, and close their own tickets (access permissions are configurable)
+3. Auto assigning agents to tickets, the system searches for agents in specific department and auto select the agent with lowest queue
+4. Simple admin panel 
+5. Localization (Arabic, Brazilian Portuguese, Deutsch (German), English, Farsi, French, Hungarian, Italian, Persian, Russian, and Spanish language packs are included)
+6. Very simple installation and integration process
+7. Admin dashboard with statistics and performance tracking graphs
+8. Simple text editor for tickets descriptions and comments allows images upload
+
+## Quick Installation:
+
+### Requirements
+**First Make sure you have got this Laravel setup working:**
+
+1. [Laravel](http://laravel.com/docs#installation)
+2. [Users table](http://laravel.com/docs/authentication)
+3. [Laravel email configuration](http://laravel.com/docs/mail#sending-mail)
+4. Bootstrap 3, or Bootstrap 4
+5. Jquery
+
+**Dependents that are getting installed and configured automatically by LaravelTicket (no action required from you)**
+
+1. [LaravelCollective HTML](https://github.com/laravelcollective/html)
+2. [Laravel Datatables](https://github.com/yajra/laravel-datatables)
+3. [HTML Purifier](https://github.com/mewebstudio/Purifier)
+
+
+### Installation steps (4-8 minutes)
+
+
+Step 1. Run this code via your terminal (1-2 minutes)
+```shell
+composer require 'binshops/laravel-ticket:0.*'
+```
+
+Step 2. After install, you have to add this line on your `config/app.php` in Service Providers section (1-2 minutes).
+```php
+Binshops\LaravelTicket\LaravelTicketServiceProvider::class;
+```
+
+Step 3. Check if App\User exists
+
+Step 4. Make sure you have [authentication](https://laravel.com/docs/10.x/authentication) set up. In 5.2+, you can use `php artisan make:auth`
+
+Step 5. [Setting up your master view for LaravelTicket integration (1-2 minutes)](https://github.com/binshops/laravel-ticket/wiki/Integrating-LaravelTicket-views-with-your-project-template)
+
+Step 6. Register at least one user into the system and log it in.
+
+Step 7. Go ahead to http://your-project-url/tickets-install to finalize the installation (1-2 minutes)
+
+Default laravel-ticket front route: http://your-project-url/tickets
+
+Default laravel-ticket admin route: http://your-project-url/tickets-admin
+
+**Notes:**
+
+Make sure you have created at least one status, one priority, and one category before you start creating tickets.
+
+If you move your installation folder to another path (or server), you need to update the row with slug='routes' in table `laravelticketsettings`. After that, don't forget to flush the entire cache.
+
+## Documentation
+[LaravelTicket Wiki](https://github.com/binshops/laravel-ticket/wiki)
+
+## Migration
+- `laravelcollective/html` This package is abandoned and no longer maintained. The author suggests using the spatie/laravel-html package instead.

composer.json

@@ -0,0 +1,28 @@
+{
+    "name": "binshops/laravel-ticket",
+    "description": "A simple ticketing system for Laravel 5.1 – 5.8 and 6.* - 7.* - 8.* - 9.* - 19.* -which integrates smoothly with Laravel default users and auth system",
+    "type": "laravel-package",
+    "keywords": ["laravel","helpdesk", "ticket", "support", "crm", "customer support"],
+    "require": {
+        "laravel/framework": "^5.1|^6.0|^7.0|^8.0|^9.0|^10.0",
+        "laravelcollective/html": "^5.1|^6.0",
+        "illuminate/support": "^5.1|^6.0|^7.0|^8.0|^9.0|^10.0",
+        "yajra/laravel-datatables-oracle": "^6.0|^8.0|^9.4|^9.11|^10.4",
+        "jenssegers/date": "^3.0|^4.0",
+        "mews/purifier": "^2.0|^3.1|^3.4",
+        "doctrine/dbal": "^2.5|^2.6|^2.10|^3.6"
+    },
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Sam Berry",
+            "homepage": "https://github.com/binshops/laravel-ticket",
+            "email": "[email protected]"
+        }
+    ],
+    "autoload": {
+        "psr-4": {
+            "Binshops\\LaravelTicket\\": "src"
+        }
+    }
+}

src/Console/Htmlify.php

@@ -0,0 +1,57 @@
+<?php
+
+namespace Binshops\LaravelTicket\Console;
+
+use Illuminate\Console\Command;
+use Binshops\LaravelTicket\Models\Comment;
+use Binshops\LaravelTicket\Models\Ticket;
+
+class Htmlify extends Command
+{
+    /**
+     * The name and signature of the console command.
+     *
+     * @var string
+     */
+    protected $signature = 'laravelticket:htmlify';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Copies column `content` to column `html` in comments and tickets tables while escaping and replacing new lines with <br> tags. Run this when upgrading from <=v0.2.2';
+
+    public function __construct()
+    {
+        parent::__construct();
+    }
+
+    /**
+     * Execute the console command.
+     *
+     * @return mixed
+     */
+    public function handle()
+    {
+        $tickets = Ticket::all();
+
+        foreach ($tickets as $ticket) {
+            if (!$ticket->html) {
+                $ticket->html = nl2br(e($ticket->content));
+                $ticket->content = e($ticket->content);
+                $ticket->save();
+            }
+        }
+
+        $comments = Comment::all();
+
+        foreach ($comments as $comment) {
+            if (!$comment->html) {
+                $comment->html = nl2br(e($comment->content));
+                $comment->content = e($comment->content);
+                $comment->save();
+            }
+        }
+    }
+}

src/Controllers/AdministratorsController.php

@@ -0,0 +1,111 @@
+<?php
+
+namespace Binshops\LaravelTicket\Controllers;
+
+use App\Http\Controllers\Controller;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Session;
+use Binshops\LaravelTicket\Models\Agent;
+use Binshops\LaravelTicket\Models\Setting;
+
+class AdministratorsController extends Controller
+{
+    public function index()
+    {
+        $administrators = Agent::admins();
+
+        return view('laravelticket::admin.administrator.index', compact('administrators'));
+    }
+
+    public function create()
+    {
+        $users = Agent::paginate(Setting::grab('paginate_items'));
+
+        return view('laravelticket::admin.administrator.create', compact('users'));
+    }
+
+    public function store(Request $request)
+    {
+        $administrators_list = $this->addAdministrators($request->input('administrators'));
+        $administrators_names = implode(',', $administrators_list);
+
+        Session::flash('status', trans('laravelticket::lang.administrators-are-added-to-administrators', ['names' => $administrators_names]));
+
+        return redirect()->action('\Binshops\LaravelTicket\Controllers\AdministratorsController@index');
+    }
+
+    public function update($id, Request $request)
+    {
+        $this->syncAdministratorCategories($id, $request);
+
+        Session::flash('status', trans('laravelticket::lang.administrators-joined-categories-ok'));
+
+        return redirect()->action('\Binshops\LaravelTicket\Controllers\AdministratorsController@index');
+    }
+
+    public function destroy($id)
+    {
+        $administrator = $this->removeAdministrator($id);
+
+        Session::flash('status', trans('laravelticket::lang.administrators-is-removed-from-team', ['name' => $administrator->name]));
+
+        return redirect()->action('\Binshops\LaravelTicket\Controllers\AdministratorsController@index');
+    }
+
+    /**
+     * Assign users as administrators.
+     *
+     * @param $user_ids
+     *
+     * @return array
+     */
+    public function addAdministrators($user_ids)
+    {
+        $users = Agent::find($user_ids);
+        foreach ($users as $user) {
+            $user->laravelticket_admin = true;
+            $user->save();
+            $users_list[] = $user->name;
+        }
+
+        return $users_list;
+    }
+
+    /**
+     * Remove user from the administrators.
+     *
+     * @param $id
+     *
+     * @return mixed
+     */
+    public function removeAdministrator($id)
+    {
+        $administrator = Agent::find($id);
+        $administrator->laravelticket_admin = false;
+        $administrator->save();
+
+        // Remove him from tickets categories as well
+        if (version_compare(app()->version(), '5.2.0', '>=')) {
+            $administrator_cats = $administrator->categories->pluck('id')->toArray();
+        } else { // if Laravel 5.1
+            $administrator_cats = $administrator->categories->lists('id')->toArray();
+        }
+
+        $administrator->categories()->detach($administrator_cats);
+
+        return $administrator;
+    }
+
+    /**
+     * Sync Administrator categories with the selected categories got from update form.
+     *
+     * @param $id
+     * @param Request $request
+     */
+    public function syncAdministratorCategories($id, Request $request)
+    {
+        $form_cats = ($request->input('administrator_cats') == null) ? [] : $request->input('administrator_cats');
+        $administrator = Agent::find($id);
+        $administrator->categories()->sync($form_cats);
+    }
+}