Shortcodes
Diese Seite ist die Referenz zu den beiden Shortcodes, die Customer Cloud Gallery registriert: dem Haupt-Galerie-Shortcode und dem Pro-Druckshop-Shortcode. Sie listet jedes unterstützte Attribut mit Standardwert und Beispiel. Gedacht für Nutzer, die das Layout pro Seite überschreiben oder mehrere Galerien auf derselben Website betreiben wollen.
Was du lernst
Section titled “Was du lernst”- Die beiden Shortcodes, die das Plugin registriert
- Jedes unterstützte Attribut von
[ccgal_gallery]und was es bewirkt - Wie du Galerie-Defaults pro Seite überschreibst, ohne die Galerie selbst anzufassen
- Wie du den Druckshop-Shortcode (Pro) verwendest
- Wo du den Shortcode für deine konkrete Galerie findest
Voraussetzungen
Section titled “Voraussetzungen”- Eine veröffentlichte Galerie — du brauchst mindestens eine Galerie-ID zum Einbetten (siehe Deine erste Galerie)
Wenn du nicht nach einer Attribut-Referenz suchst, sondern wissen willst, wie du eine Galerie-Seite Schritt für Schritt aufbaust (Hero, Titel, Galerie, Druck-CTA, Spacer-Block bei transparenten Headern), siehe Schöne Galerie-Seite gestalten.
[ccgal_gallery]
Section titled “[ccgal_gallery]”Der Haupt-Galerie-Shortcode. Rendert das Lazy-Loading-Grid, die Lightbox sowie die Favoriten- und Download-UI.
Attribute
Section titled “Attribute”| Attribut | Default | Werte | Beschreibung |
|---|---|---|---|
id | erforderlich | numerische WordPress-Post-ID | Die Galerie-Post-ID. Findest du unter Customer Cloud Gallery → Alle Galerien oder in der URL beim Bearbeiten der Galerie (post=42). |
per_page | Galerie-Einstellung | positive Ganzzahl | Überschreibt die Anzahl Bilder pro Seite für diese Einbettung. Praktisch, wenn du an einer Stelle einen dichteren Teaser möchtest. |
load | Galerie-Einstellung | scroll oder button | Überschreibt den Lade-Modus. scroll = unendliches Scrollen. button = Klick auf „Mehr laden”. |
size | Galerie-Einstellung | small, medium, large, xlarge | Thumbnail-Größe aus dem Cache. large ist der Standard für die meisten Themes; xlarge für Hero-Galerien. |
Alle Attribute außer id sind optional. Was du nicht übergibst, fällt auf die gespeicherte Konfiguration der Galerie zurück.
Beispiele
Section titled “Beispiele”Minimale Verwendung:
[ccgal_gallery id="42"]Lade-Button erzwingen, unabhängig von der Galerie-Einstellung:
[ccgal_gallery id="42" load="button"]Dichter Teaser auf einem Startseiten-Block:
[ccgal_gallery id="42" per_page="12" size="medium"][ccgal_print]
Section titled “[ccgal_print]”Pro-only. Rendert den Druckshop-Checkout, in dem Besucher Formate und Papier wählen, das Versandformular ausfüllen und eine Bestellung absenden.
Dieser Shortcode wird auf einer eigenen Seite platziert (das Plugin legt sie bei der ersten Pro-Aktivierung automatisch an, du kannst sie aber auch verschieben). Er liest den Galerie-Kontext und die ausgewählten Bilder des Besuchers über URL-Parameter — Besucher kommen normalerweise hierher, indem sie in der Galerie auf Abzüge bestellen klicken.
Attribute
Section titled “Attribute”Der Druckshop-Shortcode nimmt keine Attribute; den gesamten Kontext leitet er aus der Galerie ab, von der der Besucher kommt. Auf der Seite reicht:
[ccgal_print]Wo du deinen Shortcode findest
Section titled “Wo du deinen Shortcode findest”Öffne eine beliebige Galerie im WordPress-Admin (Customer Cloud Gallery → Alle Galerien → Bearbeiten). Die rechte Seitenleiste zeigt eine kopierfreundliche Box mit dem exakten Shortcode für diese Galerie, z. B. [ccgal_gallery id="42"].
Typische Fehler
Section titled “Typische Fehler”„Customer Cloud Gallery: Ungültige Galerie-ID.”
Die übergebene id passt zu keinem veröffentlichten Galerie-Beitrag. Prüfe die ID in der Galerie-Liste und stelle sicher, dass die Galerie auf Veröffentlicht steht (nicht Entwurf).
Der Shortcode erscheint als reiner Text auf der Seite. Du nutzt einen Page Builder, der Shortcodes entfernt, oder du hast versehentlich in einen Code-Block eingefügt. Verwende einen Shortcode-Block im Block-Editor oder das spezielle „Shortcode”-Widget deines Page Builders (Elementor, Divi und Beaver Builder haben jeweils eines).
Galerie-Einstellung geändert, aber die Seite zeigt weiter das alte Verhalten.
Du überschreibst per Shortcode-Attribut (load= oder per_page=), und das hat Vorrang vor der Galerie-Einstellung. Entferne das Attribut, dann greift wieder die gespeicherte Galerie-Konfiguration.
Nächster Schritt
Section titled “Nächster Schritt”Richte den Druckshop ein, damit Kunden direkt aus der Galerie heraus Abzüge bestellen können: Druckshop einrichten (Pro).