Sık sorulan sorular

En sık karşılaşılan sorunlar ve kısa cevapları; ayrıntılar bağlantılı sayfalarda.

Kurulum

Bileşenler görünüyor ama stilsiz

Tailwind paketin Blade dosyalarını taramıyordur. CSS dosyanızda (temada resources/css/acun-ui.css) @source '../../vendor/acunsoft/acun-ui-free/resources/views'; satırı olmalı. npm run dev çalışıyor olmalı ya da npm run build ile derlemiş olmalısınız. Bkz. CSS, JavaScript ve derleme.

Grafik, harita ya da tarih seçici boş kalıyor

ApexCharts, Leaflet ve flatpickr paketin bağımlılığı değildir. Uygulamanıza kurup registerChart, registerMap ve registerDateRangePicker ile Alpine'a tanıtmanız gerekir; temada bu kod resources/js/app.js dosyasındadır. Harita için leaflet/dist/leaflet.css, tarih seçici için flatpickr/dist/flatpickr.min.css de yüklenmelidir. Bkz. Bağımlılıklar.

Konsolda "[Acun UI PRO] JavaScript is not loaded" hatası var

Sayfada PRO JavaScript'ine ihtiyaç duyan bir bileşen var, ama PRO JS yüklenmemiş. Vite girişinize (temada resources/js/acun-ui.js) import '@acunsoft/acun-ui-pro'; ekleyip yeniden derleyin. Vite kullanmıyorsanız düzene @acunUiScripts ekleyin. Ayrıntılar aşağıda, İleri düzey bölümünde.

Livewire 3 ile çalışır mı?

Hayır. Paket Livewire 4 ister. Laravel 12 ve 13, Tailwind CSS 4 ve PHP 8.2 ve üstüyle çalışır. Bkz. Bağımlılıklar.

Giriş ve kayıt sistemi hazır geliyor mu?

Hayır. Acun UI hiçbir kimlik doğrulama paketi kurmaz (Sanctum, Fortify, Breeze, Jetstream…) ve kendi rotasını eklemez. Yalnızca giriş, kayıt, şifre sıfırlama ve iki adımlı doğrulama ekranlarının görünümünü verir. Kimlik doğrulamayı projenize uygun yöntemle siz kurarsınız; kullanıcı menüsü gibi bileşenler de yalnızca verdiğiniz değerleri gösterir (ör. :name="auth()->user()->name"). Bkz. Düzenler.

Paket güncellemesinde değişikliklerim kaybolur mu?

vendor/ altındaki dosyaları düzenlemeyin; güncellemede üzerine yazılır. Uygulamanıza kopyaladığınız bileşenler ve @theme değerleriniz korunur. Ancak kopyalanan bileşenler yeni sürümdeki düzeltmeleri almaz; güncellemeden sonra kopyalarınızı paketteki sürümle karşılaştırın.

Görünüm

Sayfalar arasında geçerken tema bir an beyaz yanıp sönüyor

Sayfayı temanın düzenleriyle (layouts.admin.vertical, horizontal, blank) kurun. Bu düzenler paketin düzen bileşenlerini kullanır ve koyu tema tercihini ilk boyamadan önce uygular. Kendi düzeninizi yazıyorsanız <head> içine <acun:layout.head> ekleyin. Bkz. Düzenler.

Bir bileşenin görünümünü değiştirmek istiyorum

Önce prop'lara ve class özniteliğine bakın; verdiğiniz sınıflar bileşenin sınıflarıyla birleştirilir. Renk ve köşe gibi genel değerler için @theme değişkenlerini kullanın. İşaretlemeyi değiştirmeniz gerekirse bileşeni uygulamanızın resources/views/components/ui/ klasörüne aynı adla kopyalayın. Bkz. Özelleştirme.

Bileşenler

Menüde bir öğe görünmüyor

