Shortcodes und Blöcke im Überblick

Alle Shortcodes des Plugins mit ihren Attributen und je einem Beispiel – dazu die passenden Blöcke.

Produkte gibst du über ihre Kennung an: die zentrale ID aus affilinode oder asin:…, gtin:…, mpn:marke/mpn und atkp:<Post-ID>. Kurzformen sind asin="…" und ean="…". Alle Shortcodes kennen außerdem locale (z. B. en-GB), country (z. B. AT) und render (server, hybrid oder ajax).

Seit Plugin-Version 0.30 heißen die Shortcodes [affilinode_…]. Die bisherigen Namen [ac_…] funktionieren weiter, solange unter Einstellungen „Alte Shortcodes [ac_…] weiter unterstützen“ an ist (Standard). Der Shortcode-Generator erzeugt die neuen Namen. Den Shortcode einer Box gibt es auch im Dashboard: Der Dialog „Code erzeugen“ (Seitenleiste oder Alt + Umschalt + E, an Produkten und Listen „Als Box einbetten“) zeigt ihn im Reiter „WordPress“ zum Kopieren.

Einzelne Produkte

                  [affilinode_product id="123" template="box"]
                
  • affilinode_product: template = box (Standard), horizontal, compact oder card; thumbs = 1 oder 0; variants = 1 zeigt einen Varianten-Wähler; spare_parts = 1 zeigt passende Ersatzteile; alternatives = 1 zeigt Alternativen unter der Box (0 = nie, leer = Einstellung); glance = 1 zeigt „Auf einen Blick“ unter der Box (0 = nie, leer = Einstellung); docs = 1 zeigt die Dokumente zum Produkt (Datenblatt, Anleitung, Energielabel) als Links unter der Box; title = eigener Titel; title_style = short oder detailed.
  • affilinode_products: Grid mehrerer Produkte, ids="123,456,789", template = card (Standard), horizontal, compact oder box, columns = 2 bis 4 (Standard 3), title = Überschrift über den Karten, title_style = short oder detailed.
  • Eigene Vorlagen aus affilinode → Vorlagen: template="custom:<slug>" bei affilinode_product, affilinode_products, affilinode_list, affilinode_amazon_list, affilinode_deals und affilinode_context. Siehe „Eigene Box-Vorlagen“.
  • affilinode_offers: Preisvergleich aller Angebote, id, limit (Standard 5), header = 1 oder 0, title = eigener Titel, title_style = short oder detailed. Ein Amazon-Eintrag ohne Preis (siehe „Amazon nur als Link“) steht als eigener Knopf unter der Tabelle.
  • affilinode_button: Kaufen-Button, id, shop = best (Standard), amazon, ebay oder awin, label = eigener Text, title = eigener Titel, title_style = short oder detailed. Ohne Angebot mit Preis führt der Button zum Amazon-Link ohne Preis, falls es einen gibt.
  • affilinode_price_history: Preisverlauf, id, days = 7 bis 365 (Standard 90), height = 120 bis 600 Pixel, title = eigener Titel, title_style = short oder detailed.
  • affilinode_price_alert: Preisalarm-Formular, id, title, target = vorgeschlagener Wunschpreis.
  • affilinode_stock_alert: „Wieder verfügbar“-Formular, solange das Produkt bei keinem Shop außer Amazon lieferbar ist, id, title. Unter Produktboxen mit stock_alert="1". Standard aus (Einstellungen → Preisalarme). Siehe „„Wieder verfügbar“-Benachrichtigung für Leser“.
  • affilinode_spare_parts: Ersatzteile eines Geräts, id, template = grid oder list, columns, limit (0 = alle), title = 1 oder 0 oder ein eigener Text als Überschrift, title_style = short oder detailed.
  • affilinode_accessories: Zubehör eines Produkts (Hülle, Ladegerät, Kabel – keine Ersatzteile), id, template = grid oder list, columns, limit (0 = alles), title = 1 oder 0 oder ein eigener Text als Überschrift, title_style = short oder detailed.
  • affilinode_alternatives: günstigere, besser ausgestattete Produkte und Nachfolger als kleine Karten mit Begründung, id, kinds = cheaper, better und/oder successor mit Komma (Reihenfolge der Karten), limit = Produkte je Art (1–6, Standard 1), view = grid oder list, columns, scope = site, title (leer = „Alternativen zu …“, 0 = keine Überschrift). Siehe „Alternativen“.
  • affilinode_complements: „Dazu passt auch“ – andere Geräte, die man oft zusätzlich kauft, nur bestätigte Paare „Passt dazu“, id, limit = Anzahl (1–6, Standard 4), view = grid oder list, columns, scope = site, title (leer = „Dazu passt auch“, 0 = keine Überschrift). Siehe „Zubehör“.
  • affilinode_software: Software-Steckbrief – aktuelle Version, Stand, Lizenz, Neuerungen in Kürze und Links des Herstellers, id, title (leer = „Software auf einen Blick“, 0 = keine Überschrift). Ohne hinterlegte Angaben bleibt die Box leer.
  • affilinode_support: „Bis wann gibt es Updates?“ – die Zusagen des Herstellers mit Hinweis, wenn der Zeitraum bald endet oder vorbei ist, id, title (leer = „Bis wann gibt es Updates?“, 0 = keine Überschrift). Ohne Zusage bleibt die Box leer.
  • affilinode_buytime: „Jetzt kaufen oder warten?“ – Einordnung des aktuellen Preises anhand des eigenen Preisverlaufs, mit Hinweis auf Aktionstage und Betriebskosten pro Jahr, id, title (leer = „Jetzt kaufen oder warten?“, 0 = keine Überschrift). Die Box zeigt keine Angebotspreise und keine Shop-Links.
  • affilinode_seals: Siegel und Zertifikate eines Produkts mit kurzer Erklärung, id, title (leer = „Siegel und Zertifikate“, 0 = keine Überschrift). Ohne hinterlegtes Siegel bleibt die Box leer.
  • affilinode_packing: Packliste mit Auswahl für Klima und Jahreszeit und Produktvorschlägen, id = Kürzel der Packliste aus dem Dashboard, climate = hot, warm, mild, cold, freezing oder rainy (Voreinstellung), season = spring, summer, autumn oder winter (Voreinstellung), controls = 0 blendet die Auswahl für Besucher aus, title (leer = „Packliste“, 0 = keine Überschrift).
  • affilinode_trip_plan: Reiseplan mit Zeiträumen und Bausteinen (Flug, Unterkunft, Bahn …) und den Links der Partner, id = Kürzel des Reiseplans aus dem Dashboard, title (leer = „Reiseplan“, 0 = keine Überschrift).
  • affilinode_glance: „Auf einen Blick“ – die wichtigsten Kernwerte als Kacheln, jeder eingeordnet gegenüber der Produktart („besser als 80 % der Smartphones“), id, count = Anzahl (1–12, Standard 6), fields = Feldschlüssel mit Komma, button = 1 Button zum besten Angebot, title (leer = „Auf einen Blick“, 0 = keine Überschrift), heading = 2 oder 3. Siehe „Auf einen Blick“.
  • affilinode_energy: Folgekosten – Strom- und Wasserkosten pro Jahr und über mehrere Jahre nach dem EU-Energielabel, id, compare = zweites Produkt zum Vergleich, years (1–20, Standard 5), price = Strompreis in ct/kWh, water = Wasserpreis in €/m³, cycles = Zyklen pro Woche, hours = Stunden pro Tag, button = 1 Button zum besten Angebot, title, heading = 2 oder 3. Siehe „Folgekosten“.
  • affilinode_coupons: Gutscheine und Aktionen der Händler aus Awin, Tradedoubler, Webgains und CJ (bzw. eigene aus dem Dashboard), merchant = Händler, product = nur Händler mit Angebot dieses Produkts, shop = Shop-ID, kind = code, offer, free_shipping, limit (1–50, Standard 6), title, heading = 2 oder 3. Unter Produktboxen mit coupons="1" bzw. der Einstellung. Siehe „Gutscheine“.
  • affilinode_packs: Packungsgrößen – je Größe (Einzeln, 2er-, 3er-Pack …) das günstigste Angebot mit Stückpreis und Ersparnis je Stück, id, sort = quantity oder unit, only_available = 1, title, heading = 2 oder 3. Im Preisvergleich packs="tabs" (Reiter je Größe) bzw. packs="hint", unter Produktboxen packs_box="1". Siehe „Packungsgrößen“.
  • affilinode_details: Beschreibung, Vor- und Nachteile und technische Daten eines Produkts als Text und Tabelle, id, show = description, proscons und/oder specs mit Komma (Standard alle drei), heading = 2 oder 3 (Ebene der Überschriften). Leere Abschnitte fallen weg.
  • affilinode_rating: eigene Testbewertung mit Note, Testdatum, Fazit, Kriterien, Vor- und Nachteilen, Badge und Button, id, title = eigene Überschrift, criteria, proscons und button = 0 blenden den Teil aus (siehe „Testbewertung“). rating = 1 in affilinode_product und affilinode_products zeigt die Testnote in der Box.
                  [affilinode_details id="123" show="specs" heading="3"]
                
                  Den [affilinode_link asin="B0CXYZ1234" text="Router" price="1"] gibt es gerade für [affilinode_field asin="B0CXYZ1234" field="price"].
                
  • affilinode_link: Textlink zum günstigsten Angebot, text = Linktext (Standard: Produkttitel, auch als [affilinode_link …]Text[/affilinode_link]), price = 1 hängt den aktuellen Preis an, shop = best, amazon, ebay oder awin.
  • affilinode_field: ein einzelner Wert, field = price (Standard), title, link, button, url, shop, availability, stars, rating, reviews, image, thumb, brand, description, list_price, amount_saved, percentage_saved, last_update, asin oder sales_rank (Amazon-Bestseller-Rang, z. B. „Nr. 197 in Elektronik & Foto“ – nur, wenn Amazon einen Rang liefert, und höchstens 24 Stunden alt); text = eigener Titel, image = Bildnummer ab 1, shop wie beim Textlink. Ein Feld prime gibt es nicht: Amazon liefert die Prime-Angabe über die API nicht mehr.
  • Beide stehen immer gleich im HTML der Seite. Links tragen rel="sponsored nofollow noopener" und zählen in der Klickstatistik als eigene Box-Art („Textlink“, „Produktfeld“). Preise erscheinen nur mit aktuellem Stand; Preisstand und Affiliate-Hinweis stehen im Tooltip.
  • Mini-Karte (optional, Einstellungen → Darstellung → „Mini-Karte über Textlinks“, ab Werk aus): Ruht der Mauszeiger auf einem Textlink oder bekommt er den Tastaturfokus, schwebt darüber eine kleine Karte mit Bild, Titel, Preis samt Stand und Affiliate-Hinweis – auch an automatischen Links zu Produkten und an field="link". Preise nur, solange sie aktuell sind, Amazon-Preise höchstens 24 Stunden alt; sonst nur der Shop. Der Text verschiebt sich nicht, Escape schließt die Karte, auf Touchscreens passiert nichts (ein Tipp öffnet den Link). Je Link: preview="1" bzw. preview="0".
  • Im Block-Editor: Text im Absatz markieren und in der Format-Leiste (Pfeil) „affilinode-Link“ wählen – der Generator öffnet sich mit dem Textlink und setzt den Shortcode an die Stelle der Markierung. Als eigener Absatz gibt es die Blöcke „Textlink“ und „Produktfeld“.
  • Im Theme: echo affilinode_field( 'asin:B0CXYZ1234', 'price' ); bzw. echo affilinode_link( 'asin:B0CXYZ1234', array( 'price' => '1' ) ); – dieselben Attribute wie die Shortcodes, Rückgabe ist fertiges, escaptes HTML.

