README

Bu paket, Laravel uygulamalarınız için tam özellikli bir destek bileti sistemi sunar. Kullanıcılarınızın destek taleplerini kolayca yönetmenize olanak tanır.

Özellikler

Kullanıcı Talepleri: Kullanıcılar destek talebi oluşturabilir, görüntüleyebilir ve yanıtlayabilir
Kategori Sistemi: Talepleri farklı kategorilere ayırma
Dosya Ekleri: Taleplere ve yanıtlara dosya ekleme desteği
Bildirimler: E-posta bildirimleri ve webhook entegrasyonları
Admin Paneli: Tüm destek taleplerini yönetme
Ayarlar Yönetimi: Sistem ayarlarını admin panelinden değiştirme
API Desteği: RESTful API entegrasyonu
Yetkilendirme: Laravel Gate ve Policy sistemi ile tam entegrasyon
Morph İlişkileri: Herhangi bir kullanıcı modeli ile kullanılabilir
Modern UI: Bootstrap 5 ile responsive tasarım
Filtreleme ve Arama: Gelişmiş arama ve filtreleme özellikleri

Ekran Görüntüleri

Kullanıcı Arayüzü

Talep Listesi
Talep Detayı
Talep Oluşturma

Admin Arayüzü

Admin Talep Listesi
Admin Talep Detayı

Kurulum

Composer aracılığıyla paketi yükleyin:

composer require wiensa/support-ticket

Paket yapılandırması, görünümleri ve migrationları yayınlamak için aşağıdaki komutu çalıştırın:

php artisan supportticket:install

Migrationları çalıştırın:

php artisan migrate

Temel verileri eklemek için seed komutunu çalıştırın:

php artisan db:seed --class=Database\\Seeders\\SupportTicketCategorySeeder
php artisan db:seed --class=Database\\Seeders\\SupportTicketSettingsSeeder

Kullanım

Kullanıcı Modülü Entegrasyonu

Kullanıcı modülünüze destek talepleri sistemini entegre etmek için, projenizin routes/web.php dosyasına aşağıdaki rotaları ekleyin:

// Destek talepleri için route'ları include et
Route::middleware(['web', 'auth'])->group(function () {
    Route::prefix('support')->name('support.')->group(function () {
        include base_path('vendor/wiensa/support-ticket/routes/web.php');
    });
});

Blade şablonlarınıza destek talepleri bağlantısını ekleyin:

<a href="{{ route('supportticket.tickets.index') }}">Destek Taleplerim</a>

Admin Modülü Entegrasyonu

Admin panel yapınıza destek talepleri yönetimini entegre etmek için, admin route yapılandırmanıza:

// Admin için destek talepleri route'larını include et
Route::middleware(['web', 'auth', 'admin'])->group(function () {
    Route::prefix('admin/support')->name('admin.support.')->group(function () {
        include base_path('vendor/wiensa/support-ticket/routes/admin.php');
    });
});

Ayrıca, config dosyasında admin middleware'i düzenleyebilirsiniz:

// config/supportticket.php
'admin_middleware' => ['web', 'auth', 'admin'], // Admin middleware

Blade Komponentleri

Paket, kullanmanız için bir dizi Blade komponenti içerir:

<!-- Talep listesi komponenti -->
<x-supportticket::ticket-list :tickets="$tickets" />

<!-- Talep detay komponenti -->
<x-supportticket::ticket-detail :ticket="$ticket" />

<!-- Yanıt form komponenti -->
<x-supportticket::reply-form :ticket="$ticket" />

<!-- Kategori seçici komponenti -->
<x-supportticket::category-selector :selected="$category" />

<!-- Dosya eki yükleyici komponenti -->
<x-supportticket::attachment-uploader :ticketable="$ticket" />

Partial Bileşenleri

Paket, projenize entegre edebileceğiniz partial bileşenler içerir:

<!-- Bildirimler -->
@include('partials.alerts')

<!-- Kategori Filtreleme -->
@include('partials.category-filter')

<!-- Dosya Eki Formu -->
@include('partials.attachment-form', ['ticketable' => $ticket])

Servis Sınıfları

