Menyelesaikan Ralat Sintaks Theme.liquid dan

Panduan mendalam membaiki ralat sintaks Liquid, tag template tidak tertutup, masalah penapis JSON | json, dan kerosakan skema tema Online Store 2.0.

Menyelesaikan Ralat Sintaks Theme.liquid dan Kegagalan Penapis JSON di Shopify

Ralat sintaks dalam fail theme.liquid atau skema JSON tema Online Store 2.0 boleh menyebabkan laman web anda memaparkan skrin kosong putih (White Screen of Death) atau mesej ralat kritikal seperti Liquid error: syntax error dan JSON parse error.

Langkah 1: Analisis Log dan Lokasi Ralat

Ralat biasanya berpunca daripada:

Tag Liquid yang tidak ditutup dengan betul (cth. {% if %} tanpa {% endif %}).
Penggunaan penapis | json pada objek kitaran (circular references) atau struktur data yang mengandungi aksara khas tanpa sanitasi.
Koma berlebihan (trailing commas) dalam fail konfigurasi templates/*.json atau locales/en.default.json.

Gunakan alatan Shopify CLI untuk memeriksa tema:

# Imbas keseluruhan tema untuk ralat sintaks dan skema
shopify theme check

Langkah 2: Membetulkan Ralat Penapis JSON dan Struktur Liquid

Pastikan sebarang data objek yang ditukar kepada format JSON melalui penapis Liquid dibersihkan dengan selamat sebelum dimasukkan ke dalam blok skrip:

{% comment %} Kaedah selamat menyuntik data produk ke dalam JavaScript {% endcomment %}
<script type="application/json" id="product-json-data">
  {{ product | json }}
</script>

<script>
  try {
    const rawData = document.getElementById('product-json-data').textContent;
    const productData = JSON.parse(rawData);
    console.log("Data produk berjaya dimuatkan:", productData.title);
  } catch (err) {
    console.error("Gagal membaca struktur JSON:", err);
  }
</script>

Langkah 3: Pulihkan Versi Fail Melalui Sejarah Tema (Rollback)

Jika ralat berlaku selepas membuat suntingan kod secara manual:

Dalam Shopify Admin, pergi ke Online Store > Themes > Actions > Edit Code.
Buka fail yang bermasalah (cth. layout/theme.liquid).
Klik Older versions di bahagian atas fail dan pilih versi sandaran sebelum pengubahsuaian dibuat.
Klik Save untuk memulihkan paparan kedai dengan serta-merta.

Elakkan Masa Henti (Downtime) yang Merugikan Kedai Anda

Satu kesilapan kecil dalam kod tema boleh menghentikan transaksi pelanggan beribu-ribu ringgit.

JagaWeb menyediakan penyelenggaraan kod sumber, sandaran berkala, dan semakan kualiti sebelum sebarang perubahan dimuat naik ke pelayan pengeluaran.

RM5,000 untuk Semakan Pemilikan & Akses kod sumber.
RM450/bulan untuk Pelan Penjagaan teknikal.

Tempah Semakan Pemilikan & Akses RM5,000 anda hari ini dan pastikan kedai anda bebas daripada sebarang ralat sintaks.