Panduan Template Kos & Properti

Panduan ini menjelaskan cara mengubah template menjadi website-mu, lalu mempublikasikannya. Kamu tidak perlu bisa coding. Cukup ikuti langkahnya satu per satu. Read this guide in English.

1. Isi paket

Untuk melihat website-mu kapan saja, klik dua kali index.html. File akan terbuka di browser. Setelah mengedit dan menyimpan, tekan tombol Refresh di browser untuk melihat perubahannya.

2. Persiapan: aplikasi untuk mengedit

index.html adalah file teks biasa. Kamu perlu aplikasi yang bisa mengedit teks apa adanya, bukan aplikasi dokumen seperti Microsoft Word.

Disarankan: Visual Studio Code (gratis)

Unduh di code.visualstudio.com, tersedia untuk Windows dan Mac. Buka aplikasinya, pilih File → Open Folder, lalu pilih folder template ini. Klik index.html di daftar sebelah kiri untuk mengeditnya.

Alternatif tanpa instal

• Windows: klik kanan index.html → Open with → Notepad.
• Mac (TextEdit): buka TextEdit → menu TextEdit → Settings (atau Preferences) → tab Open and Save → centang "Display HTML files as HTML code instead of formatted text". Tanpa pengaturan ini, TextEdit akan merusak file saat disimpan.

Cara mencari teks

Tekan Ctrl+F (Windows) atau Cmd+F (Mac) di aplikasi editor, ketik kata yang kamu lihat di website, dan editor akan melompat ke tempatnya. Ini cara tercepat menemukan apa pun yang ingin diganti.

3. Mulai cepat

Kalau kamu ingin cepat, kerjakan urutan ini. Tiap langkah dijelaskan lengkap di bagian berikutnya.

1. Ekstrak ZIP, klik dua kali index.html untuk melihat tampilan awal.
2. Isi nomor WhatsApp di bagian PENGATURAN.
3. Ganti nama dan teks contoh dengan milikmu.
4. Masukkan foto ke folder foto dan pasang di tempatnya.
5. Ganti tipe kamar dan harga (ubah data-harga), lalu atur jumlah kamar kosong.
6. Sesuaikan fasilitas, jarak, dan aturan dengan kosmu.
7. Sesuaikan warna dengan logomu.
8. Periksa dengan daftar cek, lalu upload ke Netlify atau hosting-mu.

Untuk pemula, siapkan waktu sekitar 1–2 jam, sebagian besar untuk menyiapkan foto.

4. Mengisi nomor WhatsApp

Ini langkah paling penting. Tanpa nomor, tombol "Tanya", kalkulator sewa, dan formulir survei belum berfungsi.

1. Buka index.html, lalu cari kata PENGATURAN. Letaknya di bagian bawah file.
2. Temukan baris ini:

   nomorWhatsApp: '',

3. Tulis nomormu di antara dua tanda kutip:

   nomorWhatsApp: '0812-3456-7890',

   Format 0812…, +62 812…, dan 62812… semuanya diterima.
4. Simpan, lalu refresh browser. Klik salah satu tombol WhatsApp. WhatsApp akan terbuka dengan pesan yang sudah terisi.

Selama nomor masih kosong, tombol dan formulir hanya menampilkan pengingat. Ini disengaja, supaya pengunjung tidak mengirim pesan ke nomor yang salah.

5. Mengganti teks

Semua nama, harga, cerita, dan ulasan di template ini adalah contoh. Cara termudah: cari teks yang terlihat di website (misalnya Kos Melati) dengan Ctrl+F / Cmd+F, lalu ganti.

Yang wajib diganti

Menghapus satu bagian

Setiap bagian diawali komentar seperti <!-- ── ULASAN ── -->. Untuk menghapusnya, hapus dari <section di bawah komentar itu sampai </section> pasangannya. Hapus juga tautannya di menu atas (cari href="#ulasan").

6. Mengganti foto

Kotak berwarna dengan ikon adalah tempat foto. Template ini sengaja tidak menyertakan foto: foto kamar dan bangunan milikmu sendiri jauh lebih meyakinkan daripada foto stok.

Langkah

1. Simpan fotomu di folder foto. Beri nama huruf kecil tanpa spasi, misalnya kamar-a.jpg.
2. Di index.html, cari kotak foto yang ingin diganti. Bentuknya seperti ini:

   <div class="foto">
       <svg ...>...</svg>
   </div>

3. Ganti seluruh bagian <svg ...>...</svg> dengan:

   <img src="foto/kamar-a.jpg" alt="Keterangan singkat foto" />

   Isi alt dengan keterangan singkat. Ini dibaca oleh Google dan pengunjung tunanetra.

