Mulai

Sekitar 2 menit...

Selamat datang di Waline. Hanya dalam beberapa langkah, Anda dapat mengaktifkan Waline untuk menyediakan komentar dan penghitung halaman di situs Anda.

Penerapan Server

Klik tombol di atas untuk menuju Vercel dan men-deploy server.
Catatan
Jika belum login, Vercel akan meminta Anda untuk mendaftar atau masuk. Silakan gunakan akun GitHub untuk login cepat.
Masukkan nama proyek Vercel yang Anda sukai dan klik Create untuk melanjutkan:
create
Vercel akan membuat dan menginisialisasi repositori baru berdasarkan template Waline. Nama repositori akan sama dengan nama proyek yang baru saja Anda masukkan.
deploy
Setelah satu atau dua menit, kembang api akan muncul di layar untuk merayakan deployment yang berhasil. Klik Go to Dashboard untuk berpindah ke dashboard aplikasi.
deploy

Membuat Database

Klik Storage di bagian atas untuk masuk ke halaman konfigurasi penyimpanan, kemudian pilih Create Database. Pilih Neon sebagai Marketplace Database Providers, dan klik Continue untuk melanjutkan.
neon
Anda akan diminta untuk membuat akun Neon. Klik Accept and Create untuk menerima dan membuatnya. Selanjutnya, Anda akan memilih paket database, termasuk region dan kuota. Anda dapat membiarkan semua default dan klik Continue.
neon
Anda kemudian akan diminta untuk mendefinisikan nama database. Anda juga dapat membiarkannya tidak berubah dan klik Continue.
neon
Sekarang Anda akan melihat layanan database yang baru saja dibuat di bagian Storage. Klik dan pilih Open in Neon untuk berpindah ke Neon. Di antarmuka Neon, pilih SQL Editor dari sidebar kiri, tempelkan pernyataan SQL dari waline.pgsql ke dalam editor, dan klik Run untuk membuat tabel.
neon
neon
Setelah beberapa saat, Anda akan diberitahu bahwa pembuatan berhasil. Kembali ke Vercel, klik Deployments di bagian atas, dan klik tombol Redeploy di sebelah kanan deployment terbaru. Langkah ini memastikan layanan database yang baru dikonfigurasi berlaku.
redeploy success
Anda akan diarahkan ke halaman Overview dan deployment akan dimulai. Setelah beberapa saat, STATUS akan berubah menjadi Ready. Klik Visit untuk membuka website yang di-deploy. URL ini adalah alamat server Anda.
visit

Mengikat Domain Kustom

Klik Settings → Domains di bagian atas untuk masuk ke halaman konfigurasi domain.
Masukkan domain yang ingin Anda ikat dan klik Add.
Add domain
Tambahkan record CNAME baru di penyedia domain Anda:
Type Name Value
CNAME example cname.vercel-dns.com
Tunggu record DNS berlaku. Anda kemudian dapat mengakses Waline menggunakan domain Anda sendiri 🎉
- Sistem komentar: example.yourdomain.com
- Manajemen komentar: example.yourdomain.com/ui
success

Type	Name	Value
CNAME	example	cname.vercel-dns.com

Impor di HTML

Berikut cara menambahkan Waline ke halaman web atau website Anda:

Impor stylesheet https://unpkg.com/@waline/client@v3/dist/waline.css di <head>

Buat tag <script> dan inisialisasi dengan init() dari https://unpkg.com/@waline/client@v3/dist/waline.js sambil meneruskan opsi wajib el dan serverURL.

Opsi el adalah elemen yang digunakan untuk rendering Waline. Anda dapat mengatur CSS selector dalam bentuk string atau objek HTMLElement.
serverURL adalah tautan ke server deployment Anda, yang baru saja dibuat di Vercel.
Untuk opsi lainnya, kunjungi halaman Props Komponen

Berikut adalah contohnya:

<head>
  <!-- ... -->
  <link rel="stylesheet" href="https://unpkg.com/@waline/client@v3/dist/waline.css" />
</head>
<body>
  <!-- ... -->
  <div id="waline"></div>
  <script type="module">
    import { init } from 'https://unpkg.com/@waline/client@v3/dist/waline.js';

    init({
      el: '#waline',
      serverURL: 'https://your-domain.vercel.app',
      lang: 'en',
    });
  </script>
</body>

Layanan komentar kini akan berjalan dengan sukses di website Anda 🎉!

Manajemen Komentar (Admin)

Setelah deployment selesai, kunjungi <serverURL>/ui/register untuk mendaftar. Orang pertama yang mendaftar akan ditetapkan sebagai administrator.
Setelah Anda login sebagai administrator, Anda dapat mengakses dashboard manajemen komentar. Anda dapat mengedit, menandai, atau menghapus komentar di sini.
Pengguna juga dapat mendaftar akun melalui kotak komentar, dan akan diarahkan ke halaman profil mereka setelah login.

Tutorial Video

Pengguna Waline yang antusias membuat tutorial video berikut. Jika petunjuk di atas kurang jelas, Anda dapat merujuk ke video berikut: