PublyAIShop – Shortcodes & Anleitung

Von /

Diese Dokumentation zeigt dir Schritt für Schritt, wie du PublyAIShop einrichtest, welche Shortcodes verfügbar sind und wie du die KI-Funktionen (GPT) optimal nutzt.

1) Überblick

PublyAIShop importiert Awin-Feeds in eigene Plugin-Tabellen und erzeugt daraus:

  • Kategorieseiten
  • Produktseiten
  • Produktlisten per Shortcode

Zusätzlich kann das Plugin mit OpenAI/GPT:

  • Produktbeschreibungen unique umschreiben
  • pro Produkt einen Textblock „Das gefällt uns bei diesem Produkt“ erstellen
  • Autoren anzeigen (inkl. Kategorie-Autor mit Priorität)

2) Voraussetzungen

  • WordPress mit aktivierten „sprechenden Permalinks“
  • Erreichbarer Awin-Feed
  • Server mit ausgehendem HTTPS-Zugriff (für Feed-Download + OpenAI API)
  • Für KI-Funktionen: gültiger OpenAI API Key

3) Ersteinrichtung

  1. Plugin aktivieren
  2. Shop anlegen unter PublyAIShop > Shops:
    • Name
    • Awin Feed URL
    • Import-Intervall (Minuten, 0 = aus)
    • optional: Bilder lokal speichern
    • optional: unmapped Kategorien automatisch zuordnen
  3. Import starten mit „Jetzt importieren“
  4. Kategorien prüfen unter Kategorien
  5. Kategorie-Mapping setzen unter Kategorie Mapping
  6. Einstellungen prüfen unter Einstellungen:
    • Kategorie-Basis (z. B. kategorie)
    • Produkt-Basis (z. B. produkt)

4) Shortcodes

4.1 Shortcode-Name

[publyai_shop]

4.2 Verfügbare Attribute

  • view: categories oder products (Standard: categories)
  • category: Kategorie-Slug (nur bei view="products")
  • shop: numerische Shop-ID (0 = alle Shops)
  • limit: Anzahl Produkte (Standard: 24)

4.3 Beispiele

Kategorienliste (Standard):

[publyai_shop]

Kategorienliste (explizit):

[publyai_shop view="categories"]

Produktgrid (alle Shops, alle Kategorien):

[publyai_shop view="products"]

Produktgrid für eine Kategorie:

[publyai_shop view="products" category="gartenmoebel"]

Produktgrid für einen Shop:

[publyai_shop view="products" shop="2"]

Produktgrid mit Kategorie + Shop + Limit:

[publyai_shop view="products" category="hochbeet" shop="2" limit="12"]

4.4 Verhalten

  • view="categories" zeigt alle Kategorien als Karten.
  • view="products" zeigt ein Produktgrid.
  • Das Shortcode-Grid ist bewusst kompakt (ohne eigene Pagination/Sortiersteuerung).
  • Für Vollansicht mit Suche/Filter/Sortierung nutze die Kategorie-Routen (z. B. /kategorie/dein-slug/).

5) KI-Funktionen (OpenAI/GPT)

5.1 API-Key hinterlegen

Unter PublyAIShop > Einstellungen:

  • OpenAI API Key eintragen
  • Modell festlegen (z. B. gpt-4o-mini)
  • optional globalen Text-Autor setzen

5.2 KI-Texte erzeugen

  • Global: „KI-Texte für Produkte erzeugen“
  • Einzeln: im Produkt „KI-Texte für dieses Produkt neu erzeugen“

5.3 Welche Texte entstehen

  • KI Beschreibung
  • Das gefällt uns (für den Produktseiten-Abschnitt)

5.4 Manuelle Bearbeitung

Beide Felder sind im Produkt editierbar und werden beim normalen Produktspeichern übernommen:

  • KI Beschreibung
  • Das gefällt uns

6) Autoren-Logik

6.1 Kategorie-Autor

Unter Kategorien kannst du pro Kategorie einen WordPress-User als Autor setzen.

6.2 Fallback-Logik auf der Produktseite

  1. Wenn ein Kategorie-Autor vorhanden ist, wird dieser angezeigt.
  2. Wenn keiner vorhanden ist, wird auf den bisherigen Produkt-/globalen Autor zurückgefallen.

7) URLs & Routing

Das Plugin erzeugt eigene Routen basierend auf deinen Einstellungen:

  • Kategorie: /{kategorie-basis}/{kategorie-slug}/
  • Produkt: /{produkt-basis}/{produkt-slug}/

Standardmäßig:

  • /kategorie/...
  • /produkt/...

Tipp: Nach URL-Änderungen in den Einstellungen einmal speichern, damit Rewrite-Regeln sauber aktualisiert werden.

8) Troubleshooting

„KI-Texte konnten nicht erstellt werden“

  • Die Admin-Notice zeigt eine Detailmeldung.
  • Prüfe API-Key, Modellname, Netzwerkzugriff, API-Konto/Billing.

404 auf Produkt-/Kategorie-URL

  • Permalinks einmal neu speichern.
  • Kategorie-/Produkt-Basis prüfen.

Shortcode zeigt keine Produkte

  • Sind Produkte aktiv?
  • Stimmt der Kategorie-Slug bei category="..."?
  • Stimmt die Shop-ID bei shop="..."?

Bilder fehlen

  • Bei lokalem Download: Serverrechte/Erreichbarkeit prüfen.
  • Ohne lokalen Download: externe Bild-URL muss erreichbar sein.

9) Best Practices

  • Zuerst Import + Mapping sauber aufsetzen, danach KI-Texte erzeugen.
  • Kategorie-Autoren direkt pro Themenbereich pflegen.
  • KI-Texte redaktionell kurz prüfen und bei Bedarf manuell nachschärfen.
  • Für Landingpages Shortcodes gezielt mit shop, category und limit kombinieren.

Stand: aktuelle Plugin-Version mit GPT-Textgenerierung, editierbaren KI-Feldern und Kategorie-Autor-Unterstützung.

Nach oben scrollen