Paketi programatik olarak kullanmak için aşağıdaki servis sınıflarını kullanabilirsiniz:

use Wiensa\SupportTicket\Services\TicketService;
use Wiensa\SupportTicket\Services\AttachmentService;
use Wiensa\SupportTicket\Services\NotificationService;

// Ticket Service
$ticketService = app(TicketService::class);
$ticket = $ticketService->createTicket([
    'subject' => 'Konu',
    'message' => 'Mesaj',
    'priority' => 'medium',
    'category' => $categoryId,
], $user);

// Attachment Service
$attachmentService = app(AttachmentService::class);
$attachment = $attachmentService->uploadFile($file, $ticket, $user);

// Notification Service
$notificationService = app(NotificationService::class);
$notificationService->sendNewTicketNotifications($ticket);

Olaylar ve Dinleyiciler

Paket, aşağıdaki olayları tetikler:

Wiensa\SupportTicket\Events\TicketCreated - Yeni talep oluşturulduğunda
Wiensa\SupportTicket\Events\TicketReplied - Talebe yanıt verildiğinde
Wiensa\SupportTicket\Events\TicketClosed - Talep kapatıldığında
Wiensa\SupportTicket\Events\TicketReopened - Talep yeniden açıldığında
Wiensa\SupportTicket\Events\TicketStatusChanged - Talep durumu değiştiğinde
Wiensa\SupportTicket\Events\AttachmentUploaded - Dosya yüklendiğinde

Uygulamanızda bu olayları dinlemek için event listener'lar oluşturabilirsiniz.

API Kullanımı

API endpointleri şunlardır:

GET /api/support/tickets - Tüm talepleri listeler
GET /api/support/tickets/{id} - Belirli bir talebi görüntüler
POST /api/support/tickets - Yeni talep oluşturur
POST /api/support/tickets/{id}/replies - Talebe yanıt ekler
PUT /api/support/tickets/{id} - Talebi günceller
DELETE /api/support/tickets/{id} - Talebi siler
POST /api/support/tickets/{id}/close - Talebi kapatır
POST /api/support/tickets/{id}/reopen - Talebi yeniden açar
POST /api/support/attachments - Dosya ekler
GET /api/support/categories - Kategorileri listeler

API kullanımı örneği:

// Yeni talep oluşturma
$response = $client->post('/api/support/tickets', [
    'json' => [
        'subject' => 'API Test',
        'message' => 'Bu bir API test talebidir',
        'category' => $categoryId,
        'priority' => 'high',
    ],
    'headers' => [
        'Authorization' => 'Bearer ' . $token,
    ],
]);

Yapılandırma

config/supportticket.php dosyasında aşağıdaki ayarları özelleştirebilirsiniz:

route_prefix - Rota öneki
middleware - Rotalarda kullanılacak middleware
admin_middleware - Admin rotalarında kullanılacak middleware
events - Olay yapılandırması
attachments - Dosya eki yapılandırması
- max_size - Maksimum dosya boyutu (MB)
- allowed_types - İzin verilen dosya tipleri
- storage_disk - Depolama diski
- storage_path - Depolama yolu
categories - Kategori yapılandırması
- allow_create - Kullanıcıların kategori oluşturmasına izin ver
- default - Varsayılan kategori ID'si
auto_close - Otomatik kapanma ayarları
- enabled - Aktif/Pasif
- days - Otomatik kapanma günü
admin_emails - Bildirim alacak admin e-postaları

Özelleştirme

Views

Viewları özelleştirmek için:

php artisan vendor:publish --tag=supportticket-views

Config

Yapılandırma dosyasını özelleştirmek için:

php artisan vendor:publish --tag=supportticket-config

Translations

Dil dosyalarını özelleştirmek için:

php artisan vendor:publish --tag=supportticket-lang

Assets

CSS ve JS dosyalarını özelleştirmek için:

php artisan vendor:publish --tag=supportticket-assets

Değişiklik Geçmişi

Değişiklik geçmişi için CHANGELOG.md dosyasına bakın.

Lisans

Bu paket MIT lisansı altında lisanslanmıştır.

wiensa / support-ticket

Maintainers

Details