ShopiPress 1.0.0 · 09
27個の公開ショートコード一覧
商品、コレクション、絞り込みという責任ごとに整理された、正確な公開shopipress_*一覧を使います。
Freemiusで正式公開されたShopiPress 1.0.0が対象です。
検証済みワークフロー
- 標準構成で十分なら完全版ショートコードから始めます。
- 細分化した要素は必要なコンテキスト内で使います。
- 公開前に表示とShopifyへの遷移を確認します。
このガイドは、ページ冒頭に示されたShopiPressのバージョンに適用されます。当該バージョンはFreemiusで正式に公開されています。手順を適用する前にインストール済みバージョンを確認してください。以降のバージョンでは画面、既定値、サービスの境界が変わる場合があります。
期待される結果
商品、コレクション、絞り込みという責任ごとに整理された、正確な公開shopipress_*一覧を使います。
下記の27件からなる公開レジストリ全体を、バージョンに対応したAPI面として利用してください。各項目には、最小の記法、属性と既定値、必要な文脈、出力、既知の制限が記録されています。WordPressはショートコードの属性を文字列として渡し、そのあとでレンダラーが対応する値を正規化します。
開始前の準備
- 標準構成で十分なら完全版ショートコードから始めます。
- 細分化した要素は必要なコンテキスト内で使います。
- 公開前に表示とShopifyへの遷移を確認します。
対象範囲と現在の制限
作業全体を通じて責任分担を明確に保ってください。Shopifyは引き続き商取引の情報源であり決済システムです。ShopiPressは提供された契約に従ってカタログを接続し、同期し、描画します。WordPressは公開の文脈を担います。WordPress側で成功した結果を、注文、顧客、支払い、在庫に関する権限の移転と解釈してはいけません。
下記の27件からなる公開レジストリ全体を、バージョンに対応したAPI面として利用してください。各項目には、最小の記法、属性と既定値、必要な文脈、出力、既知の制限が記録されています。WordPressはショートコードの属性を文字列として渡し、そのあとでレンダラーが対応する値を正規化します。
手順
- 標準構成で十分なら完全版ショートコードから始めます。 下記のバージョン対応の完全な一覧を参照し、再利用する前に最小の代表的な例で試してください。
- 細分化した要素は必要なコンテキスト内で使います。 下記のバージョン対応の完全な一覧を参照し、再利用する前に最小の代表的な例で試してください。
- 公開前に表示とShopifyへの遷移を確認します。 下記のバージョン対応の完全な一覧を参照し、再利用する前に最小の代表的な例で試してください。
結果の確認
結果はShopiPressの管理画面だけでなく、レンダリングされたWordPressページと権威あるShopify側の画面の両方で確認してください。価格、在庫状況、バリエーション、コレクションのデータを備えた代表的な商品を使用します。冪等性が問題になる場合は最小限の安全な操作を繰り返し、テストを広げる前に差異を必ず記録してください。
- 正確な名称または安定した識別子を確認する。
- 宣言された文脈とレンダリングされたページを照合する。
- 空、長大、利用不可のデータ状態を試す。
- カバレッジ表がコンポーネントを明示している箇所に限り、Gutenberg、ショートコード、Elementor、WPBakeryの出力を比較する。
よくある誤り
- 名称が似ているという理由で、属性、ブロックのコントロール、ビルダーのコンポーネントを推測しないこと。
- ビルダー専用のコンポーネントを公開ショートコードに数え入れないこと。
- 概念上のカバレッジを、コントロール、マークアップ、挙動の同等性として説明しないこと。
トラブルシューティング
- インストール済みパッケージのバージョンとエディションを再確認する。
- 問題をコンポーネント一つ、既知のカタログレコード一件、WordPressのURL一つに絞り込む。
- 正確な名称、安定した識別子、文脈、出力を、下記のバージョン対応の一覧と照合する。
- 失敗している責任がShopify、ShopiPress、WordPressのどれに属するかを特定する。
- 設定を変更する前にレンダリング結果と設定内容を保存し、その後で最小かつ安全なテストを一度だけ繰り返す。
セキュリティとデータ
インストール済みバージョン、エディション、WordPressとPHPのバージョン、有効なビルダーまたはSEO連携、正確なURL、ビューポート、そして結果を生んだ操作の順序を記録してください。取得するのは管理下のカタログデータのみとします。成果物が検証環境を離れる前に、Storefrontトークン、顧客データ、注文情報、非公開ドメイン、環境の機密情報を伏せてください。
SEOへの影響
参照用コンポーネントは見出し、リンク、商品データ、対話的なコントロールを変えることがあります。代表的なページで、レンダリングされたセマンティクス、アクセシビリティ、canonicalの挙動、Shopifyへの購買の引き渡しを確認してください。
記録すべき証跡
インストール済みバージョン、エディション、WordPressとPHPのバージョン、有効なビルダーまたはSEO連携、正確なURL、ビューポート、そして結果を生んだ操作の順序を記録してください。取得するのは管理下のカタログデータのみとします。成果物が検証環境を離れる前に、Storefrontトークン、顧客データ、注文情報、非公開ドメイン、環境の機密情報を伏せてください。
関連ガイド
バージョンと製品の状態
ShopiPressはFreemiusで正式に公開されています。このガイドは文書化されたバージョンを説明します。購入およびダウンロードのリンクは、その遷移先が設定され次第、本サイトに追加されます。
商品面
Shortcode attributes arrive as WordPress strings and are normalized by the renderer. The values below come from the exact plugin commit; they do not prove control parity across builders.
shopipress_product[shopipress_product id="123"]Role: complete product composition. Context: a published shopipress_product, or resolve with id or handle. Attributes/defaults: id=empty; handle=empty; show_description=yes; show_collections=yes; show_tags=no; class=empty. Output: product media, title, price and the available product controls. Returns an empty string when no published product resolves.shopipress_product_title[shopipress_product_title]Role: product title. Context: product page or builder preview. Attributes/defaults: fallback=Product Title Placeholder; show_fallback_in_editor=yes; tag=h1; font_size, font_weight, color, text_align, margin, padding and css_class=empty. Output: escaped title in the validated text container.shopipress_product_description[shopipress_product_description content_type="excerpt"]Role: product description. Context: singular product; otherwise the preview fallback. Attributes/defaults: content_type=full (full|excerpt|custom); word_limit=150; tag=div; fallback=empty; font_size=empty; font_weight=400; color, text_align, line_height, margin_top, margin_bottom, padding, css_class and css_id=empty; debug=false. Output: allowed product HTML passed through WordPress formatting.shopipress_product_price[shopipress_product_price type="range"]Role: product price. Context: singular product or preview fallback. Attributes/defaults: type=single (single|range|from); currency=symbol (symbol|code|none); fallback=$29.99; tag=div; font_size, font_weight, color, text_align, margin, padding and css_class=empty; show_compare=no; compare_color=#9ca3af; show_sale_badge=no; badge_color=#ef4444; badge_text_color=#ffffff; badge_text=On Sale. Output: formatted minimum, range or from-price, with optional comparison and sale badge.shopipress_product_image[shopipress_product_image link_to="product"]Role: featured product image. Context: singular product or editor preview. Attributes/defaults: size=large; width, height, object_fit and align=empty; link_to=none (none|full_image|product|custom); custom_url=empty; target_blank=empty; border_radius, border, box_shadow, margin, css_class, css_id and alt_text=empty. Output: responsive image markup with an optional validated link.shopipress_product_url[shopipress_product_url]Role: Shopify product URL. Context: synchronized product with a valid Shopify handle and configured store. Attributes/defaults: format=url (url|link); text=View on Shopify; target=_blank; class=shopipress-product-url shopipress-d-product-url. Output: escaped URL text or link; empty when the source URL cannot be resolved.shopipress_product_vendor[shopipress_product_vendor]Role: product vendor. Context: product data. Attributes/defaults: class=shopipress-product-vendor shopipress-d-product-vendor; prefix=empty; suffix=empty. Output: escaped vendor label or empty string.shopipress_product_type[shopipress_product_type]Role: Shopify product type. Context: product data. Attributes/defaults: class=shopipress-product-type shopipress-d-product-type; prefix=empty; suffix=empty. Output: escaped product-type label or empty string.shopipress_product_tags[shopipress_product_tags]Role: synchronized product-tag links. Context: product post with shopipress_tags terms. Attributes/defaults: separator=comma-space; limit=0; class=shopipress-product-tags shopipress-d-product-tags; tag_class=shopipress-product-tag shopipress-d-product-tag; style=links (links|badges); prefix=empty; suffix=empty; title=Tags:; wrapper=div; wrapper_class=shopipress-tags-section shopipress-d-tags-section; hide_if_empty=true. Output: linked terms.shopipress_product_gallery[shopipress_product_gallery]Role: product gallery. Context: synchronized product media. Attributes/defaults: show=all (all|featured); layout=gallery (gallery|slider); thumbs=bottom (bottom|right|none); size=large (medium|large|original); columns=4; class, main_class and thumb_class use the delivered ShopiPress defaults. Output: main image and optional thumbnails.shopipress_product_availability[shopipress_product_availability]Role: availability status. Context: product inventory data. Attributes/defaults: show=status (status|quantity|both); format=text (text|badge); in_stock_text=In Stock; out_of_stock_text=Out of Stock; low_stock_text=Low Stock; low_stock_threshold=5; show_quantity=false; class=shopipress-product-availability shopipress-d-product-availability. Output: status and optionally quantity.shopipress_product_variants[shopipress_product_variants]Role: variant selector. Context: product with synchronized variants. Attributes/defaults: style=dropdown (dropdown|buttons|grid); show_prices=false; show_images=false; show_labels=true; delivered class and option_class defaults; hide_default_variant=true. Output: selectable variant controls; default-title variants can be hidden.shopipress_product_collections[shopipress_product_collections]Role: product collection links. Context: product with shopipress_collections terms. Attributes/defaults: style=links (links|badges); separator=comma-space; limit=0; delivered class and collection_class defaults; prefix and suffix=empty; title=Collections:; wrapper=div; delivered wrapper_class; hide_if_empty=true. Output: linked collection terms.shopipress_add_to_cart[shopipress_add_to_cart]Role: Shopify cart action. Context: resolved product and purchasable variant. Public attributes: none; the shortcode uses the delivered product-design schema. Output: quantity and add-to-cart contract when available; the safe missing-variant action can direct the visitor to view the product. Checkout remains on Shopify.shopipress_buy_now[shopipress_buy_now]Role: direct Shopify buying action. Context: resolved product and variant. Attributes/defaults: text=Buy Now; class=shopipress-buy-now-btn shopipress-d-buy-now-btn; target=_blank. Output: escaped buying link that hands commerce back to Shopify.shopipress_related_products[shopipress_related_products limit="4"]Role: related product list. Context: a product resolved by current page or id. Attributes/defaults: id=empty; limit=4; title=You may also like; orderby=date; class=empty. Output: a bounded related-product composition; no dedicated builder component exists in the exact candidate.
コレクション面
Shortcode attributes arrive as WordPress strings and are normalized by the renderer. The values below come from the exact plugin commit; they do not prove control parity across builders.
shopipress_collection[shopipress_collection handle="collection-handle"]Role: complete collection composition. Context: collection resolved by id, handle or collection archive. Attributes/defaults: id=empty; handle=empty; limit=24; columns=4; show_title=yes; show_description=yes; pagination=infinite; class=empty. Output: collection heading and product loop, or empty when no collection resolves.shopipress_products_loop[shopipress_products_loop collection="collection-handle" limit="12" columns="3"]Role: product grid. Context: any page, optionally filtered to a collection. Attributes/defaults: limit=24; columns=4; collection=empty; class=shopipress-d-products-loop; item_class=shopipress-product-card; pagination=infinite; sort_by=empty. Supported sort mappings include price, title and created-date directions. Output: paginated or infinite catalog cards using local synchronized records and reviewed Storefront data paths.shopipress_collection_title[shopipress_collection_title]Role: collection title. Context: collection archive or resolved term. Attributes/defaults: tag=h1; class=shopipress-collection-title shopipress-d-collection-title; prefix=empty; suffix=empty. Output: escaped collection title.shopipress_collection_description[shopipress_collection_description]Role: collection description. Context: collection archive or resolved term. Attributes/defaults: class=shopipress-collection-description shopipress-d-collection-description; wrapper=div; hide_if_empty=true. Output: allowed description HTML or nothing when empty.shopipress_collection_sort[shopipress_collection_sort]Role: product sort control. Context: a product loop that reads the same public query state. Attributes/defaults: class=shopipress-collection-sort; label=Sort by:; show_label=true; default_option=Sort by...; wrapper=div; wrapper_class=shopipress-sort-wrapper shopipress-d-collection-sort. Output: sort selector preserving compatible query parameters.
検索とフィルター
Shortcode attributes arrive as WordPress strings and are normalized by the renderer. The values below come from the exact plugin commit; they do not prove control parity across builders.
shopipress_product_search[shopipress_product_search]Role: local product-title search control. Context: paired with the products loop. Attributes/defaults: placeholder=Search products...; class, wrapper_class, input_class and button_class use delivered defaults; button_text=Search; show_results_count=yes; search_in=title,description,tags. Current local search implementation is title-only; do not infer full-field parity from the attribute label.shopipress_collection_filter[shopipress_collection_filter type="dropdown"]Role: collection filter. Context: product loop or collection navigation. Attributes/defaults: type=dropdown (dropdown|checkbox|list); show_count=yes; delivered class and wrapper_class; title=Collection; show_title=yes; show_all_option=yes; all_text=All Collections; limit=0; orderby=name (name|count|slug); order=ASC; hide_empty=yes; hierarchical=yes; behavior=collection_archive (collection_archive|query).shopipress_tag_filter[shopipress_tag_filter type="tags"]Role: product-tag filter. Context: product loop reading tag_filter. Attributes/defaults: saved type, with checkbox, tags, buttons, dropdown, list and cloud render paths; show_count=yes; delivered class and wrapper_class; title=Filter by Tags; show_title=yes; show_all_option=yes; all_text=All Tags; limit=10; orderby=count; order=DESC; hide_empty=yes; multiple=yes; style=badges; max_display=20.shopipress_filter_sidebar[shopipress_filter_sidebar]…[/shopipress_filter_sidebar]Role: filter composition wrapper. Context: encloses other ShopiPress filter shortcodes. Attributes/defaults: class=shopipress-filter-sidebar; wrapper_class=filter-sidebar-wrapper; title=Filter Products; show_title=yes; style=sidebar (sidebar|horizontal|accordion); background=#f8f9fa; padding=20px; border_radius=8px; gap=20px. Output: grouped filters and a clear-all action when compatible filters are active.shopipress_price_filter[shopipress_price_filter min="0" max="250"]Role: price filter. Context: product loop reading price_min and price_max. Attributes/defaults: min=0; max=1000; default_min=0; default_max=250; step=10; currency=auto; title=Filter by Price. Values are bounded and normalized by the product loop before Storefront requests.shopipress_availability_filter[shopipress_availability_filter type="checkbox"]Role: availability filter. Context: product loop reading availability_filter. Attributes/defaults: type comes from the saved display setting; supported paths are checkbox, buttons and dropdown, with radio retained for compatibility; options=in_stock,out_of_stock; title=Availability; show_count=yes; class=availability-filter-container. Output: public query controls.
システム境界を明示
Shopifyが商取引、ShopiPressがカタログ移行、WordPressが公開を担います。
Shopify · カタログと決済
ShopiPress · 手動同期と表示
WordPress · コンテンツ、テンプレート、SEO
次へ進む前に確認
- ShopiPress画面だけでなくWordPressで結果を確認します。
- カートと決済はShopifyに残します。
- 不具合報告にはインストール済みのバージョンを記録します。