Listen, Vergleiche und Deals

                  [affilinode_list id="bestenliste" template="grid" columns="3" limit="10"]
                
  • affilinode_list: Liste aus affilinode, id oder view (Kategorie-Sicht), template = grid oder list, columns, limit (0 = alle), title = 0 blendet Titel und Beschreibung aus, ranking = Platznummern, replace = notice, silent oder off.
  • affilinode_compare: Vergleichstabelle, ids="123,456" – mit Schalter „Nur Unterschiede anzeigen“. table = ID einer unter „Vergleichstabellen“ gespeicherten Tabelle (statt ids), rows = Zeilen und Reihenfolge (z. B. price,rating,field:display_size), highlight = hervorgehobenes Produkt (Position oder Kennung), badge = Text dazu (z. B. Testsieger), title = Überschrift über der Tabelle, title_style = short oder detailed.
  • affilinode_compare_picker: Leser stellen ihren Vergleich selbst zusammen, type = Produktart, max = 2 bis 5, ids = Vorauswahl, title, title_style = short oder detailed.
  • affilinode_deals: Produkte mit gerade gesunkenem Bestpreis, type = Produktarten mit Komma, min = Mindestersparnis in Prozent (Standard 10), limit (Standard 8), template = list oder grid, columns, title.
  • affilinode_calculator: Tarifrechner von CHECK24, Tarifcheck & Co., key = Schlüssel des Rechners aus „affilinode“ → „Tarifrechner“, consent = click oder direct.
                  [affilinode_deals type="smartphone,tablet" min="15" limit="6" template="grid" columns="3"]
                

Produktsuche mit Filtern

affilinode_search (Block „Produktsuche“) setzt eine Such- und Filterseite auf: Suchfeld mit Ergebnissen schon beim Tippen, daneben Filter mit Trefferzahlen, darunter die Produkte als Karten oder Zeilen mit Seitenknöpfen. Auf dem Handy öffnen sich die Filter als eigenes Fenster.

                  [affilinode_search type="cordless_drill_driver" facets="brand,price,availability,field:voltage" per_page="12" view="grid"]
                
  • type = Produktart (samt Unterarten), leer = alle deine Produkte. Im Block wählst du die Kategorie aus der Liste.
  • facets = welche Filter in welcher Reihenfolge: brand (Marke), price (aktueller Preis von–bis), availability (lieferbar) und Felder der technischen Daten als field:<Feld>, z. B. field:display_size. Auswahl- und Ja/Nein-Felder erscheinen als Kästchen mit Zahl, Zahlenfelder als Von–bis. Leer = Marke, Preis, Verfügbarkeit und die wichtigsten Felder der Produktart.
  • per_page = Treffer je Seite (1–48, Standard 12), view = grid oder list, columns, title, title_style, tracking.
  • scope = site sucht nur in den Produkten, die diese Website schon einbindet; leer = alle Produkte deines Kontos.
  • Mehrere Werte eines Filters gelten mit „oder“, verschiedene Filter mit „und“. Die Zahlen neben den Werten berücksichtigen die übrigen Filter schon.
  • Der Suchzustand steht in der Adresse (z. B. ?acs_q=bosch&acs_f[brand][]=Bosch). Gefilterte Seiten lassen sich teilen und verlinken; ohne JavaScript funktioniert die Suche als normales Formular. Pro Seite eine Suche.
  • Preise: Filter und Sortierung nach Preis nutzen nur aktuelle Preise (Amazon höchstens 24 Stunden alt), eBay-Angebote aus der eBay-API zählen nicht. Nach Ersparnis wird nicht sortiert (Amazon: Preissignal).
  • Die Trefferzahl wird Screenreadern angesagt; Klicks zählen in der Auswertung als Box-Art „Produktsuche“.

