Yapılandırma

Acun UI'nin ayarları config/acun-ui.php dosyasındadır. Bu sayfa dosyayı nasıl oluşturacağınızı ve her anahtarın ne yaptığını gösterir.

En kısa örnek

Dosya uygulamanızda yoksa paketten kopyalayın:

php artisan vendor:publish --tag=acun-ui-config

En sık değiştirilen ayarlar arayüz dili ve düzenin görünümüdür:

// config/acun-ui.php
'locale' => [
    'supported' => ['tr', 'en'],
    'fallback' => 'tr',         // başka hiçbir şey karar vermezse Türkçe
    // …
],

'layout' => [
    'theme' => 'light',         // ilk açılışta açık tema
    'brand_color' => 'green',   // ana renk
    'theme_toggle' => false,    // üst çubuktaki tema düğmesini gizler
    // …
],

Bunlar varsayılan değerlerdir. Kullanıcının görünüm panelinden seçtiği tema ve renk her zaman önce gelir.

Dosyayı oluşturmak

vendor:publish paketin dosyasını config/acun-ui.php olarak kopyalar. Dosyayı hiç oluşturmazsanız paketin varsayılanları geçerlidir.

Dosyanızda olmayan bir anahtar hata vermez; o anahtar için paketin varsayılanı kullanılır. Eski bir dosyaya yeni bir bölüm eklemek için bölümü vendor/acunsoft/acun-ui-free/config/acun-ui.php dosyasından kopyalayın. --force ile yeniden yayınlamak dosyanın tamamını değiştirir ve kendi değerleriniz kaybolur.

Canlı sunucuda bir ayarı değiştirdikten sonra önbelleği yenileyin: php artisan optimize. Ayrıntılar Yayına alma sayfasındadır.

Düzen

layout dizisi panel düzenlerinin varsayılan görünümüdür. Dosyada her anahtar null durur. null, tablodaki paket varsayılanı demektir.

Anahtar	Varsayılan	Ne yapar
`theme`	`system`	Tema: `light`, `dark` ya da cihaza uyan `system`.
`brand_color`	`default`	Ana renk: `default`, `green`, `red`, `yellow`, `blue`, `gray`, `dark` ya da `#rrggbb`.
`skin`	`default`	`bordered`: gölgeler yerine ince çizgiler.
`semi_dark`	`false`	`true`: açık temada menü koyu olur.
`sidebar_mode`	`expanded`	Kenar menüsü: `expanded` (açık) ya da `collapsed` (daraltılmış).
`navbar_mode`	`fixed`	Üst çubuk: `fixed` (sabit), `static` (sayfayla kayar) ya da `hidden` (gizli).
`customizer`	`false`	`true`: sağ kenarda görünüm panelini gösterir.
`theme_toggle`	`true`	`false`: üst çubuktaki tema düğmesini gizler.

