Fy2Press 1.0.0 · 09
Referentie van 27 openbare shortcodes
Gebruik de exacte openbare fy2press_*-catalogus, gegroepeerd naar verantwoordelijkheid voor product, collectie en filtering.
Documentatie voor Fy2Press 1.0.0. De gratis plugin is beschikbaar op WordPress.org. PRO wordt apart verkocht via Freemius, onze leverancier voor licenties en betalingen.
In drie stappen
- Begin met de volledige shortcode als de standaardcompositie volstaat.
- Gebruik granulaire delen alleen in de vereiste context.
- Controleer pagina en Shopify-overgang voor publicatie.
Deze gids beschrijft Fy2Press 1.0.0. Schermen kunnen in latere versies veranderen, dus controleer de versie op het scherm Plugins voordat je de gids volgt.
Verwacht resultaat
Gebruik de exacte openbare fy2press_*-catalogus, gegroepeerd naar verantwoordelijkheid voor product, collectie en filtering.
Gebruik het volledige openbare register met 27 vermeldingen hieronder als een versiegebonden API-oppervlak. Elke vermelding legt de minimale syntaxis, de attributen en standaardwaarden, de vereiste context, de uitvoer en de bekende grens vast. WordPress geeft shortcode-attributen als tekenreeksen door voordat de renderer de ondersteunde waarden normaliseert.
Voor je begint
- Begin met de volledige shortcode als de standaardcompositie volstaat.
- Gebruik granulaire delen alleen in de vereiste context.
- Controleer pagina en Shopify-overgang voor publicatie.
Waar deze gids over gaat
Onthoud wie wat doet: Shopify beheert de producten, de voorraad, de bestellingen, de betalingen en het afrekenen; Fy2Press haalt de catalogus naar WordPress en toont hem; WordPress host je pagina’s en je redactionele inhoud. Niets in deze gids verplaatst bestellingen, klanten of betalingen naar WordPress.
Gebruik het volledige openbare register met 27 vermeldingen hieronder als een versiegebonden API-oppervlak. Elke vermelding legt de minimale syntaxis, de attributen en standaardwaarden, de vereiste context, de uitvoer en de bekende grens vast. WordPress geeft shortcode-attributen als tekenreeksen door voordat de renderer de ondersteunde waarden normaliseert.
Stappen
- Begin met de volledige shortcode als de standaardcompositie volstaat. Raadpleeg het volledige versiegebonden overzicht hieronder en test het kleinste representatieve voorbeeld voordat je het hergebruikt.
- Gebruik granulaire delen alleen in de vereiste context. Raadpleeg het volledige versiegebonden overzicht hieronder en test het kleinste representatieve voorbeeld voordat je het hergebruikt.
- Controleer pagina en Shopify-overgang voor publicatie. Raadpleeg het volledige versiegebonden overzicht hieronder en test het kleinste representatieve voorbeeld voordat je het hergebruikt.
Het resultaat controleren
Controleer het resultaat waar bezoekers het zullen zien: open de openbare WordPress-pagina, niet alleen het scherm van Fy2Press, en vergelijk een representatief product met Shopify, inclusief prijs, beschikbaarheid, varianten en collectie. Herhaal één kleine wijziging nog een keer om te bevestigen dat het gedrag stabiel is.
- Bevestig de exacte naam of de stabiele ID.
- Vergelijk de opgegeven context met de gerenderde pagina.
- Test lege, lange en niet-beschikbare gegevenstoestanden.
- Vergelijk de uitvoer van Gutenberg, shortcode, Elementor en WPBakery alleen waar de dekkingsmatrix een component vermeldt.
Veelvoorkomende problemen
- Leid geen attribuut, blokbesturing of buildercomponent af uit een gelijkende naam.
- Reken builder-eigen componenten niet mee bij de openbare shortcodes.
- Beschrijf conceptuele dekking niet als gelijkwaardigheid van besturing, markup of gedrag.
Problemen oplossen
- Bevestig opnieuw de versie en de editie van het geïnstalleerde pakket.
- Breng het probleem terug tot één component, één bekend catalogusrecord en één WordPress-URL.
- Vergelijk exacte naam, stabiele ID, context en uitvoer met het versiegebonden overzicht hieronder.
- Bepaal of de falende verantwoordelijkheid bij Shopify, Fy2Press of WordPress ligt.
- Bewaar het gerenderde antwoord en de instellingen voordat je de configuratie wijzigt, en herhaal daarna één keer de kleinste veilige test.
Beveiliging en gegevens
Als je om hulp vraagt, noteer dan de pluginversie, de versies van WordPress en PHP, je thema of paginabouwer, het adres van de pagina en de stappen die je hebt gevolgd. Gebruik testproducten en verwijder tokens, klantgegevens, bestelgegevens en privéadressen uit schermafbeeldingen voordat je ze deelt.
Effect op zoekmachines
Referentiecomponenten kunnen koppen, links, productgegevens en interactieve besturing wijzigen. Onderzoek op een representatieve pagina de gerenderde semantiek, de toegankelijkheid, het canonieke gedrag en de overdracht van de aankoop naar Shopify.
Informatie voor support
Als je om hulp vraagt, noteer dan de pluginversie, de versies van WordPress en PHP, je thema of paginabouwer, het adres van de pagina en de stappen die je hebt gevolgd. Gebruik testproducten en verwijder tokens, klantgegevens, bestelgegevens en privéadressen uit schermafbeeldingen voordat je ze deelt.
Gerelateerde gidsen
Versie en beschikbaarheid
Documentatie voor Fy2Press 1.0.0. De gratis plugin is beschikbaar op WordPress.org. PRO wordt apart verkocht via Freemius, onze leverancier voor licenties en betalingen.
Meer informatie: Bouwen met blokken en shortcodes (EN)
Productoppervlak
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.
Collectieoppervlak
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_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.
Zoeken en filters
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_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.
Houd de grens zichtbaar
Shopify beheert commerce, Fy2Press draagt de catalogus en WordPress publiceert.
Shopify · catalogus en checkout
Fy2Press · sync en rendering
WordPress · inhoud, sjablonen en SEO
Controleer voor je doorgaat
- Controleer het resultaat in WordPress.
- Laat winkelmand en checkout bij Shopify.
- Noteer de versie bij een foutmelding.