Kompatibilitäts-Check „Passt das zu meinem …?“

affilinode_compat (Block „Kompatibilitäts-Check“) lässt Besucher ihr System wählen – Smart-Home-Zentrale, Ökosystem, Funkstandard, Akku-System, Prozessor-Sockel oder Objektivanschluss – und zeigt die passenden Produkte mit dem Hinweis „Kompatibel laut <Quelle>“. Mit product prüft die Box ein einzelnes Produkt und antwortet mit Ja, Nein oder Unbekannt samt Begründung und Quellen.

                  [affilinode_compat kind="hub" type="smart_plug"]
[affilinode_compat system="battery:boschprofessional18v" choose="0" type="cordless_drill_driver"]
[affilinode_compat product="<Produkt-ID>"]
                
  • system = vorgewähltes System als <Art>:<Wert>, z. B. hub:zigbee2mqtt, hub:zha, ecosystem:matter, radio:zigbee, battery:boschprofessional18v, socket:am5, lens_mount:sony_e. Im Block und im Generator wählst du aus der Liste der Systeme, zu denen deine Produkte Daten haben. choose="0" zeigt nur dieses System ohne Auswahl.
  • kind = nur diese Arten wählbar (hub, ecosystem, radio, battery, socket, lens_mount), type = nur Treffer dieser Produktart, product = dieses Produkt prüfen (auch asin oder ean) statt Produkte aufzulisten.
  • per_page (1–48, Standard 12), sort (leer = Beliebtheit, price, -price, title), view = grid oder list, columns, title, title_style, tracking.
  • Woher die Angaben kommen: Gerätelisten von Zigbee2MQTT, ZHA, deCONZ, Z-Wave JS, Home Assistant, ESPHome, Tasmota und openHAB, die Matter-Zertifizierung, SmartThings sowie die technischen Daten deiner Produkte. Hast du ein Feld selbst überschrieben oder ausgeblendet, gilt dein Wert.
  • „Nein“ kommt nur bei eindeutigen Angaben, z. B. anderes Akku-System, anderer Sockel oder ein reines WLAN-Gerät bei Zigbee2MQTT. Nennt eine Liste ein System nur nicht, heißt die Antwort „Unbekannt“.
  • Das gewählte System steht in der Adresse (?acc_system=hub:zha); ohne JavaScript ist die Box ein normales Formular. Quellen-Links führen nur zu den öffentlichen Gerätelisten, nie zu Amazon. Klicks zählen als Box-Art „Kompatibilitäts-Check“.

