get_reference aracı (konu app_blocks) ve papelship://reference/app-blocks kaynağı. Kod düzenleyici, validate ve save_draft; bilinmeyen bloklar, bilinmeyen veya yanlış türde argümanlar ve bir tema türünün desteklemediği bloklar için uyarı verir.
Platform blokları ({% app_block %} / data-app-block): argümanlar, davranış, türe göre destek; kilitli sayfa blokları.
evet*: çalışır, aşağıdaki notla birlikte. Kod bölümlerinde ve ayrılmış ikizlerde sepet blokları, React temanın kendi çekmecesini değil platformun sepet çekmecesini kullanır; temanın sepet rozeti senkron kalır.
add_to_cart
Tek bir ürün için sepete ekle butonu. Ortak vitrin sepetine ekler ve sepet çekmecesini açar. Birden fazla varyantı olan ve seçim yapılmamış bir üründe: yanındaki variant_picker seçimi sorar, yoksa ürün sayfası açılır.buy_now
Tek bir ürün için hemen al butonu.mode: 'page' (varsayılan) yalnızca bu ürünle platform ödemesine gider (sepet korunur). mode: 'embed' ödeme açılır penceresini sayfanın üzerinde açar (platform iframe’i; kart verisi temaya asla dokunmaz) ve widget yüklenemezse sayfaya geri döner.
cart_count
Ürün sayısını gösteren sepet butonu (“Cart<n>”); kendi markup’ınız görünümünü korur ve bir [data-ps-count] alt öğesi sayıyı alır. Tıklama sepet çekmecesini açar. Argümanı yoktur.
cart_drawer
Kayan sepet çekmecesini yapılandırır (satırlar, adetler, kampanya indirimleri, ücretsiz kargo çubuğu, upsell, ödeme). Bulunduğu yerde hiçbir şey işlemez; sayfadaki ilkcart_drawer seçenekleri belirler.
checkout_button
Tüm sepet için ödeme butonu (sepet boşken devre dışıdır).mode: 'page' (varsayılan) <store>/checkout adresine gider; mode: 'embed' ödeme açılır penceresini açar; ödemeden sonra sepet boşaltılır.
currency_selector
Görüntüleme para birimi seçici (ikiden az para birimi varsa gizlenir). Görüntüleme para birimini saklar (ödeme her zaman mağaza para biriminde tahsil edilir) vepapelship:currency-change olayını yayar. Kod bölümlerinde ve ikizlerde currencies aktarın: bu sayfalar yalnızca mağaza para birimini bilir.
language_selector
Mağaza dili seçici (mağazanın tek dili varsa gizlenir). Dil çerezini ayarlar ve sayfayı yeniden yükler. Argüman:label.
newsletter_form
Açık rıza onay kutusu olan bülten kayıt formu. Platformun potansiyel müşteri uç noktasına gönderir; önizlemeler asla abone yapmaz. Argümanlar:label, placeholder, button, consent_text.
powered_by
“Powered by PapelShip” ibaresi (gizlemeye izin veren planlarda gizlenir). Yalnızca Liquid temaları içindir: tasarım sayfaları ve React tema altbilgileri bu ibareyi platformdan otomatik olarak alır.quick_view
Tek bir ürün için hızlı görünüm butonu: görseller, fiyat, varyantlar ve sepete ekle içeren bir iletişim kutusu açar. Argümanlar:product_id (zorunlu, takma ad product), label.
recently_viewed
Ziyaretçinin son görüntülediği ürünler (bu tarayıcıdan); liste boşsa hiçbir şey işlemez. Ürünler Liquid ürün sayfalarında kaydedilir (React tema ürün sayfaları görüntülemeleri kaydetmez). Argümanlar:limit (varsayılan 4, 1-20), heading.
reviews_widget
Yayınlanmış yorumlar: ürün sayfalarında sayfanın ürünü, diğer sayfalarda mağaza. Kod bölümlerinde veya ikizlerde desteklenmez (bu sayfalar yorum verisi taşımaz; React temanın yorumlar bölümünü kullanın). Argümanlar:heading, limit (varsayılan 5, 1-50), write (varsayılan true; false yorum yazma bağlantısını gizler).
variant_picker
Tek bir ürün için varyant seçici (radio grupları). En yakın ortak kapsayıcıdaki (veya birdata-ps-scope öğesindeki) aynı ürüne ait add_to_cart / buy_now seçilen varyantı kullanır; data-ps price / compare-price / stock metinleri de onu izler. Argüman: product_id (zorunlu, takma ad product).
wishlist_button
Tek bir ürün için favori geçişi (aria-pressed özelliğine sahip bir kalp butonu). Tarayıcıda saklanır ve oturum açıkken müşteri hesabıyla senkronize edilir. Argüman: product_id (sayısal id; hash id’ler hesaba kaydedilmez).
Kilitli sayfa blokları
Her biri yalnızca bir kez ve yalnızca kendi geçersiz kılma dosyasında çalışır. React tema kod paketlerinde sayfa geçersiz kılmaları yoktur.