Cara Mengatur Sale Countdown Timer di WooCommerce (LarisTurbo)

Panduan lengkap Sale Countdown Timer For WooCommerce: scheduled vs evergreen countdown, durasi dan cooldown, posisi di halaman produk, shortcode, block theme, dan produk variabel.

Sale Countdown Timer For WooCommerce menampilkan hitung mundur di halaman produk untuk menambah urgensi saat promo dan mendorong pembelian sebelum penawaran berakhir. Timer bisa mengikuti tanggal akhir diskon WooCommerce (scheduled sale) atau berjalan sebagai evergreen countdown yang dihitung per pengunjung.

Fitur ini cocok untuk flash sale dengan tanggal pasti, maupun toko yang ingin efek urgensi tanpa perlu mengatur jadwal diskon di setiap produk. Tutorial ini membahas tipe countdown yang tersedia, opsi di Settings, cara penempatan manual dengan shortcode/block, dan catatan penting untuk produk variabel.

Yang akan tampil di toko

Di halaman produk tunggal, pengunjung melihat:

Teks sebelum timer (default Indonesia: Flash Sale Berakhir Dalam)
Angka hitung mundur format HH:MM:SS (hari ditampilkan jika relevan)
Teks setelah timer (opsional, jika Anda mengisinya)

Timer hanya muncul jika kondisi tipe countdown terpenuhi (produk sedang diskon, punya tanggal akhir sale, atau mode evergreen-all).

Prasyarat

LarisTurbo For WooCommerce by TokoPressID terpasang, lisensi aktif
WooCommerce aktif
Untuk mode Scheduled Sale Countdown: produk punya harga diskon dan tanggal akhir sale di tab General produk (field Sale price dates to)
Untuk mode evergreen: produk sedang on sale (kecuali Evergreen Countdown for All Products)

Cara membuka pengaturan

Login ke WordPress Admin
Buka LarisTurbo → For WooCommerce
Cari Sale Countdown Timer For WooCommerce, klik Settings

Opsi detail di bawah muncul setelah Enable Sale Countdown Timer dicentang.

Opsi yang tersedia

Aktivasi dan tipe countdown

Label di plugin	Jenis	Fungsi
Enable Sale Countdown Timer	Checkbox	Menyalakan atau mematikan fitur
Countdown Type	Radio	Memilih cara timer dihitung (lihat tabel di bawah)
Evergreen Duration	Angka	Durasi timer evergreen per kunjungan (default 12 jam). Hanya tampil jika tipe evergreen
Evergreen Cooldown	Angka	Jeda setelah timer habis sebelum muncul lagi (default 30 menit). Hanya tampil jika tipe evergreen
Text Before	Teks	Kalimat di atas angka timer. Kosong = default locale (ID: `Flash Sale Berakhir Dalam`)
Text After	Teks	Kalimat di bawah timer (opsional)

Countdown Type — pilih salah satu:

Nilai	Label di plugin	Kapan timer muncul
`scheduled`	Scheduled Sale Countdown	Hanya produk dengan tanggal akhir diskon WooCommerce (`_sale_price_dates_to`)
`evergreen`	Evergreen Sale Countdown	Hanya produk yang sedang on sale
`evergreen-all`	Evergreen Countdown for All Products	Semua produk, diskon atau tidak

Evergreen Duration dan Evergreen Cooldown:

Durasi diukur dalam jam per timer (label: Hours / Timer)
Cooldown diukur dalam menit (label: Minutes / Cooldown)
Setiap pengunjung mendapat siklus timer sendiri (disimpan di cookie browser, prefix lt_countdown_)
Plugin mengurangi durasi dengan offset acak 1–300 detik agar waktu terlihat lebih natural
Setelah timer habis, countdown disembunyikan selama cooldown, lalu siklus baru dimulai

Posisi di halaman produk

Bagian Sale Countdown Timer Position in Single Product Page:

Label	Nilai	Posisi
Position	Before Add to Cart Button	Sebelum tombol Add to Cart (hook `woocommerce_before_add_to_cart_form:4`). Tersembunyi jika tombol ATC disembunyikan
	After Add to Cart Button	Setelah tombol Add to Cart (hook `woocommerce_after_add_to_cart_form:6`)
	Before Add to Cart Section	Sebelum section ATC di summary (hook `woocommerce_single_product_summary:22`). Tetap tampil meski tombol ATC disembunyikan tema
	After Add to Cart Section	Setelah section ATC (hook `woocommerce_single_product_summary:33`)
	Manual Placement	Tidak otomatis; pakai shortcode atau block

Shortcode:

[laristurbo_wc_sale_countdown] — di dalam product loop (halaman produk tunggal)
[laristurbo_wc_sale_countdown product_id="123"] — di mana saja dengan ID produk tertentu

Block editor (block theme): Sale Countdown Timer For WooCommerce (LarisTurbo) — letakkan di template produk WooCommerce.

Produk variabel (scheduled)

Label	Fungsi
Disable for Variable Products with Scheduled Sale Variations	Mematikan countdown otomatis di posisi hook untuk produk variabel yang pakai jadwal diskon per-variasi

Penting untuk scheduled + variabel:

Countdown tidak muncul di posisi hook standar untuk produk variable (parent)
Untuk variasi dengan diskon terjadwal, timer muncul menggantikan/menempel pada output stok saat variasi dipilih (filter woocommerce_get_stock_html)
Shortcode dan block tidak didukung untuk scheduled sale tingkat variasi — hanya penempatan via stok HTML

Custom Styles

Label	Fungsi
Alignment	Kiri, tengah, atau kanan
Text Color	Warna teks label
Countdown Timer Color	Warna angka timer
Margin (px)	Jarak luar (atas/kanan/bawah/kiri)

Pengaturan ini bisa ditimpa oleh block di editor saat Anda memakai block theme.

Langkah konfigurasi umum

Scheduled sale (diskon dengan tanggal akhir)

Centang Enable Sale Countdown Timer
Pilih Countdown Type → Scheduled Sale Countdown
Di produk WooCommerce, set Sale price dan Sale price dates to (wajib ada tanggal akhir)
Pilih Position (misalnya Before Add to Cart Section)
Sesuaikan Text Before jika perlu, lalu simpan
Buka halaman produk di frontend — timer harus menghitung mundur ke tanggal akhir sale

Evergreen (urgensi per pengunjung)

Centang Enable Sale Countdown Timer
Pilih Evergreen Sale Countdown atau Evergreen Countdown for All Products
Atur Evergreen Duration (misalnya 12 jam) dan Evergreen Cooldown (misalnya 30 menit)
Pastikan produk memenuhi syarat on sale (kecuali mode all products)
Simpan dan uji di browser incognito — timer mulai dari durasi yang Anda set

Manual placement (tema block atau layout kustom)

Set Position → Manual Placement
Sisipkan [laristurbo_wc_sale_countdown] di template/deskripsi produk, atau tambahkan block Sale Countdown Timer For WooCommerce (LarisTurbo) di Single Product template
Untuk menampilkan produk lain di halaman landing: [laristurbo_wc_sale_countdown product_id="456"]

Verifikasi

Buka halaman produk yang memenuhi syarat tipe countdown yang dipilih
Pastikan angka timer bergerak setiap detik (script ltWcSaleCountdownOptions dimuat di footer)
Untuk scheduled: ubah tanggal akhir sale di admin, refresh — waktu mundur harus mengikuti
Untuk evergreen: buka produk di dua browser berbeda — masing-masing bisa punya sisa waktu berbeda
Untuk produk variabel + scheduled: pilih variasi yang sedang diskon — timer muncul di area stok

Troubleshooting

Gejala	Kemungkinan penyebab	Solusi
Timer tidak muncul sama sekali	Fitur belum diaktifkan	Centang Enable Sale Countdown Timer dan simpan
Scheduled tidak tampil	Produk tidak punya tanggal akhir sale	Isi Sale price dates to di produk, atau produk tidak on sale
Scheduled tidak tampil di produk variabel (parent)	Perilaku normal	Timer scheduled untuk variable parent tidak di hook; pilih variasi diskon atau gunakan evergreen
Evergreen tidak tampil	Produk tidak on sale	Aktifkan diskon produk, atau pilih Evergreen Countdown for All Products
Timer hilang lalu muncul lagi	Cooldown evergreen	Tunggu Evergreen Cooldown menit, atau uji di session/cookie baru
Posisi salah atau tidak kelihatan	Tema menyembunyikan hook ATC	Coba Before/After Add to Cart Section, atau Manual Placement
Shortcode kosong di luar halaman produk	Tanpa `product_id` di luar loop	Pakai `[laristurbo_wc_sale_countdown product_id="ID"]`
Style tidak berubah	Block theme menimpa global style	Atur warna/margin di panel block, bukan hanya di Settings global

Ringkasan

Scheduled = ikuti jadwal diskon WooCommerce (wajib tanggal akhir)
Evergreen = timer per pengunjung dengan durasi + cooldown
Posisi otomatis lewat Position, atau manual lewat shortcode/block
Produk variabel + scheduled punya aturan khusus (timer di output stok variasi)