Bester in der Kategorie (automatische Top 3)

affilinode_top (Block „Bester in der Kategorie“) zeigt die besten Produkte einer Produktart aus deinem Konto – samt Unterarten, ohne Varianten – als Podium mit Platz 1 in der Mitte, Badge auf Platz 1 und einer Begründung je Platz („Beste Testnote: 1,4 (sehr gut)“, „Meiste mAh je Euro“). Die Rangfolge entsteht bei jedem Abruf neu und folgt so neuen Testnoten, Datenblättern und Preisen von selbst.

                  [affilinode_top type="smartphone" by="rating" limit="3"]
[affilinode_top type="smartphone" by="value"]
[affilinode_top type="power_bank" by="value:battery_capacity"]
[affilinode_top type="smartphone" by="field:battery_capacity" badge="Bester Akku"]
                
  • by="rating" (Standard): deine Testnote aus den Testbewertungen im Dashboard, Badge „Testsieger“.
  • by="value": Preis-Leistung – die Kernwerte der Produktart (z. B. Akku, Speicher, Kamera) im Verhältnis zum besten Produkt, geteilt durch den aktuellen Preis; Badge „Preis-Leistungs-Sieger“. by="value:<feld>" nimmt einen einzelnen Wert je Euro („Meiste mAh je Euro“). Es zählen nur Produkte mit aktuellem Preis; wer weniger als die Hälfte der Kernwerte hat, kommt nicht in die Wertung.
  • by="field:<feld>": ein Datenblattwert; ob mehr oder weniger besser ist, kommt aus der Produktart (z. B. weniger Gewicht). Badge „Bestwert: <Wert>“ – mit badge="…" eigener Text wie „Bester Akku“. Im Block und im Generator wählst du „Datenblattwert“ und trägst den Feldschlüssel ein.
  • limit (1–10, Standard 3), view = podium (Standard), grid oder list, columns (Raster), scope="site" nur Produkte dieser Website, available="0" auch Produkte ohne aktuellen Preis (nicht bei Preis-Leistung), reasons="0" ohne Begründungen, title (leer = automatische Überschrift), title_style, tracking.
  • Preise zählen nur aktuell (Amazon höchstens 24 Stunden alt, eBay-API-Angebote nicht); die Begründungen nennen nie Preise, Ersparnisse oder Tiefstpreise. Nutzt dein Konto Amazon, zeigt die Box keine Preis-Leistungs-Wertung (by="value") – sie vergleicht aktuelle Preise, was das Amazon-Partnerprogramm auf solchen Websites nicht erlaubt; Redakteure sehen dann einen Hinweis. Testnote und Datenblattwerte gehen immer.
  • Die Rangfolge wird fünf Minuten zwischengespeichert. Auf breiten Flächen zeigt das Podium Platz 2 – 1 – 3; Screenreader und Tastatur gehen immer 1, 2, 3. Klicks zählen als Box-Art „Bester in der Kategorie“.

