Shopify Liquid Geliştirici: Alman Pazarı Vitrin Satış Sitesi İçin Teknik Derinlik Rehberi

Alman pazarında çalışan bir Shopify Liquid Geliştirici aynı anda iki işi yapar: temiz, performanslı Liquid kodu yazar ve Alman ile AB hukuku uyarınca yasal olarak geçerli bir vitrin satış sitesi teslim eder. İkisinden birinde başarısız olursa, mağaza ya kötü dönüştürür ya da Abmahnung (resmi ihtar mektubu) almaya açık hale gelir. Bu rehber, teknik olarak ciddiye alan bir geliştirici veya tüccarın gerçekten ihtiyaç duyduğu derinlikte her iki katmanı kapsar.

Temel çıkarımlar

• Liquid, büyük çoğunluk Shopify mağazası için üretim şablonlama dilidir; Temmuz 2026 geliştirici önizlemesi sayfa bileşimini temel şekilde değiştiren {% block %} ve {% partial %} etiketlerini ekler.
• Alman pazarı, Liquid geliştiriciyi Impressum, DSGVO çerez onayı, Widerrufsbutton, KDV dahil fiyatlandırma ve yerel ödeme yöntemlerini yapılandırmaya gerektirir (bunlardan hiçbiri isteğe bağlı değildir).
• Ocak 2026'dan bu yana Shopify daha katı Liquid ayrıştırma kurallarını uygular; yeni tema ve uygulama gönderileri bu standartları karşılamalıdır.
• Section Rendering API ve yeni {% partial %} etiketi birlikte, istemci tarafı çerçeve olmadan sunucu tarafından işlenen kısmi sayfa güncellemelerine izin verir.
• Theme Check (artık Shopify CLI'ye 2026 araç zincirinin parçası olarak yerleşiktir) her dağıtımdan önce zorunlu bir lint geçişidir.

Alman mağazaları neden ayrı bir derleme hedefidir

Haziran 2026 itibarıyla, Almanya'da kaydedilmiş kabaca 121.343 aktif Shopify vitrin satış sitesi vardır, bu da onu Avrupa'daki en büyük Shopify pazarlarından biri yapar. Bu sayı büyüyor, ancak derleme gereksinimleri bir Liquid geliştiriciyi karşılaşmaya olacak neredeyse diğer her pazardan daha katı.

Alman tüketici hukuku GDPR'ın basit bir sarmalayıcısı değildir. Bir geliştiricinin hesaba katması gereken temel parçalar:

• Impressum: satıcıyı tanımlayan, tüm ticari Alman siteler için gerekli yasal açıklama sayfası.
• AGB (Allgemeine Geschäftsbedingungen): belirli zorunlu hükümler içeren genel şartlar ve koşullar.
• Widerrufsrecht: doğru şekilde ifade edilen Widerrufsbelehrung ile yasal 14 günlük geri çekilme hakkı.
• Widerrufsbutton: 19 Haziran 2026'dan bu yana, B2C uzaktan satış yapanlar, müşterinin 14 günlük geri çekilme hakkını birkaç tıkla ve onay ile kullanabilmesi için zorunlu bir elektronik geri çekilme düğmesi sağlamalıdır. İşletmenin nerede kayıtlı olduğu ne olursa olsun geçerlidir.
• DSGVO / GDPR: Alman eyalet düzeyinde veri koruma yetkililerinin uyguladığı katı çerez onayı yorumu.
• KDV dahil fiyatlandırma: tüm B2C fiyatları KDV'yi içermelidir. Net fiyatları göstermek ve ödeme sırasında vergi eklemek Alman hukuku ihlal eder.

Bunlardan hiçbiri isteğe bağlı değildir ve Alman tüketiciler ile rakippler resmi Abmahnungen aracılığıyla uygulamaya gerçekten isteklidir.

Ödeme tarafında, PayPal Almanya'da 30 milyondan fazla aktif hesapla çevrimiçi ödeme yönteminde hakim durumdadır. Klarna fatura ödemesi en çok beklenen ikinci seçenektir. Almanya'da yalnızca kredi kartı ödemesi sunmak, bir mağazaya ödeme sırasında potansiyel satışların yüzde 40 ila 50'sini kaybettirebilir.

Shopify Liquid Geliştiriciyi 2026'da gerçekten neyi bilmesi gerekir

Liquid temelleri: hala temel

Liquid, Shopify üzerine insan yapan herkes için hala en önemli teknik beceridir. Çoğu canlı mağazada ana sayfa, ürün ayrıntı sayfası, ürün listeleme sayfası, sepet ve sipariş durumu sayfaları Liquid'tir. Shopify dile yatırım yapmaya devam ediyor ve headless ile arasındaki boşluk her sürümle daralıyor.

Ocak 2026'dan bu yana Shopify, temalar ve tema uygulama uzantıları için daha katı Liquid ayrıştırma zorunlu tutuyor. Yeni tema ve uygulama gönderileri bu daha katı standartları karşılayan Liquid kodu kullanmalıdır ve Shopify bazı mevcut temalar için otomatik uyumluluk değişiklikleri getirmiştir. Bir geliştirici için bu "çalışıyor" artık yeterli değildir; kod geçerli olmalıdır.

Her taahhütün önüne pratik bir lint kurulumu:

# Theme Check, 2026 araç zinciri itibariyle Shopify CLI'ye yerleşiktir
shopify theme check --path ./theme

Theme Check, Liquid hatalarını, performans sorunlarını, geçersiz yapıları ve diğer sorunları bir tema dağıtılmadan önce yakalar. Yerel ve üretim arasında vazgeçilmez kapıdır.

Temmuz 2026 geliştirici önizlemesi: {% block %} ve {% partial %}

21 Temmuz 2026'da Shopify, Liquid Temmuz '26 geliştirici önizlemesini yayınladı ve dikkatle anlamaya değer. İki yeni etiket sunar:

{% block %} bir şablondan doğrudan yeniden kullanılabilir bir tema bloğunu işler. Bloğun adını verirsiniz, girdilerini geçirirsiniz ve gövde içeriği sağlarsınız, {% render %}'e benzer şekilde çalışır ancak snippet'leri dahil etmek yerine sayfa yapısını oluşturmak için tasarlanmıştır. Her {% block %}, blocks/ dizininden aynı adın dosyasını işler ve ona veri geçirir.

{% partial %} sunucu tarafından işlenen HTML'nin JavaScript'in tam sayfa yüklemesi olmadan yenileştirebileceği adlandırılmış bir bölgesini tanımlar. Bu yüzden bir kullanıcı bir koleksiyonu filtrelerse, yalnızca ürün ızgarası bölgesinin güncelleştirilmesi gerekir, tüm sayfa değil.

Birlikte, bu etiketler sayfaları Liquid'te oluşturmanıza ve istemci tarafı çerçevesine geçmeden dinamik vitrin satış sitesi etkileşimleri eklemenizi sağlar.

Bir koleksiyon sayfasında deseni gösteren minimal örnek:

{# templates/collection.liquid #}
{% block 'collection-hero' %}
  heading: collection.title
{% endblock %}

{% partial 'product-grid' %}
  {% for product in collection.products %}
    {% block 'product-card' %}
      product: product
    {% endblock %}
  {% endfor %}
{% endpartial %}

Müşteri sıralama veya filtreleme yaptığında, JavaScript yeni HTML getirir ve yalnızca product-grid kısmi bölgesini değiştirir. Liquid birinci modeli, sayfa yapısının JSON şablonları, bölüm tanımları ve Liquid snippet'lerine yayıldığı uzun süredir devam eden şikayeti giderir. Artık her şey bir dosyada yaşayabilir, bir geliştirici veya kodlama aracı tarafından bir bakışta okunabilir.

Önemli bir uyarı: bu hala bir geliştirici önizlemesidir. Etiketler, "Liquid Temmuz '26 değişiklikleri" özellik önizlemesi etkinleştirilmiş bir geliştirme mağazasında test için mevcuttur, ancak henüz canlı mağazalarda değildir ve etiket davranışı ile JavaScript yardımcıları genel kullanıma açılmadan önce değişebilir. Bölümleri, ayarları ve JSON şablonlarını kullanan mevcut temalar yeni model yanında tam olarak desteklenir.

Önizleme ayrıca söz dizimi hatalarını, aşırı karmaşıklığı, oversized dosyaları, geçersiz şema yapısını ve blok argümanları, şemalar ile {% doc %} bildirimleri arasındaki uyumsuzlukları yakalayan yeni Theme Check kuralları (v3.28.0) ile gelir.

Kısmi güncellemeler için Section Rendering API (üretim kararlı)

{% partial %} GA'ya ulaşana kadar, AJAX tabanlı kısmi sayfa güncellemeleri için üretim kararlı mekanizması Section Rendering API'dir. ?section_id=product-recommendations'ye bir fetch, yalnızca o bölümün HTML'sini döndürür, tam sayfa yüklemesi yoktur. Bu, mevcut Liquid temalar üzerindeki sepet çekmeceler, hızlı ekleme akışları ve tavsiye karouselileri için temeldir.

fetch(`${window.location.pathname}?section_id=product-recommendations`)
  .then(res => res.text())
  .then(html => {
    document.getElementById('recs').innerHTML =
      new DOMParser()
        .parseFromString(html, 'text/html')
        .getElementById('recs').innerHTML;
  });

Bu, JavaScript çerçevesine çekmeden, katalog ağır mağazalarda gerçek zamanlı tavsiyeler nasıl işlerim. Sunucu işi yapar, tarayıcı sadece HTML'yi değiştirir.

Metafield işleme

2025 ve 2026'da eklenen yeni Liquid filtreleri, bir metafield'ı türüne bağlı olarak uygun HTML öğesi olarak işleyen metafield_tag'i içerir. Alman Grundpreis (birim başına taban fiyat) gereksinimi için değeri bir ürün metafield'ında depolamak ve filtreyi kullanan işlemek, şablon başına koşullu mantık yazmaktan daha temizdir:

{{ product.metafields.de_compliance.grundpreis | metafield_tag }}

Tam tür listesi için metafield'lardaki Shopify Liquid sözlük girişi'ne bakın.

Karşılaştırma: Alman pazarı için Liquid tema yaklaşımları

Alman uyum Liquid kontrol listesi

Bunlar, uygulama yapılandırmasından ayrı olarak bir Liquid Geliştiriciyi sorumluluk alan şablon düzeyinde öğelerdir:

1. Impressum sayfası: tahmin edilebilir bir URL'de (/pages/impressum) bir Liquid sayfa şablonu aracılığıyla işle, footer navigasyonunda bağlantı ver. Bu içeriği asla yalnızca bir modal veya accordion içine koymayın.
2. Ürün şablonlarında KDV görüntüsü: product.price | money tarafından çıktı alan tüm fiyatlar Alman pazarları için vergiyi içermelidir. Shopify Markets kullanarak DE pazarı için vergi dahil fiyatlandırma yapılandırın; money filtresi bunu doğru şekilde yansıtır.
3. Ödeme düğmesi etiketi: Alman hukuku, ödeme gönder düğmesinin "Zahlungspflichtig bestellen" ("Ödeme yükümlülüğü ile sipariş ver") işlevsel olarak eşdeğer bir şey okumasını gerektirir. Shopify Plus mağazaları bunu checkout:payment:render-after uzantı noktasını hedefleyen bir Checkout UI Uzantısı aracılığıyla veya checkout.liquid geçersiz kılması kullanarak ayarlayabilir. Non-Plus mağazalar bunu Shopify'ın yerel ödeme ayarları aracılığıyla kontrol eder.
4. Widerrufsbutton entegrasyonu: 19 Haziran 2026'dan bu yana, geri çekilme düğmesi satın alma sonrası erişilebilir olmalıdır. Bu tipik olarak sipariş durumu sayfası şablonunda veya satın alma sonrası uzantısında yaşar.
5. DSGVO çerez onayı: Germanized çerez onayını işlemez. Ayrı bir sertifikalı rıza yönetim platformu (Cookiebot, Consentmo, Usercentrics) gereklidir. Rıza sinyali tüm pazarlama pikselleri harekete geçmeden önce kapılı olmalıdır.

Shopify Markets + Liquid Markets katmanı

Shopify Markets, tek bir Liquid kodebase'in Almanya, Avusturya ve İsviçre'yi kendi para birimi (EUR / CHF), dili, fiyatlandırması, etki alanı veya alt dizini ve vergi yapılandırması ile ayrı pazarlar olarak sunmasını sağlayan mekanizmadır. Liquid bağlam nesnesi mevcut pazarı sunar:

{% if localization.market.handle == 'de' %}
  {%- assign show_grundpreis = true -%}
{% endif %}

PayPal ve Klarna'nın tam fatura paketi Alman pazarı için kritik ödeme yöntemleridir; Shopify Payments 2026 itibarıyla çoğu DACH ödeme yöntemini yerel olarak destekler, ancak fatura ödemesi (Rechnungskauf) Klarna veya Mollie aracılığıyla tam kapsama için üçüncü taraf sağlayıcı entegrasyonu gerektirir.

Dil için, tüm Liquid şablonlardaki hitap formunda tutarlı olun. D2C ve yaşam tarzı bağlamlarında gayri resmi "Du" standarttır; B2B veya yüksek değerli mal için resmi "Sie" güven inşa eder. Header'da "Dein Warenkorb" ile ödeme sırasında "Geben Sie Ihre Adresse ein" arasındaki uyumsuzluk, mağazanın makine tarafından tercüme edildiğinin hemen bir güven sinyalidir, Alman pazarı için derlenmemiştir.

Sonucu doğrulama

Alman pazarı derlemesinden sonra, teslim etmeden önce bu kontrol listesini çalıştırın:

• shopify theme check --path ./theme sıfır hata ve error veya suggestion ile derecelendirilen sıfır uyarı döndürür.
• PDP'de Lighthouse mobil puanı 80'in üzerindedir (Liquid sunucu tarafında işler; şişmiş bir uygulama yığını genellikle değilse sorumludur).
• Impressum istikrarlı bir URL'de erişilebilir ve her sayfada footer'da bağlantılıdır.
• Ödeme düğmesi DE pazarı için "Zahlungspflichtig bestellen" veya eşdeğer okuyor.
• Widerrufsbutton, Alman alıcılar için satın alma sonrası mevcut ve işlevseldir.
• Çerez onayı herhangi bir piksel başlamadan önce başlar; pazar Almanya olarak ayarlanmış özel bir pencerede test edin.
• Tüm B2C ürün fiyatları MwSt dahil gösterilir (Markets vergi ayarlarını kontrol edin).
• PayPal ve en az bir fatura ödeme seçeneği (Klarna veya Mollie) DE pazarı için ödeme sırasında görünür.

Alman Shopify pazarı talep etme, ancak her gereksinim önceden bilinebilir. Hem Liquid işleme modelini hem de yasal yığını anlayan bir Liquid Geliştirici, dönüştüren ve uyumlu kalan bir mağaza inşa edebilir. Temmuz 2026 geliştirici önizlemesi Shopify'ın şablon modelinin nereye gittiğini gösterir ve GA'ye ulaşmadan önce iskelet temayı bir geliştirme mağazasında {% block %} ve {% partial %} bileşim modelini anlamak için şimdi çalıştırmaya değer.

Bunu şirket içinde yapmak yerine yaptırmak isterseniz, Lintel bu tür projeler için Shopify tema geliştirme sunuyor.