ShopiPress.
Entdecken
DE

ShopiPress 1.0.0 · 09

Referenz der 27 öffentlichen Shortcodes

Den exakten öffentlichen shopipress_*-Katalog verwenden, gegliedert nach Produkt-, Kollektions- und Filterzuständigkeit.

Gilt für ShopiPress 1.0.0, offiziell auf Freemius veröffentlicht.

Geprüfter Ablauf

  1. Vollständigen Shortcode wählen, wenn das Standardlayout genügt.
  2. Granulare Elemente nur im erforderlichen Kontext einsetzen.
  3. Ausgabe und Shopify-Übergang vor Veröffentlichung prüfen.

Diese Anleitung gilt für die im Seitenkopf genannte ShopiPress-Version, offiziell auf Freemius veröffentlicht. Prüfen Sie die installierte Version, bevor Sie das Vorgehen anwenden. Spätere Versionen können Ansichten, Standardwerte oder Servicegrenzen verändern.

Erwartetes Ergebnis

Den exakten öffentlichen shopipress_*-Katalog verwenden, gegliedert nach Produkt-, Kollektions- und Filterzuständigkeit.

Nutzen Sie das vollständige öffentliche Register mit 27 Einträgen weiter unten als versionsgebundene API-Oberfläche. Jeder Eintrag hält seine minimale Syntax, Attribute und Standardwerte, den erforderlichen Kontext, die Ausgabe und die bekannte Grenze fest. WordPress übergibt Shortcode-Attribute als Zeichenketten, bevor der Renderer unterstützte Werte normalisiert.

Vorbereitung

  • Vollständigen Shortcode wählen, wenn das Standardlayout genügt.
  • Granulare Elemente nur im erforderlichen Kontext einsetzen.
  • Ausgabe und Shopify-Übergang vor Veröffentlichung prüfen.

Umfang und aktuelle Grenzen

Halten Sie das Zuständigkeitsmodell während der gesamten Aufgabe sichtbar: Shopify bleibt die kommerzielle Quelle und das Checkout-System; ShopiPress verbindet, synchronisiert und rendert den Katalog gemäß den ausgelieferten Verträgen; WordPress verantwortet den Publikationskontext. Ein erfolgreiches Ergebnis in WordPress darf nicht als Übertragung von Bestellungen, Kunden, Zahlungen oder Bestandshoheit verstanden werden.

Nutzen Sie das vollständige öffentliche Register mit 27 Einträgen weiter unten als versionsgebundene API-Oberfläche. Jeder Eintrag hält seine minimale Syntax, Attribute und Standardwerte, den erforderlichen Kontext, die Ausgabe und die bekannte Grenze fest. WordPress übergibt Shortcode-Attribute als Zeichenketten, bevor der Renderer unterstützte Werte normalisiert.

Vorgehen

  1. Vollständigen Shortcode wählen, wenn das Standardlayout genügt. Ziehen Sie das vollständige versionsgebundene Verzeichnis weiter unten heran und testen Sie das kleinste repräsentative Beispiel, bevor Sie es wiederverwenden.
  2. Granulare Elemente nur im erforderlichen Kontext einsetzen. Ziehen Sie das vollständige versionsgebundene Verzeichnis weiter unten heran und testen Sie das kleinste repräsentative Beispiel, bevor Sie es wiederverwenden.
  3. Ausgabe und Shopify-Übergang vor Veröffentlichung prüfen. Ziehen Sie das vollständige versionsgebundene Verzeichnis weiter unten heran und testen Sie das kleinste repräsentative Beispiel, bevor Sie es wiederverwenden.

Ergebnis prüfen