Preis-Leistungs-Diagramm

affilinode_scatter (Block „Preis-Leistungs-Diagramm“) zeigt die Produkte einer Produktart aus deinem Konto als Streudiagramm: nach rechts der aktuelle Preis, nach oben ein Datenblattwert wie Akkukapazität oder Drehmoment – ein Punkt je Produkt. Eine Zeile unter der Überschrift sagt, wo „besser“ liegt (z. B. „weiter links und weiter oben“); das hervorgehobene Produkt, meist das des Beitrags, ist größer, umrandet und beschriftet.

                  [affilinode_scatter type="cordless_drill_driver" field="torque_max"]
[affilinode_scatter type="smartphone" field="battery_capacity" highlight="<Produkt-ID>"]
[affilinode_scatter type="power_bank" field="battery_capacity" scope="site" table="1"]
                
  • field: ein Zahlenfeld der Produktart (Feldschlüssel, z. B. battery_capacity, weight, torque_max); die Achse zeigt seine Einheit. Ob mehr oder weniger besser ist, kommt aus der Produktart.
  • highlight: Produkt-ID oder Kennung (z. B. asin:B0…). Es erscheint immer, auch als Ausreißer; fehlt ihm der aktuelle Preis oder der Wert, sehen Redakteure einen Hinweis. Im Block und im Generator ist das gewählte Produkt das hervorgehobene.
  • limit (1–100, Standard 60; bei mehr Produkten die beliebtesten), scope="site" nur Produkte dieser Website, height = 240, 320 oder 400 (leer = automatisch), table="1" Tabelle aufgeklappt, title (leer = automatische Überschrift), tracking.
  • Jeder Punkt ist ein Link zum Angebot, aus dem sein Preis stammt – mit Klick-Tracking und per Tastatur erreichbar. Zeiger oder Fokus zeigen Titel, Preis, Wert und Shop. Darunter stehen alle Werte in einer aufklappbaren Tabelle (auch für Screenreader und ohne JavaScript). Extreme Ausreißer (z. B. ein vergoldetes Sammlermodell) fallen heraus und werden gezählt.
  • Preise zählen nur aktuell (Amazon höchstens 24 Stunden alt, eBay-API-Angebote nicht); die Punkte werden fünf Minuten zwischengespeichert. Nutzt dein Konto Amazon, erscheint das Diagramm nur, wenn kein Preis darin von Amazon stammt – es vergleicht aktuelle Preise, was das Amazon-Partnerprogramm auf solchen Websites nicht erlaubt. Besucher sehen dann nichts, Redakteure einen Hinweis (oft hilft scope="site"). Klicks zählen als Box-Art „Preis-Leistungs-Diagramm“.

Listen und Raster als Karussell

