Neben Shortcodes und Vorlagen stellt affiliate-toolkit globale PHP-Funktionen bereit, die einzelne Werte eines Produkts liefern – Titel, Preis, Affiliate-Link, Bilder, Angebote. Nutze sie, wenn du eine eigene Ausgabe in einer Theme-Datei, einem Page-Builder-Element oder einem eigenen Plugin baust und die Daten außerhalb einer Vorlage brauchst.
Die Funktionen kommen aus dem Basis-Plugin. Schließ deinen Code in function_exists() ein, damit dein Theme nicht abstürzt, wenn das Plugin deaktiviert ist.
Der Parameter $id
Fast jede Funktion erwartet als ersten Parameter eine $id. Sie bestimmt, welches Produkt verwendet wird:
- Leer – auf einer Produktseite das Produkt selbst, auf jedem anderen Beitrag dessen Hauptprodukt (oder, falls keines gesetzt ist, die Hauptliste).
- Produkt-ID – dieses Produkt.
- Listen-ID – das erste Produkt der Liste.
- Slug oder Titel – das Produkt bzw. die Liste mit diesem Slug oder Titel.
Die Funktionen nutzen immer das Hauptangebot des Produkts. Shop-Funktionen erwarten stattdessen eine Shop-ID; übergibst du eine Produkt-ID, wird der Shop dieses Produkts verwendet.
Beispiele
<?php if ( function_exists( 'atkp_get_title' ) ) : ?>
<a <?php echo atkp_get_productlink( 123 ); ?>>
<?php echo esc_html( atkp_get_title( 123 ) ); ?>
</a>
<?php echo atkp_get_saleprice_formatted( 123, 'nur %s', 'Preis auf Anfrage' ); ?>
<?php endif; ?>
Die …link-Funktionen liefern die Attribute eines <a>-Tags (href, rel, target und Link-Tracking), keinen vollständigen Link. Setz sie wie oben gezeigt in das öffnende Tag.
// Hauptprodukt des aktuellen Beitrags
$price = atkp_get_saleprice();
// erstes Produkt der Liste mit der ID 456
$title = atkp_get_title( 456 );
// Produkt über den Slug
$image = atkp_get_mediumimageurl( 'nordklang-anc-700' );
// eigener Preisvergleich
foreach ( (array) atkp_get_offers( 123 ) as $offer ) {
// $offer ist ein atkp_product_offer-Objekt
}Liste der Funktionen
| Funktion | Rückgabe | Beschreibung |
|---|---|---|
atkp_display_box( $ids, $template, $limit = 0, $field = '', $link = false, $content = '', $randomsort = false, $hidedisclaimer = false, $buttontype = 'notset', $tracking_id = '', $elementcss = '', $containercss = '', $ajax_mode = 'none' ) | string | Komplette HTML-Ausgabe einer Box oder Liste – das PHP-Gegenstück zum Shortcode [atkp]. |
atkp_get_product( $id = '' ) | atkp_product|null | Das Produktobjekt (Hauptangebot) zur Weiterverarbeitung. |
atkp_get_shop( $id ) | atkp_shop|null | Das Shop-Objekt. Ist $id kein Shop, kommt der Shop des Produkts zurück. |
atkp_get_formatter() | atkp_formatter | Ein Formatter-Objekt mit Standardparametern, wie es in Blade-Vorlagen genutzt wird. |
atkp_get_title( $id = '' ) | string | Produkttitel. |
atkp_get_short_title( $id = '' ) | string | Gekürzter Produkttitel. |
atkp_get_featuretext( $id = '' ) | string | Features (HTML-Liste). |
atkp_get_featuretext_short( $id = '' ) | string | Features, gekürzt. |
atkp_get_descriptiontext( $id = '' ) | string | Produktbeschreibung. |
atkp_get_descriptiontext_short( $id = '' ) | string | Produktbeschreibung, gekürzt. |
atkp_get_infotext( $id = '' ) | string | Infotext (Preishinweis, Aktualisierungsdatum). |
atkp_get_pro_list( $id = '', $content_mask = '%s' ) | string | Vorteile; $content_mask formatiert jeden Eintrag. |
atkp_get_contra_list( $id = '', $content_mask = '%s' ) | string | Nachteile; $content_mask formatiert jeden Eintrag. |
atkp_get_test_badge( $id = '' ) | string | Testergebnis-Siegel. |
atkp_get_saleprice( $id = '' ) | float | Verkaufspreis als Zahl (0, wenn unbekannt). |
atkp_get_saleprice_formatted( $id = '', $format = '%s', $emptytext = '' ) | string | Formatierter Verkaufspreis; $emptytext erscheint, wenn es keinen Preis gibt. |
atkp_get_listprice( $id = '' ) | float | Listenpreis als Zahl. |
atkp_get_listprice_formatted( $id = '', $format = '%s', $emptytext = '' ) | string | Formatierter Listenpreis. |
atkp_get_amount_saved( $id = '' ) | float | Ersparnis als Zahl. |
atkp_get_amount_saved_formatted( $id = '', $format = '%s' ) | string | Formatierte Ersparnis. |
atkp_get_percentage_saved( $id = '' ) | float | Ersparnis in Prozent als Zahl. |
atkp_get_percentage_saved_formatted( $id = '', $format = '-%s%%' ) | string | Formatierte Ersparnis in Prozent, z. B. -15%. |
atkp_get_baseprice( $id = '' ) | float | Grundpreis als Zahl. |
atkp_get_baseprice_formatted( $id = '', $format = '(%s / %s)', $emptytext = '' ) | string | Formatierter Grundpreis mit Einheit. |
atkp_get_unitprice( $id = '' ) | float | Stückpreis als Zahl. |
atkp_get_shipping( $id = '' ) | float | Versandkosten als Zahl. |
atkp_get_shipping_formatted( $id = '', $format = '%s', $emptytext = '' ) | string | Formatierte Versandkosten. |
atkp_get_producturl( $id = '' ) | string | Affiliate-URL des Produkts. |
atkp_get_productlink( $id = '' ) | string | Link-Attribute (href, rel, target, Tracking) für ein <a>-Tag. |
atkp_get_addtocarturl( $id = '' ) | string | Warenkorb-URL (sofern der Shop sie unterstützt). |
atkp_get_addtocartlink( $id = '' ) | string | Link-Attribute für den Warenkorb-Link; sonst der Produktlink. |
atkp_get_button_link( $id = '' ) | string | Link-Attribute für den Kaufen-Button, je nach Button-Einstellung. |
atkp_get_button_text( $id = '', $shop_id = '' ) | string | Button-Text des Shops. |
atkp_get_title_link( $id = '' ) | string | Link-Attribute für den Produkttitel. |
atkp_get_customerreviewsurl( $id = '' ) | string | URL der Kundenbewertungen. |
atkp_get_reviews_link( $id = '' ) | string | Link zu den Kundenbewertungen. |
get_get_reviews_text( $id = '' ) | string | Text mit der Anzahl der Bewertungen. Der ungewöhnliche Name bleibt für ältere Vorlagen erhalten. |
atkp_get_primelogo( $id = '' ) | string | Prime-Logo, wenn das Angebot Prime ist. |
atkp_get_smallimageurl( $id = '' ) | string | URL des kleinen Bilds. |
atkp_get_mediumimageurl( $id = '' ) | string | URL des mittleren Bilds. |
atkp_get_largeimageurl( $id = '' ) | string | URL des großen Bilds. |
atkp_get_images( $id = '', $include_main_image = true, $max_images = 0 ) | array|null | Alle Bilder des Produkts (0 = ohne Begrenzung). |
atkp_get_offers( $id = '', $include_main_offer = true, $max_offers = 0 ) | atkp_product_offer[]|null | Alle Angebote des Produkts für einen eigenen Preisvergleich. |
atkp_get_custom_field( $id, $field_name ) | string | Formatierter Wert eines eigenen Felds (Modul Eigene Felder). |
atkp_get_updatedate( $id = '' ) | string | Datum der letzten Aktualisierung. |
atkp_get_updatetime( $id = '' ) | string | Uhrzeit der letzten Aktualisierung. |
atkp_get_disclaimer( $id = '', $disclaimertext = '' ) | string | Disclaimer-Text; $disclaimertext ersetzt den Standardtext. |
atkp_get_product_page_url( $id = '' ) | string|null | URL der Produktseite (Modul Frontend-Produktseiten). |
atkp_get_woocommerce_page_url( $id = '' ) | string | URL des verknüpften WooCommerce-Produkts. |
atkp_get_shop_title( $shop_id = '' ) | string | Name des Shops. |
atkp_get_shop_logo( $shop_id = '' ) | string | Shop-Logo als Bild-Tag. |
atkp_get_shop_logo_url( $shop_id = '' ) | string | URL des Shop-Logos. |
Fehlt am Produkt ein Wert (etwa kein Listenpreis), bekommst du einen leeren String, 0 bei Zahlen oder null bei Arrays. Übergib nur IDs, Slugs oder Titel, die es gibt – ein unbekannter Wert führt derzeit zu einem PHP-Fehler statt zu einem leeren Ergebnis.