Fy2Press 1.0.0 · 09

27個の公開ショートコード一覧

商品、コレクション、絞り込みという責任ごとに整理された、正確な公開fy2press_*一覧を使います。

Fy2Press 1.0.0のドキュメントです。無料プラグインはWordPress.orgで入手できます。PROは、ライセンスと決済を担当するFreemiusを通じて別途販売しています。

3つのステップ

標準構成で十分なら完全版ショートコードから始めます。
細分化した要素は必要なコンテキスト内で使います。
公開前に表示とShopifyへの遷移を確認します。

このガイドはFy2Press 1.0.0について説明しています。今後のバージョンでは画面が変わることがあるため、手順に進む前に「プラグイン」画面に表示されているバージョンを確認してください。

期待される結果

商品、コレクション、絞り込みという責任ごとに整理された、正確な公開fy2press_*一覧を使います。

下記の27件からなる公開レジストリ全体を、バージョンに対応したAPI面として利用してください。各項目には、最小の記法、属性と既定値、必要な文脈、出力、既知の制限が記録されています。WordPressはショートコードの属性を文字列として渡し、そのあとでレンダラーが対応する値を正規化します。

開始前の準備

標準構成で十分なら完全版ショートコードから始めます。
細分化した要素は必要なコンテキスト内で使います。
公開前に表示とShopifyへの遷移を確認します。

このガイドで扱う内容

まず、それぞれの役割を確認しておきましょう。商品、在庫、注文、支払い、チェックアウトはShopifyが管理します。Fy2PressはカタログをWordPressに取り込んで表示します。WordPressにはサイトのページや記事などのコンテンツが置かれます。このガイドの手順で、注文、顧客、支払いがWordPressへ移ることはありません。

手順

標準構成で十分なら完全版ショートコードから始めます。下記のバージョン対応の完全な一覧を参照し、再利用する前に最小の代表的な例で試してください。
細分化した要素は必要なコンテキスト内で使います。下記のバージョン対応の完全な一覧を参照し、再利用する前に最小の代表的な例で試してください。
公開前に表示とShopifyへの遷移を確認します。下記のバージョン対応の完全な一覧を参照し、再利用する前に最小の代表的な例で試してください。

結果の確認

結果は、訪問者が実際に目にする場所で確認してください。Fy2Pressの画面だけでなく公開されているWordPressのページを開き、代表的な商品を、価格、在庫状況、バリエーション、コレクションも含めてShopifyと比べます。小さな変更を一度だけ繰り返し、動作が安定していることを確かめてください。

正確な名称または安定した識別子を確認する。
宣言された文脈とレンダリングされたページを照合する。
空、長大、利用不可のデータ状態を試す。
カバレッジ表がコンポーネントを明示している箇所に限り、Gutenberg、ショートコード、Elementor、WPBakeryの出力を比較する。

よくある問題

名称が似ているという理由で、属性、ブロックのコントロール、ビルダーのコンポーネントを推測しないこと。
ビルダー専用のコンポーネントを公開ショートコードに数え入れないこと。
概念上のカバレッジを、コントロール、マークアップ、挙動の同等性として説明しないこと。

トラブルシューティング

インストール済みパッケージのバージョンとエディションを再確認する。
問題をコンポーネント一つ、既知のカタログレコード一件、WordPressのURL一つに絞り込む。
正確な名称、安定した識別子、文脈、出力を、下記のバージョン対応の一覧と照合する。
失敗している責任がShopify、Fy2Press、WordPressのどれに属するかを特定する。
設定を変更する前にレンダリング結果と設定内容を保存し、その後で最小かつ安全なテストを一度だけ繰り返す。

セキュリティとデータ

サポートを依頼するときは、プラグインのバージョン、WordPressとPHPのバージョン、使用しているテーマまたはページビルダー、ページのアドレス、実行した手順を控えておいてください。テスト用の商品を使い、スクリーンショットを共有する前に、トークン、顧客データ、注文の詳細、非公開のアドレスを取り除いてください。

検索への影響

参照用コンポーネントは見出し、リンク、商品データ、対話的なコントロールを変えることがあります。代表的なページで、レンダリングされたセマンティクス、アクセシビリティ、canonicalの挙動、Shopifyへの購買の引き渡しを確認してください。

サポートに伝える情報

バージョンと提供状況

詳しくはこちら：ブロックとショートコードで構築する (EN)

商品面

Shortcode attributes arrive as WordPress strings and are normalized by the renderer. The values below come from the Fy2Press source for the version shown; they do not prove control parity across builders.

fy2press_product: [fy2press_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.
fy2press_product_title: [fy2press_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.
fy2press_product_description: [fy2press_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.
fy2press_product_price: [fy2press_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.
fy2press_product_image: [fy2press_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.
fy2press_product_url: [fy2press_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.
fy2press_product_vendor: [fy2press_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.
fy2press_product_type: [fy2press_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.
fy2press_product_tags: [fy2press_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.
fy2press_product_gallery: [fy2press_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 built-in Fy2Press defaults. Output: main image and optional thumbnails.
fy2press_product_availability: [fy2press_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.
fy2press_product_variants: [fy2press_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; built-in class and option_class defaults; hide_default_variant=true. Output: selectable variant controls; default-title variants can be hidden.
fy2press_product_collections: [fy2press_product_collections]Role: product collection links. Context: product with shopipress_collections terms. Attributes/defaults: style=links (links|badges); separator=comma-space; limit=0; built-in class and collection_class defaults; prefix and suffix=empty; title=Collections:; wrapper=div; built-in wrapper_class; hide_if_empty=true. Output: linked collection terms.
fy2press_add_to_cart: [fy2press_add_to_cart]Role: Shopify cart action. Context: resolved product and purchasable variant. Public attributes: none; the shortcode uses the built-in 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.
fy2press_buy_now: [fy2press_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.
fy2press_related_products: [fy2press_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 version shown.

コレクション面

fy2press_collection: [fy2press_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.
fy2press_products_loop: [fy2press_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.
fy2press_collection_title: [fy2press_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.
fy2press_collection_description: [fy2press_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.
fy2press_collection_sort: [fy2press_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.

検索とフィルター

fy2press_product_search: [fy2press_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 built-in 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.
fy2press_collection_filter: [fy2press_collection_filter type="dropdown"]Role: collection filter. Context: product loop or collection navigation. Attributes/defaults: type=dropdown (dropdown|checkbox|list); show_count=yes; built-in 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).
fy2press_tag_filter: [fy2press_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; built-in 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.
fy2press_filter_sidebar: [fy2press_filter_sidebar]…[/shopipress_filter_sidebar]Role: filter composition wrapper. Context: encloses other Fy2Press 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.
fy2press_price_filter: [fy2press_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.
fy2press_availability_filter: [fy2press_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が商取引、Fy2Pressがカタログ移行、WordPressが公開を担います。

Shopify · カタログと決済

Fy2Press · 手動同期と表示

WordPress · コンテンツ、テンプレート、SEO

次へ進む前に確認

Fy2Press画面だけでなくWordPressで結果を確認します。
カートと決済はShopifyに残します。
不具合報告にはインストール済みのバージョンを記録します。