Menü yetki denetimi yapmaz; can gibi bilinmeyen alanlar yok sayılır. Altında öğe kalmayan bölüm başlığı ve alt öğesi kalmayan grup gizlenir. Öğe görünüyor ama bir yere gitmiyorsa route değerindeki rota tanımlı değildir ya da url güvenli değildir; bağlantı # olur. Bkz. Menü.

Liste sayfasında sıralama çalışmıyor

Sütun sortableFields() içinde değilse sıralama isteği yok sayılır. Varsayılan olarak yalnızca defaultSortField() sıralanabilir. Bkz. Liste sayfası.

Kaydedilmemiş değişiklik uyarısı çıkmıyor

Formun acun:form dirty-check ile sarıldığını ve PRO JavaScript'inin yüklendiğini kontrol edin. Yüklenmemişse tarayıcı konsolunda [Acun UI PRO] ile başlayan bir hata görürsünüz. Uyarı penceresi acun:form-guard-dialog'dur; PRO kuruluysa paketin düzenleri onu kendiliğinden ekler. Bkz. Form penceresi.

Lisans

Hangi lisans bana uygun?

İki soruya bakın: temayı kaç projede kullanacaksınız ve son kullanıcılar ödeme yapacak mı? Karşılaştırma tablosu Lisans sayfasında.

Ücretsiz paketleri ticari projede kullanabilir miyim?

Evet. @acunsoft/acun-ui-core ve acunsoft/acun-ui-free MIT lisanslıdır; kaynak dosyalardaki telif bildirimini korumanız yeterlidir. PRO bileşenler temayla gelir ve temanın lisansıyla kullanılır. Bkz. Lisans.

İleri düzey

PRO JavaScript denetimi

PRO JavaScript'ine ihtiyaç duyan bileşenler: acun:combobox, acun:file-upload, acun:form-modal, acun:form dirty-check ve tarayıcıda çalışan işlemleri, sabit başlığı ya da sabit sütunları olan DataTable. Bunlardan biri sayfadaysa ve PRO JS yüklenmemişse konsola bir hata yazılır. Hata, düzeltmeyi ve çalışmayacak bileşenleri söyler. İki düzeltme yolu vardır:

• Vite ile: Vite girişinize import '@acunsoft/acun-ui-pro'; ekleyip derleyin (npm run build, geliştirirken npm run dev). Satır zaten varsa derleme eskidir; yeniden derleyin.
• Vite olmadan: Düzeninize @acunUiScripts ekleyin.

Denetim window.AcunUI.pro işaretine bakar. PRO JS yüklenince window.AcunUI.pro = { version, loaded: true, … } olur. Konsolda AcunUI.pro yazarak yüklenip yüklenmediğini ve sürümünü görebilirsiniz. Yalnızca tek tek modülleri içe aktarıyorsanız (ör. ui/combobox.js) işaret konmaz; PRO girişini (@acunsoft/acun-ui-pro) içe aktarın.

Hata ilk sayfa yüklemesinde çıkarsa açılır liste ve dosya yükleme alanı soluk ve tıklanamaz kalır. Sayfanın geri kalanı çalışır.

"The JavaScript file could not be loaded" yazıyorsa @acunUiScripts sayfada vardır ama dosya gelmemiştir. Tarayıcının ağ sekmesine bakın. Dosyayı public/ klasörüne yayınladıysanız php artisan vendor:publish --tag=acun-ui-pro-assets --force ile güncelleyin.

Hem Vite ile içe aktarıp hem @acunUiScripts kullanmak bir şeyi bozmaz: dosya PRO JS'in zaten yüklendiğini görür ve hiçbir şey yapmaz. Yine de gereksiz bir istektir; birini kaldırın. "The JavaScript was loaded twice" uyarısı ise PRO girişinin iki ayrı kopyası birden çalıştığında çıkar, ör. aynı girişi içe aktaran iki ayrı Vite girişi. Kopyalardan birini kaldırın.

Eski ad window.AcunUiPro aynı nesneyi verir ama konsola uyarı yazar; AcunUI.pro kullanın.