Öncelik sırası şöyledir: sayfanın zorladığı değer (Layout::page()), kullanıcının tercihi (düzen prop'u ya da tarayıcı), bu dosya, paketin varsayılanı.

Not
Temanın düzenleri görünüm panelini prop ile açar; bu yüzden customizer anahtarı onları değiştirmez. Paneli kaldırmak için resources/views/layouts/admin/vertical.blade.php ve horizontal.blade.php dosyalarındaki customizer sözcüğünü silin.

Dil

locale dizisi arayüz dilini seçer. Bunun için SetLocale ara katmanı (middleware) web grubunda olmalıdır; temanın bootstrap/app.php dosyası onu ekler. Dil şu sırayla seçilir: kayıtlı seçim, tarayıcının dili, ziyaretçinin ülkesi, yedek dil.

Anahtar	Varsayılan	Ne yapar
`supported`	`['tr', 'en']`	Sunulan diller; dil seçici bunları listeler.
`fallback`	`'en'`	Başka hiçbir şey karar vermezse kullanılan dil.
`countries`	`['TR' => 'tr']`	Ülke kodu ve dili; listede olmayan ülke yedek dili alır.
`country_headers`	`CF-IPCountry`, `CloudFront-Viewer-Country`, `X-Vercel-IP-Country`, `X-Country-Code`	Ülke kodunun okunduğu istek başlıkları.
`cookie`	`'acun_locale'`	Seçilen dilin saklandığı çerezin adı.
`user_attribute`	`null`	Seçimi kullanıcının hesabında da tutan alanın adı (`null`: yalnızca çerez).
`names`	`['tr' => 'Türkçe', 'en' => 'English']`	Dil seçicide görünen adlar.
`flags`	`['tr' => 'tr', 'en' => 'gb']`	Her dilin bayrağı: `tr`, `gb`, `us`, `de`, `fr`, `es`, `it`, `nl` ya da `ru`.

DataTable (PRO)

datatable dizisi bütün tabloların varsayılanlarıdır. Bir tablo bu değerlerin çoğunu kendi sınıfında değiştirebilir.

Anahtar	Varsayılan	Ne yapar
`per_page`	`[10, 25, 50, 100]`	Sayfa başına satır seçenekleri.
`default_per_page`	`25`	Açılışta gösterilen satır sayısı.
`search_debounce`	`400`	Yazmayı bıraktıktan kaç milisaniye sonra arama yapılacağı.
`url_state`	`true`	Arama, sıralama, filtre ve sayfa boyutunu adres çubuğunda tutar.
`sticky_header`	`false`	`true`: bütün tablolarda başlık satırı sabit kalır, gövde kendi içinde kayar.
`pagination`	`'paginate'`	Sayfalama türü: `paginate`, `simple` ya da `cursor`.
`select_all`	`'all'`	Başlıktaki onay kutusu: `all` filtreye uyan bütün kayıtları, `page` yalnızca görünen sayfayı seçer.
`selection.max_keys`	`5000`	Tek tek seçilebilecek en çok satır.
`actions.enabled`	`true`	`false`: yeni işlem sistemini kapatır; yalnızca eski `Action` ve `BulkAction` çalışır.
`density.default`	`'normal'`	Satır yüksekliği: `compact`, `normal` ya da `comfortable`.
`columns.persist`	`'none'`	`session`: kullanıcının sütun seçimi oturumda da saklanır.
`routes.middleware`	`['web', 'auth']`	İndirme ve yazdırma rotalarının ara katmanları.
`routes.prefix`	`'acun-ui/data-table'`	Bu rotaların adres öneki.

Dışa aktarma ayarları datatable.exports içindedir:

Anahtar	Varsayılan	Ne yapar
`enabled`	`true`	`false`: dosya, yazdırma ve PDF dahil bütün dışa aktarmayı kapatır.
`queue_threshold`	`5000`	Bu satır sayısının üstündeki dosya kuyrukta hazırlanır.
`chunk_size`	`1000`	Veritabanından bir seferde okunan satır sayısı.
`disk`	`'local'`	Dosyaların yazıldığı disk.
`directory`	`'exports'`	Diskteki klasör.
`queue`	`null`	Kuyruk adı (`null`: varsayılan kuyruk).
`connection`	`null`	Kuyruk bağlantısı (`null`: varsayılan bağlantı).
`expire_minutes`	`60`	İndirme bağlantısının ömrü (dakika); eski dosyalar silinir.
`poll_seconds`	`3`	Tablonun kuyruktaki işi kaç saniyede bir sorduğu.
`cache_store`	`null`	İşin durumunu tutan önbellek; kuyruk işçisiyle ortak olmalıdır.
`csv_delimiter`	`';'`	CSV dosyasındaki ayırıcı.
`copy_max_rows`	`1000`	Panoya kopyalanabilecek en çok satır.
`per_minute`	`30`	Bir kullanıcının dakikada başlatabileceği yazdırma, indirme ve kopyalama sayısı.
`drivers`	`csv`, `json`	Her indirme biçiminin sürücü sınıfı. PDF'in sürücüsü yoktur; yazdırma sayfasını açar.

PDF işlemi yazdırma sayfasını açar; dosyayı tarayıcının "PDF olarak kaydet" seçeneği oluşturur. Ek bir paket gerekmez. Satır sınırı print.max_rows ayarından gelir. Eski sürümlerden kalan exports.pdf anahtarı (max_rows, orientation, paper, title, footer) artık okunmaz; yayımladığınız dosyada varsa silebilirsiniz.

Yazdırma ayarları datatable.print içindedir:

Anahtar	Varsayılan	Ne yapar
`layout`	`'acun-ui-pro::components.data-table.print'`	Yazdırma sayfasının görünümü.
`max_rows`	`2000`	Yazdırma sayfasındaki en çok satır. PDF de bu sayfayı kullanır.
`token_minutes`	`10`	Yazdırma bağlantısının ömrü (dakika).

Arama (PRO)

search dizisi DataTable ve liste sayfalarının aramasını ayarlar.

Anahtar	Varsayılan	Ne yapar
`driver`	`'database'`	Arama sürücüsü: `database`, `drivers` içindeki bir ad ya da `SearchDriver` sınıfının adı; `ACUN_UI_SEARCH_DRIVER` ortam değişkeninden okunur.
`drivers`	`[]`	Kendi sürücüleriniz: ad ve sınıf.
`suffix`	`'_search'`	Arama sütununun adına eklenen son ek (`email` → `email_search`).
`length`	`255`	Arama sütununun uzunluğu (`0`: `text`).
`max_length`	`200`	Arama teriminin kullanılan en çok karakteri.
`max_words`	`10`	Arama teriminin kullanılan en çok kelimesi.
`verify_columns`	`null`	Eksik arama sütununu bildiren denetim (`null`: yalnızca `local` ve `testing` ortamında).

JavaScript dosyalarının adresi

assets ve pro.assets dizileri, Vite kullanmayan uygulamalar için paketlerle gelen JavaScript dosyalarının adresidir. Tema script'i (acun-ui-boot.js) her uygulamada buradan gelir.

Anahtar	Varsayılan	Ne yapar
`assets.prefix`	`'acun-ui'`	Dosyaların adres öneki: `/acun-ui/acun-ui-boot.js`, `/acun-ui/acun-ui.js`.
`assets.url`	`null`	Dosyaları içeren bir CDN klasörü; verilirse önce gelir.
`pro.assets.prefix`	`'acun-ui'`	PRO dosyasının adres öneki: `/acun-ui/acun-ui-pro.js`.
`pro.assets.url`	`null`	PRO dosyasının CDN'deki tam adresi; verilirse önce gelir.

Ortam değişkenleri

Paketin okuduğu tek ortam değişkeni ACUN_UI_SEARCH_DRIVER'dır. Kendi arama sürücünüzü ortama göre seçmek için kullanın:

ACUN_UI_SEARCH_DRIVER=elastic

Başka bir ayarı ortama göre değiştirmek isterseniz o satırda env() kullanın. Örneğin 'theme' => env('ACUN_UI_THEME').

Daha fazlası

Özelleştirme: renkler, yazı tipleri ve düzen varsayılanları.
Düzenler: düzen prop'ları ve kullanıcı tercihlerini saklamak.
Dil ve çeviri: dil seçimi ve çeviri dosyaları.
DataTable: tüm seçenekler: tablo sınıfında değiştirilen ayarlar.
Arama: arama sütunları ve sürücüler.
CSS, JavaScript ve derleme: @acunUiScripts ve dosyaların yayınlanması.