EN

Tanya-jawab & dukungan

Jawaban atas pertanyaan yang paling sering diajukan pembeli, dan cara menghubungi kami bila ada yang tidak berjalan.

Persiapan & perakitan

Apakah saya butuh server atau Node.js?

Untuk memakai halamannya, tidak. Setiap halaman adalah berkas .html yang sudah jadi: klik dua kali index.html dan halaman terbuka di browser, tanpa server. Untuk menayangkan template secara online, unggah halaman hasil rakitan, folder id/, dan folder assets/ ke hosting web statis mana pun.

Node.js 18 atau lebih baru hanya diperlukan bila Anda menyunting sumber dan merakit ulang dengan node build.mjs. Perakitan tidak punya dependensi, jadi tidak ada yang perlu dipasang. Pembantu terjemahan di tools/i18n/ memerlukan Python 3.

Kenapa perubahan saya hilang setelah dirakit?

Karena yang Anda sunting adalah halaman hasil rakitan. Berkas .html di folder template dan di id/ disusun oleh node build.mjs, dan setiap perakitan menimpanya. Lakukan perubahan di sumbernya:

  • Isi halaman: src/pages/.
  • Sidebar, bilah atas, dan bagian bersama lainnya: src/layout.html, berkas src/layout-*.html lainnya, dan src/partials/. Menu sidebar sendiri ada di daftar NAV di build.mjs.
  • CSS dan JavaScript di assets/ bukan hasil rakitan — sunting langsung. Satu-satunya pengecualian adalah assets/i18n/id.js, yang ditulis perakitan dari i18n/id.json.

Apakah halamannya butuh koneksi internet?

Tidak. Bootstrap, font ikon, ApexCharts, pustaka lainnya, dan font Plus Jakarta Sans semuanya sudah ada di assets/vendor/, jadi template berfungsi tanpa internet dan di intranet. Hanya tautan ke situs web pustaka di dokumentasi ini yang membuka internet. Lihat Pustaka & lisensi.

Memakainya di proyek Anda

Bisakah Selaras dipakai dengan React, Vue, Laravel, atau framework lain?

Bisa. Selaras adalah HTML, CSS, dan JavaScript biasa yang tidak bergantung pada framework, jadi cara umumnya sama di mana pun:

  • Ambil markup dari halaman hasil rakitan — tata letaknya sekali, lalu isi setiap halaman yang Anda perlukan — dan pindahkan ke template Anda (Blade, Twig, JSX, komponen Vue…).
  • Muat assets/css/selaras.css sesudah CSS Bootstrap. Semua kelasnya berawalan sl-, jadi jarang bertabrakan dengan kelas Anda sendiri.
  • Muat assets/js/selaras.js, ditambah hanya skrip yang tercantum di komentar meta halaman itu.

Skrip memasang perilakunya pada elemen yang sudah ada saat skrip berjalan. Ini cocok untuk halaman yang dirender di server. Di aplikasi satu halaman (SPA), yang komponennya muncul dan hilang belakangan, pakai CSS dan markup-nya, lalu buat ulang perilaku yang Anda perlukan di dalam komponen Anda.

Bagaimana cara mengganti logo dan nama?

  • Logo — lambangnya berupa simbol SVG dengan id sl-mark di src/partials/symbols.html; warnanya mengikuti tema aktif. Ganti bentuk di dalam simbol itu, atau ganti <svg> yang memakainya dengan gambar Anda sendiri.
  • Nama — sidebar di src/layout.html, kepala dan kaki halaman masuk di src/partials/auth-top.html dan auth-foot.html, serta akhiran judul tab browser “Selaras Admin” di src/partials/head.html.
  • Etalase toko — akhiran judul tab “Selaras Store” diatur di build.mjs dan kakinya di src/layout-store.html. Nama toko di kepala halaman berasal dari data toko di assets/js/ecommerce.js, dan bisa juga diubah di E-commerce › Pengaturan toko.

Lalu cari “Selaras” di src/ untuk menemukan sisa penyebutannya di konten demo, dan rakit ulang.

Bagaimana cara menghapus halaman atau aplikasi yang tidak dipakai?

  1. Hapus halamannya dari src/pages/.
  2. Buang entrinya dari NAV di build.mjs. Dengan begitu halaman itu hilang dari sidebar dan dari daftar halaman di halaman 404.
  3. Hapus skrip yang hanya dipakai halaman ini — skrip itu tercantum di "scripts" pada komentar metanya. Berkas data bersama seperti ecommerce.js, warehouse.js, pos.js, dan projects.js dimuat oleh beberapa halaman, jadi hapus hanya bersama semua halaman tersebut.
  4. Cari tautan ke halaman itu di src/ (misalnya kartu dasbor yang membuka sebuah aplikasi) dan buang.
  5. Rakit ulang, lalu hapus sendiri berkas hasil rakitan lamanya — page.html dan id/page.html. Perakitan tidak menghapus halaman yang dirakit sebelumnya.