Foto otomatis dipotong rapi mengikuti bentuk kotaknya. Label seperti "BARU" di atas foto tetap tampil, jadi biarkan bagian itu ada.

Ukuran foto

• Lebar sekitar 1200–1600 piksel sudah cukup.
• Usahakan setiap foto di bawah 300 KB, supaya website cepat dibuka di HP. Kecilkan gratis di squoosh.app.
• Foto HP biasanya 3–5 MB. Selalu kecilkan dulu.
• Foto kamar dari sudut pintu supaya seluruh ruangan terlihat, dengan lampu menyala dan kasur rapi. Tampilkan juga kamar mandi, dapur, dan tampak depan.

7. Dua bahasa

Template ini tampil dalam bahasa Indonesia dan Inggris. Setiap teks ditulis dua kali, berdampingan:

<span lang="id">Layanan</span><span lang="en">Services</span>

Hanya bahasa yang aktif yang tampil. Ganti keduanya setiap kali mengubah teks. Jangan mengubah tanda lang="id" dan lang="en".

Bahasa awal dan tombol ID/EN

• Bahasa awal diatur di baris <html lang="id"> di bagian atas file. Ganti menjadi <html lang="en"> agar pengunjung baru melihat bahasa Inggris.
• Tombol ID/EN di navigasi diatur dengan tombolBahasa: true di PENGATURAN. Pilihan pengunjung diingat di browser mereka.
• Link langsung: tambahkan ?lang=en di akhir alamat (misalnya namausaha.com/?lang=en) untuk membuka versi Inggris. Berguna untuk profil media sosial atau penawaran ke klien luar negeri.

Hanya butuh satu bahasa?

Atur tombolBahasa: false dan pilih bahasanya di <html lang="...">. Teks bahasa lain tetap ada di file tetapi tidak pernah tampil, jadi kamu cukup mengganti teks bahasa yang dipakai.

Teks di dalam atribut

Beberapa teks tidak terlihat langsung di halaman, jadi versi Inggrisnya ditulis sebagai atribut tambahan berawalan data-en:

Harga kamar ditulis satu kali sebagai angka di data-harga, lalu ditampilkan sesuai bahasa: Rp1.200.000 dalam bahasa Indonesia dan IDR 1,200,000 dalam bahasa Inggris. Mata uangnya diatur di PENGATURAN (mataUang: 'IDR'), lihat Kalkulator sewa dan deposit. Nama tipe kamar dalam bahasa Inggris ada di data-en-nama.

8. Halaman, tampilan, dan tema gelap

Menu di atas tidak hanya menggulir: setiap menu membuka halaman sendiri, dengan link sendiri dan transisi yang halus. Semuanya tetap satu file index.html.

Cara halaman dibentuk

• Setiap link di menu atas, misalnya <a href="#fasilitas">, menjadi satu halaman berisi bagian dengan id itu.
• Bagian yang tidak ada di menu ikut ke halaman sebelumnya. Semua yang ada sebelum bagian menu pertama adalah halaman Beranda.
• Beranda menampilkan kartu ke setiap halaman (Jelajahi), dan setiap halaman ditutup kartu Selanjutnya. Keduanya dibuat otomatis dari menu dan judul <h2> setiap bagian.
• Setiap halaman punya alamat sendiri, misalnya usahamu.com/#fasilitas. Bagikan di media sosial atau WhatsApp untuk langsung membuka halaman itu.

Menambah atau menghapus halaman

1. Menambah: beri bagian sebuah id (huruf kecil, tanpa spasi), lalu tambahkan link-nya di menu: <a href="#idmu">Nama</a>.
2. Menghapus: hapus link-nya dari menu (bagiannya ikut halaman sebelumnya), atau hapus bagian beserta link-nya.

Satu halaman panjang saja

Isi halamanTerpisah: false di PENGATURAN. Menu kembali menggulir satu halaman panjang.

Tema terang dan gelap

• Tema awal diatur di baris pertama halaman: <html lang="id" data-tema="otomatis">. Pilih otomatis (ikut pengaturan HP/komputer pengunjung), terang, atau gelap.
• Tombol matahari/bulan membuat pengunjung bisa mengganti tema, dan pilihannya diingat. Sembunyikan dengan tombolTema: false di PENGATURAN; halaman lalu selalu memakai tema awal.
• Warnamu (--utama) berlaku di kedua tema. Warna tema gelap ada di blok CSS bertanda Tema gelap / Dark theme, di dekat akhir bagian gaya.

Glass theme (glassmorphism) dan animasi

Kartu transparan bergaya frosted glass, warna latar yang bergerak pelan, dan animasinya ada di blok CSS bertanda KACA (nama kode untuk glass theme). Tidak ada yang perlu diubah di sana. Dua nilai yang boleh kamu atur, di awal blok itu:

