Widget peta untuk Shopify
Muat turun satu fail, tampalkannya ke dalam folder Sections tema anda, dan “WhatIsMyLocation Map” akan muncul dalam editor tema anda bersama panel tetapan asli — cawangan sebagai blok, pemilih tema dan penanda, panel lokasi dengan animasi pertukaran, serta ikon buka-dalam-peta yang boleh dipilih. Tiada apl untuk dipasang, tiada kunci API, tiada akaun bil, tiada kuki, dan tiada apa-apa dimuatkan daripada Google. Fail zip itu turut mengandungi seksyen kedua untuk widget cari-lokasi-saya.
Berasaskan kebenaran · Peribadi · Berfungsi pada Chrome, Safari, Firefox, Edge
Kenapa seksyen tema lebih baik daripada apl Shopify
Kebanyakan senarai “apl peta” mahukan pemasangan, kebenaran untuk data kedai anda, dan yuran bulanan — untuk sesuatu yang akhirnya hanyalah satu iframe. Inilah alternatif yang jujur: satu fail Liquid yang duduk dalam tema anda sendiri. Ia tidak meminta apa-apa kebenaran kedai, tidak menambah skrip pada halaman anda, tidak menghantar apa-apa balik, dan tidak berkos apa-apa. Satu-satunya permintaan luaran yang dibuat oleh pelawat anda ialah iframe peta bersandbox daripada whatismylocation.ai dan jubin OpenStreetMap-nya — tiada kuki Google, tiada beban sepanduk kebenaran, dan jika perkhidmatan itu tidak dapat dicapai, iframe gagal secara senyap tanpa merosakkan halaman anda. Padamkan fail seksyen itu dan setiap jejaknya hilang.
Muat turun whatismylocation-shopify-sections.zip — kedua-dua seksyen berserta README, beberapa kilobait sahaja. Kemudian ikut langkah pemasangan di bawah.
Pasang dalam kira-kira dua minit
Dua bahagian: tampal fail itu sekali, kemudian gunakannya seperti mana-mana seksyen terbina dalam.
Tampal fail: admin Shopify ▸ Kedai Dalam Talian ▸ Tema ▸ ⋯ ▸ Edit kod. Pada bar sisi kiri di bawah Sections klik Tambah seksyen baharu, namakannya whatismylocation-map, padamkan kandungan pemegang tempat, dan tampal seluruh kandungan whatismylocation-map.liquid — blok {% schema %} di bahagian bawah itulah yang membina panel tetapan anda, jadi ia mesti disertakan. Simpan.
Gunakannya: buka editor tema (Sesuaikan), pergi ke halaman hubungi anda (atau mana-mana halaman), tekan Tambah seksyen, dan pilih WhatIsMyLocation Map. Panel tetapan muncul di sebelah kiri; selagi anda belum memasukkan koordinat, seksyen itu memaparkan pemegang tempat mesra yang memberitahu anda apa yang diperlukan.
Dapatkan koordinat daripada pembina benaman peta — taip alamat anda, kemudian seret pin ke pintu masuk anda sebelum menyalinnya. Seksyen ini menghantar koordinat akhir anda, jadi pin itu tidak akan terpesong selepas ini.
Cawangan ialah blok
Kedai berbilang lokasi mendapat bahagian terbaik: dalam editor tema, setiap cawangan ialah satu blok — tekan Tambah cawangan, isikan latitud, longitud, label dan alamat, dan susun semula dengan menyeretnya (sehingga 10). Peta muat automatik pada setiap cawangan, pin dinomborkan supaya sepadan dengan senarai, dan pelawat mendapat panel lokasi — sebuah akordion di sebelah peta pada desktop, dan jalur kad boleh leret pada telefon, lengkap dengan arah bagi setiap cawangan serta ikon pilihan “Buka dalam Google Maps / Apple Maps”. Susun atur panel (auto, side, bottom, none) dan animasi pertukaran (smooth, fade, lively, none — pelawat dengan tetapan kurangkan gerakan sentiasa mendapat versi serta-merta) ialah menu juntai bawah dalam panel yang sama.
Setiap tetapan, dipetakan
| Tetapan | Apa yang pelawat lihat |
|---|---|
| Nama perniagaan + gaya tajuk | Tajuk kad/panel — tebal secara lalai; italik dan biasa juga ditawarkan. |
| Baris alamat 1–3 + gaya setiap baris | Sehingga tiga baris pada kad tindanan, setiap satu boleh dijadikan tebal atau italik. |
| Latitud / longitud | Pin anda. Tampal daripada pembina; tidak pernah digeokod semula. |
| Blok cawangan | Pin bernombor + panel lokasi (bermula daripada 2 cawangan). |
| Tema | Rangka widget cerah, gelap atau keemasan. |
| Warna penanda | Pin biru klasik, zamrud, merah, ambar, indigo atau kelabu batu. |
| Panel + gerakan | Susun atur panel lokasi dan animasi pertukaran cawangan. |
| Dapatkan arah / ikon peta | Butang arah serta pautan ikon Google/Apple Maps pilihan dengan tooltip. |
| Tinggi | Tinggi iframe, 220–800 px. |
| Kapsyen “Powered by” | Mati secara lalai — tandakan untuk memberi kredit kepada perkhidmatan ini di bawah peta. |
Fail zip yang sama turut mengandungi whatismylocation-widget.liquid — widget cari-lokasi-saya sebagai seksyen kedua (tema, mod padat/penuh, tinggi), untuk halaman penghantaran dan pencari kedai.
Penyelesaian masalah
Seksyen tidak muncul di bawah Tambah seksyen. Fail itu mesti berada dalam Sections (bukan Snippets atau Assets) dan tampalan mesti merangkumi keseluruhan fail — jika blok {% schema %} terpotong, Shopify akan menolak atau menyembunyikan seksyen itu. Tampal semula seluruh fail dan simpan.
Ralat “Invalid schema” semasa menyimpan. Tampalan yang tidak lengkap — selalunya kurang satu kurungan penutup kerana memilih sehingga bawah tetapi tertinggal satu baris. Tampal semula fail yang lengkap; jangan edit skema secara manual melainkan anda tahu Liquid.
Peta kelihatan kelabu. Jubin peta datang daripada tile.openstreetmap.org; penyekat iklan yang agresif atau rangkaian korporat boleh menyekatnya. Cuba pada telefon menggunakan data mudah alih — pelanggan anda hampir pasti melihatnya dengan baik.
Pin tidak berada di pintu saya. Bina semula koordinat di pembina, seret pin ke pintu masuk anda, dan tampal nilai baharu itu ke dalam tetapan seksyen.
Suntingan tidak kelihatan di kedai langsung. Anda menyunting tema draf atau tema yang belum diterbitkan — buat perubahan pada tema yang diterbitkan (atau terbitkan tema yang anda sunting). Widget itu sendiri tiada apa-apa untuk dicache.
Langkah demi langkah
- Muat turun whatismylocation-shopify-sections.zip (pautan di bawah) dan nyahzipkannya.
- Dalam admin Shopify, buka Online Store ▸ Themes ▸ ⋯ ▸ Edit code. Di bawah Sections, tekan “Add a new section”, namakannya whatismylocation-map, dan tampalkan SELURUH kandungan whatismylocation-map.liquid — termasuk blok schema di bahagian bawah. Save.
- Buka editor tema (Customize), pergi ke halaman yang memerlukan peta, tekan Add section, dan pilih “WhatIsMyLocation Map”.
- Tampalkan koordinat tepat anda daripada map-embed builder (taip alamat anda, kemudian seret pin ke pintu masuk anda sebelum menyalinnya) — atau tekan “Add branch” sekali bagi setiap lokasi untuk peta pelbagai cawangan.
- Pilih tema, warna penanda, susun atur panel dan pergerakan dalam panel tetapan, kemudian Save. Tiada apl, tiada kunci API, tiada apa perlu dikonfigurasi di bahagian pelayan.
Soalan lazim
Perlukah saya apl atau kunci API untuk peta ini?
Bolehkah saya paparkan beberapa cawangan?
Lihat dalam bahasa Inggeris: Map Widget for Shopify · Bahasa Melayu