Perilaku & tampilan

Data demo tidak kembali

Aplikasi menyimpan perubahan Anda di localStorage browser, jadi perubahan itu tetap ada setelah halaman dimuat ulang. Untuk mulai lagi:

  • Pakai Kembalikan data demo di bawah daftar aplikasi E-commerce, Faktur, Gudang, Proyek, dan Kasir, atau Kembalikan papan di papan Kanban. Kalender dan Chat tidak menyimpan apa pun; keduanya mulai dari awal setiap kali dibuka.
  • Atau hapus sendiri data tersimpannya. Semua kuncinya berawalan sl-, dan halaman Indonesia menambahkan @id di ujungnya. Di developer tools browser, buka Application › Local storage lalu hapus kunci-kunci itu, atau jalankan perintah ini di console — perintah ini juga mengembalikan pengaturan tema:
JavaScript
Object.keys(localStorage)
  .filter(function (k) { return k.indexOf('sl-') === 0; })
  .forEach(function (k) { localStorage.removeItem(k); });

Mode gelap tidak berlaku di komponen buatan saya

Mode gelap memasang data-sl-mode="dark" pada elemen <html> dan mendefinisikan ulang variabel warna. Komponen dengan warna tetap seperti #fff tidak ikut berubah. Pakai variabelnya, maka komponen Anda mengikuti setiap tema dan kedua mode:

CSS
.my-panel {
  background: var(--sl-surface);
  color: var(--sl-ink);
  border: 1px solid var(--sl-line);
}
/* only when a value really has to differ in dark mode */
[data-sl-mode="dark"] .my-panel { box-shadow: none; }

Lihat Tema & tampilan untuk cara tema dan mode gelap disusun.

Bisakah saya menambah bahasa lain?

Mengubah atau menambah terjemahan Indonesia cukup dengan menyunting kamus. Bahasa ketiga butuh perubahan di perakitan dan di skrip bersama — halaman Bahasa merinci apa saja yang perlu diubah.

Browser & aksesibilitas

Browser apa saja yang didukung?

Selaras dikembangkan dan diuji di Chrome dan Edge versi terkini. Template ini memakai CSS modern yang standar seperti color-mix(), jadi butuh browser yang mutakhir; Firefox dan Safari versi terkini mendukung fitur-fitur ini, tetapi tidak termasuk pengujian rutin kami. Internet Explorer tidak didukung.

Apakah template ini aksesibel?

Aksesibilitas ikut diperhatikan sejak perancangan, tetapi template ini belum melalui audit formal, jadi uji produk akhir Anda dengan pengguna dan alat Anda sendiri. Yang sudah tersedia:

  • Tema warna sudah diperiksa terhadap kontras WCAG AA di mode terang dan gelap, dengan setiap gaya sidebar.
  • Tanda fokus yang terlihat bagi pengguna keyboard, dan alternatif keyboard untuk seret-lepas di papan Kanban.
  • Label untuk tombol yang hanya berisi ikon, dan live region yang mengumumkan perubahan, misalnya item yang tersimpan atau jumlah hasil setelah pencarian.
  • Animasi dimatikan bila sistem operasi meminta gerakan dikurangi.

Dukungan

Dukungan diberikan lewat halaman toko tempat Anda membeli Selaras. Agar cepat terjawab, sertakan:

  • Versi Selaras yang Anda pakai — tertera di halaman Mulai cepat dan di baris atas assets/css/selaras.css.
  • Browser beserta versinya, dan sistem operasi Anda.
  • Halamannya, dan langkah-langkah yang memunculkan masalah.
  • Apa yang Anda harapkan dan apa yang justru terjadi, disertai tangkapan layar dan pesan galat dari console browser bila ada.
  • Apakah Anda mengubah sumbernya, dan berkas mana saja.

Kredit

Selaras dibangun di atas karya open-source, antara lain Bootstrap, Tabler Icons, dan ApexCharts, serta pustaka di halaman-halaman UI Kit. Halaman Ikon menampilkan ikon Font Awesome Free karya Fonticons, Inc., berlisensi CC BY 4.0. Berkas Font Awesome sudah memuat atribusinya di komentar kepala berkasnya sendiri, jadi biarkan komentar itu bila Anda meng-hosting berkasnya sendiri.

Setiap pustaka, versi, dan lisensinya tercantum di Pustaka & lisensi.