Pengunjung yang menyalakan Kurangi gerakan di perangkatnya tetap mendapat halaman dan tema yang sama, tanpa animasi.

9. Tipe kamar dan harga

Setiap tipe adalah satu blok <article class="tipe">. Bagian yang perlu kamu ubah ada di tag pembukanya:

<article class="tipe" data-kode="a" data-harga="1200000" data-nama="Kamar Standar" data-en-nama="Standard Room">

• data-harga: harga per bulan, angka saja. Tulisan "Rp1.200.000/bulan" di kartu dan angka di kalkulator otomatis dibuat dari nilai ini, jadi cukup ubah di sini.
• data-nama dan data-en-nama: nama tipe dalam kedua bahasa. Ini yang muncul di kalkulator dan pesan WhatsApp. Samakan dengan tulisan di <h3>.
• data-kode: penanda internal, boleh diisi bebas tetapi tiap tipe berbeda.

Tulisan harga yang ada di dalam <span class="harga"> hanya cadangan bila JavaScript pengunjung mati. Sebaiknya samakan juga dengan data-harga, tetapi yang tampil biasanya sudah otomatis mengikuti.

Status tersedia atau penuh

Ada dua tempat: tambahkan kata penuh pada class kartu (class="tipe penuh"), dan ubah label di foto:

<span class="status-unit habis">...Penuh...Taken...</span>         (untuk penuh)
<span class="status-unit ada">...Tersedia...Available...</span>  (untuk tersedia)

Tipe yang penuh tampil pudar, dan tombol "Tanya" tetap ada supaya calon penghuni bisa masuk daftar tunggu.

Menambah atau menghapus tipe

Salin satu blok utuh untuk menambah, hapus untuk mengurangi. Tiga tipe paling rapi di layar lebar. Setelah mengubah tipe, ubah juga pilihan di formulir survei.

10. Kalkulator sewa dan deposit

Kalkulator otomatis: ia membaca semua data-harga, membuat daftar pilihan tipe, lalu menghitung sewa, deposit, dan total di awal. Hasilnya bisa dikirim ke WhatsApp dengan satu klik.

Yang kamu atur di PENGATURAN:

depositBulan: 1,
mataUang: 'IDR'

• depositBulan adalah deposit dalam jumlah bulan sewa. 1 berarti sebesar satu bulan sewa, 2 dua bulan, 0 tanpa deposit.
• mataUang adalah mata uang semua harga di data-harga: 'IDR' untuk rupiah, atau kode lain seperti 'USD', 'SGD', 'EUR'. Format tampilan (simbol, titik, dan koma) mengikuti bahasa secara otomatis.
• Pilihan lama sewa (1, 3, 6, 12 bulan) diubah di baris <option> pada <select id="k-durasi">. Nilai value adalah jumlah bulannya, dan teks Inggrisnya ada di data-en.
• Tidak ingin memakai kalkulator? Hapus seluruh bagian KALKULATOR dan menu href="#hitung".

11. Jumlah kamar kosong

Badge di bagian pembuka diatur dari PENGATURAN:

kamarKosong: 3,

• Angka lebih dari 0 menampilkan titik hijau "3 kamar masih tersedia".
• 0 menampilkan titik merah "Kamar penuh saat ini · tanya daftar tunggu".

Ingat memperbarui angka ini bersama status di setiap kartu kamar. Keduanya ditulis terpisah.

12. Lokasi, jarak, aturan & fasilitas

• Jarak: setiap baris <li> berisi nama tempat dan jaraknya. Tulis waktu tempuh ("5 menit") yang mudah dibayangkan. Tambah atau hapus baris sesukamu.
• Aturan kos: setiap aturan adalah satu <li>. Tulis aturan yang benar-benar berlaku, karena aturan yang jelas mencegah masalah di kemudian hari.
• Fasilitas: enam blok <div class="fasilitas">. Ganti nama dan keterangannya. Ikon tidak perlu diganti.
• Google Maps: cari google.com/maps/search dan ganti bagian setelah query= dengan nama kos atau alamatmu (spasi menjadi %20). Cara yang lebih tepat: buka kosmu di Google Maps → Bagikan → Salin link, lalu tempel sebagai pengganti seluruh isi href="...".

13. Formulir survei

Formulir mengirim satu pesan WhatsApp berisi nama, tipe kamar, tanggal survei, rencana mulai tinggal, dan lama sewa.

Pilihan tipe kamar di formulir ditulis terpisah dari kartu kamar. Setiap kali kamu mengubah tipe, ubah juga pilihannya. Cari data-label="Tipe kamar", lalu edit baris <option> (nama Inggrisnya di data-en="..."). Tanggal tidak bisa dipilih di masa lalu.

