Ana içeriğe atla
Yapay zeka ajanları aynı referansı tema MCP’sinden alır: 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 ilk cart_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) ve papelship: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 bir data-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.