Instalasi dan Konfigurasi Kirby CMS di Lingkungan ServBay

Kirby adalah sistem manajemen konten (CMS) berbasis file yang fleksibel dan kuat, ideal untuk membangun berbagai jenis situs web. Berbeda dengan CMS tradisional berbasis database, Kirby menyimpan konten langsung pada sistem file, sehingga sangat ringan, mudah versi kontrol, dan sederhana dalam hal deployment.

Panduan ini akan membantu Anda menginstal dan mengonfigurasi Kirby 4.2 Starterkit di ServBay, sebuah lingkungan pengembangan web lokal yang dirancang khusus untuk developer. ServBay menyediakan PHP yang telah dikonfigurasi, web server (seperti Caddy atau Nginx), serta Composer secara siap pakai, menjadikannya platform ideal untuk pengembangan Kirby secara lokal.

Prasyarat

Sebelum memulai, pastikan Anda telah:

1. Menginstal dan menjalankan ServBay di macOS.
2. Mengaktifkan versi PHP yang dibutuhkan di ServBay (contoh ini menggunakan PHP 8.2).
3. Composer sudah tersedia di ServBay, sehingga tidak perlu instalasi tambahan.

Langkah-langkah Instalasi Kirby

Berikut adalah langkah-langkah detail untuk menginstal dan mengonfigurasi Kirby di lingkungan ServBay:

Langkah 1: Membuat Direktori Proyek

Pertama, buka aplikasi Terminal. Navigasi ke direktori root situs web default ServBay di /Applications/ServBay/www, lalu buat direktori proyek baru. Kita akan gunakan servbay-kirby-app sebagai nama contoh proyek.

cd /Applications/ServBay/www
mkdir servbay-kirby-app
cd servbay-kirby-app

Langkah 2: Membuat Proyek Kirby Menggunakan Composer

Composer sudah terintegrasi di ServBay, jadi Anda bisa langsung menggunakannya dari Terminal. Di dalam direktori proyek servbay-kirby-app, jalankan perintah Composer berikut untuk mengunduh dan membuat proyek Kirby Starterkit:

composer create-project getkirby/starterkit .

Perintah ini akan mengunduh file inti Kirby, dependensi, dan Starterkit yang sudah berisi konten serta template dasar ke direktori saat ini (.).

Langkah 3: Konfigurasi Web Server (Menambah Situs di ServBay)

Agar web server ServBay (seperti Caddy atau Nginx) dapat menjalankan proyek Kirby Anda, Anda perlu menambah konfigurasi situs baru di aplikasi ServBay.

1. Buka Aplikasi ServBay: Mulai aplikasi ServBay.
2. Masuk ke Pengelola Situs: Klik tab "Situs" di panel navigasi sebelah kiri pada jendela ServBay.
3. Tambah Situs Baru: Klik tombol "+" di bawah atau opsi serupa untuk menambah situs baru.
4. Isi Informasi Situs: Pada jendela konfigurasi yang muncul, lengkapi data berikut:
   • Nama: Beri nama yang mudah dikenali, misal My Kirby Site.
   • Domain: Tetapkan domain untuk pengembangan lokal, direkomendasikan dengan akhiran .local atau .servbay.demo, seperti servbay-kirby.local. ServBay akan mengatur DNS lokal secara otomatis.
   • Tipe Situs: Pilih PHP, karena Kirby adalah aplikasi PHP.
   • Versi PHP: Pilih versi PHP yang diinginkan, misal 8.2. Pastikan versi ini sesuai dengan syarat minimum Kirby.
   • Root Folder Situs: Tentukan direktori tempat file index.php Kirby berada. Untuk Starterkit Kirby, ini biasanya adalah direktori proyek itu sendiri. Masukkan atau pilih jalur yang dibuat pada langkah 1: /Applications/ServBay/www/servbay-kirby-app.
5. Simpan Konfigurasi: Setelah yakin data sudah benar, klik tombol Simpan. ServBay akan menerapkan konfigurasi baru secara otomatis dan mungkin akan me-restart web server terkait.

Langkah 4: Konfigurasi Dasar Kirby

Konfigurasi utama Kirby dilakukan melalui file site/config/config.php. Untuk Starterkit, konfigurasi dasar sudah cukup sehingga bisa langsung digunakan. Anda dapat menambah pengaturan kustom di file ini, seperti:

• Mengaktifkan mode debug (c::set('debug', true);)
• Mengatur bahasa Panel
• Mendefinisikan routing kustom, dan lainnya

Pada root proyek Anda, direktori content sudah otomatis dibuat oleh Starterkit Kirby untuk menyimpan seluruh konten halaman.

Langkah 5: Menjalankan dan Mengakses Situs Kirby

Setelah konfigurasi di ServBay selesai, Anda dapat mengakses situs Kirby menggunakan domain yang sudah diatur.

1. Pastikan ServBay Berjalan: Pastikan aplikasi ServBay aktif, beserta web server (Caddy / Nginx) dan PHP package yang diperlukan.
2. Akses Website: Buka web browser, lalu入力kan domain yang sudah dikonfigurasi pada langkah 3, contoh https://servbay-kirby.local.

