laravel
Kurulum
Yeni bir Laravel projesi oluşturun. Yeni bir Laravel projesi oluşturarak başlayın.
composer create-project laravel/laravel example-app
kurulumdan sonra projeye gidin.
cd example-app
CoreUI’yi yükleyin. Artık CoreUI’yi yükleyebiliriz. Dropdown, popover ve tooltip'lerimizin konumlandırması için Popper'ı da yükleyeceğiz. Bu bileşenleri kullanmayı planlamıyorsanız, Popper'ı burada atlayabilirsiniz.
npm i --save @coreui/coreui @popperjs/core
PRO kullanıcıları için
npm i --save @coreui/coreui-pro @popperjs/core
Gereksiz bağımlılıklar yüklemekten kaçınmak için yalnızca gerekli bileşenleri yüklediğinizden emin olun.
Ek bağımlılık yükleyin. CoreUI'ya ek olarak, CoreUI’nin CSS'ini düzgün bir şekilde içe aktarmak ve paketlemek için başka bir bağımlılık (Sass) gerekiyor.
npm i --save-dev sass
Gerekli tüm bağımlılıkları yükleyip kurduktan sonra, proje dosyalarını oluşturmak ve CoreUI'yi içe aktarmak için çalışmalara başlayabiliriz.
Proje yapısı
Zaten example-app
klasörünü oluşturduk ve tüm bağımlılıkları yükledik. Şimdi app.scss
dosyamızı da oluşturacağız. Aşağıdaki komutları example-app
içinden çalıştırın veya aşağıda gösterilen klasör ve dosya yapısını manuel olarak oluşturun.
mkdir resources/sass
touch resources/sass/app.scss
Ayrıca app.css
dosyasını kaldırabilirsiniz çünkü ona ihtiyacımız yok.
rm resources/css/app.css
rmdir resources/css
Tamamlandığında, projeniz şöyle görünmelidir:
example-app/
├── app/
├── bootstrap/
├── config/
├── database/
├── node_modules/
├── public/
├── resources/
│ ├── js/
│ │ ├── app.js
│ │ └── bootstrap.js
│ ├── sass/
│ │ └── app.scss
│ └── views/
│ └── welcome.blade.php
├── routes/
├── storage/
├── tests/
├── vendor/
├── ...
├── composer.json
├── composer.lock
├── package-lock.json
├── package.json
├── ...
└── vite.config.js— Laravel Belgeleri
Vite'i Yapılandırma
Bağımlılıklar yüklendi ve proje klasörümüz kodlamaya başlamak için hazır, şimdi Vite'i yapılandırabiliriz.
vite.config.js
dosyasını editörünüzde açın. Boş olmadığından,app.scss
dosyamız ile çalışmak için bazı değişiklikler yapmamız gerekiyor.import { defineConfig } from 'vite';
import laravel from 'laravel-vite-plugin';
export default defineConfig({
plugins: [
laravel({
- input: ['resources/css/app.scss', 'resources/js/app.js'],
+ input: ['resources/sass/app.scss', 'resources/js/app.js'],
refresh: true,
}),
],
});Sonraki adımda,
resources/views/welcome.blade.php
dosyasını değiştiriyoruz. Blade dosyamıza SCSS ve JavaScript dosyalarımızı eklememiz gerekiyor.<!DOCTYPE html>
<html lang="{{ str_replace('_', '-', app()->getLocale()) }}">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Laravel</title>
<!-- Fontlar -->
<link rel="preconnect" href="https://fonts.bunny.net">
<link href="https://fonts.bunny.net/css?family=figtree:400,600&display=swap" rel="stylesheet" />
+
+ <!-- Scriptler -->
+ @vite(['resources/sass/app.scss', 'resources/js/app.js'])
<!-- Stil -->
Vite, Laravel uygulamalarında modern bir geliştirme aracı olarak kullanılır ve CSS ile JavaScript dosyalarını yönetir.
CoreUI'yi İçe Aktarma
Şimdi, CoreUI’nin CSS'ini içe alalım. CoreUI’nin kaynak Sass’ını içe aktarmak için
resources/sass/app.scss
dosyasına aşağıdakileri ekleyin.// CoreUI'nin CSS'inin tamamını içe aktar
@import "@coreui/coreui/scss/coreui"PRO kullanıcıları için
// CoreUI PRO'nun CSS'inin tamamını içe aktar
@import "@coreui/coreui-pro/scss/coreui"İsterseniz stillerimizi bireysel olarak da içe aktarabilirsiniz. Ayrıntılar için
Sass içe aktarma belgelerimizi okuyun
.Sonraki adımda CoreUI’nin JavaScript'ini içe aktarıyoruz. CoreUI’nin JS'inin tamamını içe aktarmak için
resources/js/bootstrap.js
dosyasına aşağıdakileri ekleyin. Popper, CoreUI aracılığıyla otomatik olarak içe aktarılacaktır.// CoreUI'nin JS'inin tamamını içe aktar
import * as coreui from '@coreui/coreui'
window.coreui = coreuiPRO kullanıcıları için
// CoreUI PRO'nun JS'inin tamamını içe aktar
import * as coreui from '@coreui/coreui-pro'
window.coreui = coreuiAyrıca, paket boyutlarını aşağıda tutmak için gerektiğinde JavaScript eklentilerini bireysel olarak içe aktarabilirsiniz:
import { Tooltip, Toast, Popover } from '@coreui/coreui'
CoreUI’nin eklentilerini kullanma hakkında daha fazla bilgi için
JavaScript belgelerimizi okuyun
.
Laravel Uygulamasını Oluşturma ve Çalıştırma
Artık CSS ve JS dosyalarını oluşturmalıyız. Terminalde
example-app
klasöründen aşağıdaki komutu çalıştırın.npm run build
Ve nihayet, Laravel Uygulamamızı başlatabiliriz. Terminalde
example-app
klasöründen şu komutu çalıştırın:php artisan serve
Ve işte tamam! 🎉 CoreUI’nin kaynak Sass ve JS dosyaları tamamen yüklendiğinde, yerel geliştirme sunucunuz artık şöyle görünmelidir.
Artık kullanmak istediğiniz herhangi bir CoreUI bileşenini eklemeye başlayabilirsiniz.