Hızlı başlangıç

Bu sayfa, satın aldığınız temayı beş dakikada kendi bilgisayarınızda çalıştırmayı anlatır.

Zip'i indirin

Temayı Hesabım › İndirmeler sayfasından zip olarak indirin. Acun UI paketleri (ücretsiz bileşenler ve PRO) zip'in içindedir. npm'den ya da bir Composer deposundan paket indirmezsiniz. Lisans anahtarı ya da depo şifresi de girmezsiniz.

acun-admin-1.1.0/
├── full-version/     Tam sürüm: bütün demo sayfaları ve örnek veriler
├── starter-kit/      Başlangıç sürümü: düzen, menü, boş pano ve giriş sayfaları
├── LICENSE.md        Lisans metni
└── README.md         Kısa kurulum özeti ve doküman adresi

İki klasör de kendi başına çalışan birer Laravel 13 uygulamasıdır. İçlerindeki dosyalar Klasör yapısı sayfasında anlatılır.

Full sürüm mü, starter kit mi?

	Full sürüm	Starter kit
Ne için	Bütün sayfaları görmek, parça kopyalamak	Kendi projenize temiz bir başlangıç
Sayfalar	Pano, kullanıcılar, tablolar, formlar, bileşen örnekleri, giriş sayfaları, örnek mağaza	Boş pano, hesap ayarları, giriş sayfaları
Örnek veri	Var: JSON dosyalarında, veritabanı gerekmez	Yok

Projenize starter kit ile başlayın. İhtiyacınız olan sayfaları full sürümden kopyalayın. İki klasördeki Acun UI paketleri aynıdır; bütün bileşenler ikisinde de vardır.

Gereksinimler

PHP 8.3 ya da üstü
Composer 2.2 ya da üstü
Veritabanı: full sürümde gerekmez. Starter kit'te SQLite (varsayılan), MySQL ya da PostgreSQL.
Node.js 20.19+ ya da 22.12+: yalnızca tasarımı değiştirip CSS ve JavaScript'i yeniden derlerken. Derlenmiş dosyalar zip'te hazırdır.

macOS ve Windows'ta Laravel Herd PHP, Composer ve Node.js'i tek seferde kurar. Bütün paketler ve sürümleri Bağımlılıklar sayfasındadır.

Adım adım

Zip'i açın ve kullanacağınız klasöre girin:
```
cd acun-admin-1.1.0/starter-kit
```
PHP bağımlılıklarını kurun. Acun UI paketleri packages/acun-ui klasöründen bağlanır, internetten inmez:
```
composer install
```
Ortam dosyasını oluşturun ve uygulama anahtarını üretin:
```
cp .env.example .env
php artisan key:generate
```
Veritabanı tablolarını kurun. Starter kit varsayılan olarak SQLite kullanır. Full sürümde bu adımı atlayın:
```
php artisan migrate
```
Uygulamayı başlatın:
```
php artisan serve
```

Tarayıcıda açın

http://127.0.0.1:8000 adresini açın. Herd kullanıyorsanız klasörü Herd'e ekleyin; site http://klasor-adi.test adresinde açılır.

Full sürümde ana sayfa örnek mağazayı gösterir; yönetim paneli /admin adresindedir. Bu adımların hiçbiri Node.js istemez, çünkü derlenmiş CSS ve JavaScript zip'te hazır gelir.

Tasarımı değiştirmek

Renkleri, Tailwind sınıflarını ya da resources/js altındaki dosyaları değiştirdiğinizde CSS ve JavaScript'i yeniden derleyin:

npm install      # yalnızca ilk seferde: derleme araçlarını kurar
npm run build    # public/build klasörüne derler

Geliştirirken npm run dev değişiklikleri anında gösterir. Ayrıntılar CSS, JavaScript ve derleme sayfasındadır.

Full sürümün örnek verileri

Full sürümdeki siparişler ve kullanıcılar resources/data/orders.json ile resources/data/users.json dosyalarındadır. Örnek mağazanın ürünleri ve kategorileri de aynı klasörde, products.json ile categories.json dosyalarındadır. Kurulacak bir veritabanı, migration ya da seed adımı yoktur.

Bir sayfa veriye ilk kez dokunduğunda tablolar bellekte kurulur ve JSON satırları yüklenir. Veriye dokunmayan sayfalar hiçbir şey yüklemez.
Sayfadaki değişiklikler (ör. bir siparişi kargoya vermek) yalnızca o istekte görünür. Sayfa yenilenince veri dosyadaki hâline döner.
Tarihler yüklenirken bugüne kaydırılır. Bu yüzden "son 30 gün" gibi özetler her zaman doludur.
Sipariş ve kullanıcı verisini yeniden üretmek için php artisan demo:data çalıştırın.

Tabloların yapısı app/Support/JsonDatabase.php içindedir. Kendi projenizde aynı yapıyı migration olarak yazın. DataTable ve liste sayfaları gerçek bir veritabanıyla aynı şekilde çalışır.

İzinler

Linux ya da macOS sunucuda Laravel'in storage ve bootstrap/cache klasörlerine yazabilmesi gerekir:

chmod -R ug+rw storage bootstrap/cache

MySQL ya da PostgreSQL kullanmak

.env dosyasındaki veritabanı bilgilerini değiştirin:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=veritabani_adi
DB_USERNAME=kullanici
DB_PASSWORD=sifre

Ardından tabloları kurun:

php artisan migrate

Dikkat
php artisan migrate:fresh bütün tabloları silip baştan kurar. Canlı veritabanında çalıştırmayın.

Güncellemeler

Yeni bir sürüm çıktığında Hesabım › İndirmeler sayfasından yeni zip'i indirin. Kendi projenizde yalnızca Acun UI paketlerini değiştirin:

Projenizdeki packages/acun-ui klasörünü yeni zip'teki starter-kit/packages/acun-ui ile değiştirin.
Bağımlılıkları ve derlenmiş dosyaları yenileyin:
```
composer update "acunsoft/*"
npm run build
```

app/, resources/ ve routes/ altındaki kendi dosyalarınız bu işlemden etkilenmez. Bir bileşenin görünümünü uygulamanıza kopyaladıysanız o kopya güncellemeyi almaz (bkz. İsteğe bağlı yayınlar). Sürümdeki değişiklikleri ürünün sayfasındaki sürüm notlarından okuyun.

Sonraki adım

Panele kendi sayfanızı ekleyin: İlk sayfanız. İlgili sayfalar:

Mevcut projeye ekleme: Acun UI'yi temayı kullanmadan var olan bir Laravel projesine ekleyin.
Yapılandırma: config/acun-ui.php ayarları.
Yayına alma: uygulamayı sunucuya taşımak.