Jika berhasil, Anda akan melihat halaman sambutan/default dari Kirby Starterkit. ServBay secara default mengaktifkan HTTPS baik secara otomatis, dengan demikian direkomendasikan mengakses menggunakan https://.

Langkah 6: Instalasi & Penggunaan Panel Kirby (Opsional)

Kirby menyediakan panel administrasi yang kuat, memudahkan Anda dalam mengelola konten, user, dan pengaturan situs.

1. Akses Halaman Instalasi Panel: Dari browser, buka situs Anda dan tambahkan /panel pada akhir URL, misal https://servbay-kirby.local/panel.
2. Buat Akun Admin: Jika pertama kali mengunjungi /panel, Anda akan diarahkan ke halaman instalasi panel. Ikuti instruksi untuk membuat akun administrator pertama (masukkan nama, password, email).
3. Masuk ke Panel: Setelah akun berhasil dibuat, login ke Panel Kirby dan mulai kelola konten situs Anda melalui antarmuka grafis.

Membangun Website menggunakan Kirby

Anda sekarang sudah berhasil menginstal dan mengonfigurasi Kirby di lingkungan ServBay, dan siap memanfaatkan sistem file-driven Kirby. Berikut beberapa konsep dasar dan operasi pengembangan Kirby:

Struktur Konten

Konten di Kirby disimpan di dalam direktori content. Setiap halaman memiliki folder tersendiri di dalam content. Isi halaman biasanya berupa file teks (misal: page.txt) di dalam folder tersebut, menggunakan sintaks mirip Markdown.

Contoh: Membuat Halaman "Tentang Kami"

Melalui terminal:

cd /Applications/ServBay/www/servbay-kirby-app
mkdir content/about
echo "Title: Tentang Kami\n----\nIni adalah konten halaman Tentang Kami." > content/about/about.txt

Akses https://servbay-kirby.local/about (jika template Anda mendukung).

Template

File template berada di direktori site/templates dan menentukan bagaimana setiap halaman dirender. Nama file biasanya disesuaikan dengan nama folder konten atau blueprint-nya (misal about.php untuk content/about atau halaman dengan blueprint about).

Contoh: Membuat Template about.php

Di file site/templates/about.php:

<?php snippet('header') ?>

<main>
  <h1><?= $page->title() ?></h1>
  <div class="text">
    <?= $page->text()->kt() // Render dengan KirbyText ?>
  </div>
</main>

<?php snippet('footer') ?>

Di sini, fungsi snippet() digunakan untuk memuat bagian yang dapat digunakan ulang seperti header dan footer.

Blueprint

File blueprint terletak di direktori site/blueprints, dan mendefinisikan struktur halaman, field, serta opsi untuk panel administrasi. Ditulis dengan format YAML.

Contoh: Membuat Blueprint about.yml

Di file site/blueprints/pages/about.yml:

title: Halaman Tentang

columns:
  - width: 2/3
    fields:
      text:
        label: Konten Teks
        type: textarea
        size: large
        buttons:
          - bold
          - italic
          - link
          - email

  - width: 1/3
    fields:
      # Field sidebar, misal untuk upload gambar
      cover_image:
        label: Gambar Sampul
        type: files
        max: 1
        uploads:
          template: image

Setelah blueprint didefinisikan, field ini akan muncul saat membuat halaman "Tentang" baru melalui panel.

Snippet

Snippet adalah file PHP yang bisa digunakan kembali, ideal untuk bagian seperti header, footer, menu navigasi, dsb. File snippet disimpan di site/snippets.

Controller dan Model

Untuk logic yang lebih kompleks, Anda bisa menggunakan controller (site/controllers) untuk mengelola data halaman, serta model (site/models) untuk mendefinisikan class page kustom Anda.

Asset Statis

File CSS, JavaScript, gambar, dan file statis lainnya umumnya disimpan di folder assets pada root proyek. Anda bisa menggunakan fungsi helper url('assets/...') pada template untuk mendapatkan URL file statis.

Contoh: Memanggil CSS dan JS

Di site/templates/default.php atau site/snippets/header.php:

<link rel="stylesheet" href="<?= url('assets/css/style.css') ?>">
<script src="<?= url('assets/js/script.js') ?>"></script>

Kesimpulan

Dengan mengikuti langkah-langkah di atas, Anda telah berhasil menginstal dan mengonfigurasi Kirby CMS di lingkungan pengembangan lokal ServBay. ServBay menawarkan environment terintegrasi yang sangat memudahkan deployment dan manajemen aplikasi PHP, sehingga Anda bisa fokus mengeksplorasi fitur-fitur powerful yang disediakan Kirby dan fleksibilitas pengelolaan berbasis file. Kini Anda bisa melanjutkan eksplorasi Kirby lebih dalam, mulai dari pengelolaan template, blueprint, snippet, hingga membangun struktur situs dan fungsionalitas lebih kompleks sesuai kebutuhan proyek Anda.