Mit view="carousel" zeigen affilinode_list, affilinode_products, affilinode_amazon_list, affilinode_deals und affilinode_context ihre Karten in einer Reihe, durch die Besucher wischen, scrollen oder mit den Pfeilen oben rechts blättern. Im Block, in Elementor und im Shortcode-Generator heißt die Darstellung „Karussell“.

                  [affilinode_list id="<Listen-ID>" view="carousel"]
[affilinode_products ids="…" view="carousel" columns="4"]
[affilinode_list view="<Sicht>" template="carousel" autoplay="6"]
                
  • columns (2–4) bestimmt, wie viele Karten auf breiten Flächen nebeneinander zu sehen sind; schmaler werden es zwei, auf dem Handy eine mit angeschnittener nächster Karte. Die Breite steht fest – beim Laden und Blättern springt nichts.
  • Eine Kategorie-Sicht als Karussell: template="carousel" (view ist dort der Name der Sicht).
  • Kein automatischer Wechsel, außer du setzt autoplay="<Sekunden>" (3–30). Dann erscheint ein Knopf zum Anhalten; der Wechsel pausiert, solange der Zeiger darauf liegt, und hält an, sobald der Tastaturfokus hineinkommt. Bei „Bewegung reduzieren“ im Betriebssystem startet er nicht von selbst.
  • Barrierefrei nach dem Karussell-Muster des W3C (APG): Bereich „Karussell“ mit Namen, Folien „2 von 8“, beschriftete Knöpfe, Pfeiltasten von Karte zu Karte sowie Pos1/Ende, eine Statuszeile für Screenreader („Produkte 4 bis 6 von 8“). Ohne JavaScript bleibt eine scrollbare Reihe mit allen Karten.
  • Ohne Bibliothek: Das kleine Skript lädt nur auf Seiten mit einem Karussell.

Sortieren und filtern pro Shortcode

Listen, Produkt-Grids und Amazon-Bestseller lassen sich in einem Beitrag anders sortieren und filtern, ohne die Liste in affilinode zu ändern (wie orderby und filter bei AAWP). Beim Sortieren oder Filtern lädt das Plugin die ganze Liste und kürzt erst danach auf limit.

                  [affilinode_list id="bestenliste" sort="price" only_available="1" limit="3"]
                
  • sort = price (günstigster zuerst), -price (teuerster zuerst), rating (Kundenbewertung), discount (Ersparnis gegenüber dem Streichpreis des Shops), title (alphabetisch) oder position (Reihenfolge der Liste, Standard). Mit Sortierung zählen die Platznummern neu. In affilinode_amazon_list heißt das Attribut order, weil sort dort Bestseller oder Neuerscheinungen wählt.
  • only_available = 1 zeigt nur Produkte mit lieferbarem Angebot (nach Ersatzprodukten), min_discount = 10 nur Produkte mit mindestens 10 % Ersparnis, brand = Marken mit Komma (z. B. brand="Bosch,Siemens"), limit = Höchstzahl danach.
  • Gilt für affilinode_list (auch mit view), affilinode_products und affilinode_amazon_list; affilinode_deals kennt sort und brand, affilinode_offers kennt only_available = 1 (ohne nicht lieferbare Angebote).
  • Es zählt nur der Preis, der auch angezeigt wird: der aktuelle Bestpreis eines Shops. Veraltete Preise und eBay-Angebote aus der eBay-API (eigener Block) zählen weder für den Preis noch für die Ersparnis; Produkte ohne Wert stehen hinten.
  • Amazon: Ohne schriftliche Ausnahme gelten Sortieren und Filtern nach Ersparnis als Preissignale (Richtlinie 6(y)) – discount und min_discount werden dann ignoriert, angemeldete Redakteure sehen einen Hinweis. Nach dem aktuellen Preis sortieren geht weiter.
  • Blöcke, Elementor und der Shortcode-Generator (unter „Erweitert“) bieten dieselben Felder. In der Einbettung (Ghost, Discourse, HTML) kennen Liste und Deals data-sort = price, -price, rating oder title und data-only-available = 1.