Ubah kalimat pembuka pesan di data-wa-form="..." pada tag <form>. Formulir tidak menyimpan data di mana pun, jadi catat calon penghuni dari WhatsApp-mu.

14. Mengganti warna

Di bagian atas file, cari :root. Ubah dua baris ini dengan kode warna logomu:

--utama: #0e7490;
--utama-gelap: #155e75;

--utama-gelap adalah versi yang sedikit lebih gelap, dipakai saat tombol disentuh. Cari kode warna di Google: color picker. Hindari warna yang terlalu terang untuk --utama, karena teks putih di atasnya sulit dibaca.

Pilihan warna siap pakai

Di halaman demo ada tombol "Coba warna" untuk melihat tiap pilihan. Untuk memakainya, ganti dua baris di :root dengan salah satu pasangan ini:

15. Mempublikasikan website

Sebelum mempublikasikan, lewati dulu daftar cek di bawah.

Pilihan A: Netlify (gratis, paling mudah)

1. Daftar akun gratis di netlify.com.
2. Buka app.netlify.com/drop.
3. Seret seluruh folder template (yang berisi index.html dan folder foto) ke halaman itu.
4. Tunggu beberapa detik. Website-mu langsung online dengan alamat seperti nama-acak.netlify.app. Nama itu bisa kamu ubah di pengaturan situs.

Untuk memperbarui website nanti, seret lagi foldernya di halaman situs tersebut di Netlify (bagian Deploys).

Pilihan B: hosting berbayar dengan cPanel

1. Masuk ke cPanel hosting-mu → File Manager → buka folder public_html.
2. Klik Upload, lalu upload index.html dan folder foto beserta isinya. (Bisa juga upload sebagai ZIP, lalu klik kanan → Extract.)
3. Buka nama domainmu di browser.

PANDUAN.html dan LISENSI.txt tidak perlu di-upload.

Pilihan C: GitHub Pages (gratis)

Cocok kalau kamu sudah punya akun GitHub. Buat repositori publik, upload index.html dan folder foto, lalu di Settings → Pages pilih branch main dan folder / (root).

Memakai domain sendiri

Domain .com, .id, atau .my.id bisa dibeli di penyedia domain mana pun. Di Netlify, buka pengaturan situs → Domain management dan ikuti petunjuknya. Di hosting cPanel, domain biasanya sudah terpasang saat membeli paket.

16. Tampilan saat link dibagikan

Saat link website-mu dibagikan di WhatsApp atau media sosial, yang tampil adalah judul dan deskripsi dari og:title dan og:description di bagian atas file. Ganti keduanya.

Untuk menampilkan gambar juga, siapkan satu foto berukuran sekitar 1200 × 630 piksel, simpan di folder foto, lalu tambahkan baris ini tepat di bawah og:description. Alamatnya harus lengkap, termasuk domainmu:

<meta property="og:image" content="https://domainmu.com/foto/sampul.jpg" />

17. Daftar cek sebelum publikasi

Buka website-mu di browser, lalu periksa satu per satu:

• Nomor WhatsApp sudah diisi dan tombol membuka WhatsApp yang benar.
• Tidak ada lagi nama, alamat, harga, atau rekening contoh.
• Semua foto muncul (tidak ada kotak berikon yang tertinggal).
• Kedua bahasa sudah diganti: klik tombol EN dan periksa tidak ada teks contoh berbahasa Inggris yang tertinggal (atau tombol bahasa sudah dimatikan).
• Harga di setiap kartu kamar benar, dan kalkulator menghasilkan angka yang sama dengan harga di kartu.
• Status setiap tipe (tersedia atau penuh) dan kamarKosong sesuai kenyataan.
• Deposit di PENGATURAN sesuai kebijakanmu.
• Aturan kos dan jarak ke tempat penting sudah benar.
• Pilihan tipe kamar di formulir survei sama dengan daftar tipe.
• Kirim satu formulir survei percobaan ke dirimu sendiri dan pastikan pesannya utuh.
• Judul tab browser dan og:title sudah diganti.
• Sudah dicoba dari HP, bukan hanya dari komputer.
• Sudah dicoba dengan meng-klik semua tombol sekali.

18. Jika ada masalah

Mau kami yang pasangkan?

Kalau nggak sempat mengedit sendiri, ada Jasa Pasang + Editing (dibeli terpisah): kami edit template ini sesuai permintaanmu, lalu meng-online-kannya di Netlify paket gratis, di akun atas namamu. Cari Jasa Pasang Website atau Website Setup Service di toko UpVire tempat kamu membeli template ini (Lynk.id, Gumroad, atau Etsy).

Pertanyaan tentang pembelian dan pengunduhan dapat diajukan melalui halaman produk di platform tempat kamu membeli.