Prüfen Sie das Ergebnis auf der gerenderten WordPress-Seite und auf der maßgeblichen Shopify-Oberfläche, nicht nur im Administrationsbereich von ShopiPress. Verwenden Sie ein repräsentatives Produkt mit Preis-, Verfügbarkeits-, Varianten- und Kollektionsdaten. Wiederholen Sie den kleinsten sicheren Vorgang, wenn Idempotenz zählt, und halten Sie jede Abweichung fest, bevor Sie den Test ausweiten.

  • Den exakten Namen oder die stabile ID bestätigen.
  • Den deklarierten Kontext mit der gerenderten Seite vergleichen.
  • Leere, lange und nicht verfügbare Datenzustände testen.
  • Ausgaben von Gutenberg, Shortcode, Elementor und WPBakery nur dort vergleichen, wo die Abdeckungsmatrix eine Komponente ausweist.

Häufige Fehler

  • Kein Attribut, kein Block-Steuerelement und keine Builder-Komponente aus einem ähnlichen Namen ableiten.
  • Builder-eigene Komponenten nicht zu den öffentlichen Shortcodes zählen.
  • Konzeptionelle Abdeckung nicht als Gleichwertigkeit von Steuerelementen, Markup oder Verhalten beschreiben.

Fehlerbehebung

  1. Version und Edition des installierten Pakets erneut bestätigen.
  2. Das Problem auf eine Komponente, einen bekannten Katalogdatensatz und eine WordPress-URL reduzieren.
  3. Exakten Namen, stabile ID, Kontext und Ausgabe mit dem versionsgebundenen Verzeichnis weiter unten vergleichen.
  4. Bestimmen, ob die fehlerhafte Zuständigkeit bei Shopify, ShopiPress oder WordPress liegt.
  5. Gerenderte Antwort und Einstellungen sichern, bevor die Konfiguration geändert wird, und den kleinsten sicheren Test danach einmal wiederholen.

Sicherheit und Daten

Halten Sie die installierte Version, die Edition, die WordPress- und PHP-Versionen, den aktiven Builder oder die aktive SEO-Integration, die exakte URL, den Viewport und die geordneten Aktionen fest, die zum Ergebnis geführt haben. Erfassen Sie ausschließlich kontrollierte Katalogdaten. Schwärzen Sie das Storefront-Token, Kundendaten, Bestellinformationen, private Domains und jedes Umgebungsgeheimnis, bevor ein Artefakt den Validierungsbereich verlässt.

SEO-Auswirkungen

Referenzkomponenten können Überschriften, Links, Produktdaten und interaktive Steuerelemente verändern. Prüfen Sie auf einer repräsentativen Seite die gerenderte Semantik, die Zugänglichkeit, das Canonical-Verhalten und die Kaufübergabe an Shopify.

Festzuhaltende Nachweise

Halten Sie die installierte Version, die Edition, die WordPress- und PHP-Versionen, den aktiven Builder oder die aktive SEO-Integration, die exakte URL, den Viewport und die geordneten Aktionen fest, die zum Ergebnis geführt haben. Erfassen Sie ausschließlich kontrollierte Katalogdaten. Schwärzen Sie das Storefront-Token, Kundendaten, Bestellinformationen, private Domains und jedes Umgebungsgeheimnis, bevor ein Artefakt den Validierungsbereich verlässt.

Verwandte Anleitungen

Version und Produktstatus

ShopiPress ist offiziell auf Freemius veröffentlicht. Diese Anleitung beschreibt die dokumentierte Version. Kauf- und Download-Links werden auf dieser Website ergänzt, sobald ihre Ziele konfiguriert sind.

Produktfläche

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.

Kollektionsfläche

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.

Suche und Filter

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.

Systemgrenze sichtbar halten

Shopify verwaltet Commerce, ShopiPress transportiert den Katalog, WordPress publiziert.

Shopify · Katalog und Checkout

ShopiPress · manueller Sync und Rendering

WordPress · Inhalt, Templates und SEO

Vor dem nächsten Schritt prüfen

  • Ergebnis direkt in WordPress prüfen.
  • Warenkorb und Checkout bei Shopify belassen.
  • Beim Fehlerbericht die Version notieren.