docs: update installation and configuration instructions in README

This commit is contained in:
Ümit Tunç
2026-04-29 06:03:17 +03:00
parent 8675024502
commit 963e0accc9
+28 -35
View File
@@ -380,7 +380,29 @@ $relationDatas = [
## Yeni Modül Geliştirme ## Yeni Modül Geliştirme
Yeni bir modül geliştirmek için aşağıdaki adımları takip etmeniz gerekir: Citrus CMS'de yeni bir modül oluşturmak için iki yöntem bulunmaktadır: **Module Generator Wizard** (Önerilen) ve **Manuel Yöntem**.
### 1. Module Generator Wizard (Önerilen)
Sistemde bulunan "Module Generator" sihirbazı, bir modül için gerekli olan tüm dosyaları ve veritabanı işlemlerini otomatik olarak gerçekleştirir.
**Adımlar:**
1. Sol menüden **İçerik Yönetimi (Content Management) > Module Generator** sayfasına gidin.
2. **Temel Bilgiler:** Modül başlığını girin ve bir ikon (PNG) yükleyin.
3. **Veritabanı Sütunları:** Modülde yer alacak alanları tanımlayın:
- Sütun adı, veri tipi (String, Integer, Long Text, Date, Boolean vb.) seçin.
- Açılır menüler (Select) veya API bağlantılı listeler (API Dropdown) için gelişmiş ayarları yapın.
4. **Onay ve Oluştur:** "Generate Module Now" butonuna tıkladığınızda sistem şunları otomatik yapar:
- Veritabanı Migration dosyasını oluşturur ve çalıştırır.
- Eloquent Model dosyasını (`app/Models/`) oluşturur.
- Gelişmiş Datagrid içeren Blade View dosyasını (`resources/views/admin/type/`) oluşturur.
- `types` tablosuna gerekli kaydı ekler.
Bu işlemden sonra modülünüz hemen kullanıma hazır hale gelir.
### 2. Manuel Yöntem
Daha özel ihtiyaçlar için modülü manuel olarak da oluşturabilirsiniz:
1. **Model ve Migration Oluşturun**: 1. **Model ve Migration Oluşturun**:
```php ```php
@@ -411,43 +433,14 @@ Yeni bir modül geliştirmek için aşağıdaki adımları takip etmeniz gerekir
``` ```
2. **Şablonu Kopyalayın ve Özelleştirin**: 2. **Şablonu Kopyalayın ve Özelleştirin**:
- `resources/views/admin/type/` dizini altında yeni bir blade dosyası oluşturun - `resources/views/admin/type/` dizini altında yeni bir blade dosyası oluşturun (Örn: `yeni-modul.blade.php`).
- `sablon4.blade.php` temel alınarak özelleştirme yapabilirsiniz - `datagrid-module-template.blade.php` veya `sablon4.blade.php` temel alınarak özelleştirme yapabilirsiniz.
```php
<?php
use App\Models\YeniModul;
$title = "Yeni Modül";
$tableWidth="100%";
$listDatas = YeniModul::orderBy("id","DESC")->paginate(setting('row_count'));
$tableName = "yeni_modul";
$blockGroup = [
'Genel Bilgiler' => [
'ad',
'aciklama',
],
// Diğer gruplar...
];
$firstUploadFolder = 'YeniModul/';
$firstUploadTitle = 'Dosya Yükle';
?>
<div class="content">
<div class="row">
@include("admin.type.document.upload")
@include("components.blocks.module-block")
</div>
</div>
```
3. **Type Tablosuna Kayıt Ekleyin**: 3. **Type Tablosuna Kayıt Ekleyin**:
- Admin panelinden yeni bir tip ekleyin - Admin panelinden **Modüller** sayfasına gidin ve yeni bir kayıt ekleyin.
- Modül için gerekli alanları belirtin - `Slug` kısmına oluşturduğunuz blade dosyasının adını yazın.
- URL adresi olarak oluşturduğunuz şablonu belirtin
**Önemli Not**: Citrus CMS'de yeni bir modül oluşturmak için genellikle model ve migration oluşturmak, ardından `sablon4.blade.php` şablonunu özelleştirmek yeterlidir. Tüm CRUD işlemleri otomatik olarak `AdminController.php` üzerinden yönetilir ve özel bir controller kodlamanıza gerek yoktur. **Önemli Not**: Tüm CRUD işlemleri otomatik olarak `AdminController.php` üzerinden yönetilir. Özel bir controller kodlamanıza genellikle gerek yoktur.
## Middleware ve İzin Sistemi ## Middleware ve İzin Sistemi