Nicht verfügbare Einzelboxen ausblenden

hide_unavailable = 1 an affilinode_product, affilinode_button, affilinode_link oder affilinode_field blendet die Box aus, wenn das Produkt bei keinem Shop erhältlich ist. Ein verfügbarer Nachfolger oder eine Alternative geht vor (Einstellung „Ersatzprodukt anzeigen“) – dann erscheint wie bisher der Ersatz. Sonst sehen Besucher nichts, angemeldete Redakteure einen kurzen Hinweis. Die Einstellung „Nicht verfügbare Einzelboxen ausblenden“ (Darstellung, Standard aus) gilt für alle Produktboxen und Buttons; hide_unavailable = 0 behält eine einzelne Box trotzdem. Textlinks und Felder im Fließtext blenden nur mit dem Attribut aus, damit kein Satz ein Wort verliert.

                  [affilinode_product asin="B0CXYZ1234" hide_unavailable="1"]
                

Blöcke und Shortcode-Generator

Im Block-Editor gibt es dieselben Darstellungen als Blöcke, z. B. „Produktbox“, „Produkt-Grid“, „Produktliste“, „Deals“, „Preisvergleich“, „Produktvergleich“, „Vergleichs-Auswahl“, „Produktsuche“, „Produktberater“, „Kompatibilitäts-Check“, „Bester in der Kategorie“, „Auf einen Blick“, „Preis-Leistungs-Diagramm“, „Folgekosten“, „Preisverlauf“, „Preisalarm“, „Tarifrechner“, „Ersatzteile“, „Zubehör“, „Kaufen-Button“, „Textlink“ und „Produktfeld“. Im Block suchst du das Produkt nach Titel, Marke, ASIN, EAN oder MPN, statt IDs zu tippen. Wer lieber Shortcodes nutzt, baut sie unter „affilinode“ → „Shortcode-Generator“ mit Live-Vorschau zusammen. Die Seite „affilinode“ → „Produkte“ zeigt zu jedem Produkt den fertigen Shortcode mit Kopieren-Knopf.

Standard-Darstellungsmodus ist „Hybrid“: Die Box steht sofort im HTML und wird nur nachgeladen, wenn das Land abweicht oder die Preise zu alt sind. Das passt zu Seiten-Caches.

Andere Amazon-Tracking-ID für eine Box oder einen Beitrag

Amazon-Links tragen normalerweise die Tracking-ID der Website (Websites → Tracking-IDs). Für eine einzelne Box setzt du tracking="…" – das kennen alle Shortcodes und Blöcke mit Affiliate-Links, auch Textlink, Einzelfeld, die Amazon-Bestseller und die PHP-Funktionen. Für einen ganzen Beitrag gibt es in der Seitenleiste des Block-Editors (bzw. im klassischen Editor rechts) das Feld „Amazon-Tracking-ID für diesen Beitrag“.

                  [affilinode_product asin="B0CXYZ1234" tracking="meinblog-21"]
                
  • Vorrang: Box vor Beitrag vor Website. Ersetzt wird nur der Parameter tag von Amazon-Links; andere Shops, Klickstatistik und Matomo bleiben, wie sie sind.
  • Erlaubt sind Buchstaben, Ziffern und Bindestriche, höchstens 64 Zeichen (z. B. meinblog-21). Ungültige Werte zählen nicht – angemeldete Redakteure sehen an der Box einen Hinweis.
  • Auch nachgeladene Boxen (Ajax, Hybrid) und der Vergleichswähler nutzen dieselbe Tracking-ID.
  • Für die Auswertung unter „Einnahmen“ meldet das Plugin solche Tracking-IDs beim Speichern an affilinode; sie stehen dann unter Websites → Tracking-IDs → „Weitere Tracking-IDs (nur Auswertung)“, und Umsätze damit werden der Website bzw. Unterseite zugeordnet.

Alle Hilfe-Artikel · Frage offen? Schreib uns