Zum Hauptinhalt springen

Hooks & Filters

Du kannst an mehreren Stellen mit Hilfe von WordPress Hooks die Darstellung der Beitragsempfehlungen erweitern. Hierzu sind bereits folgende Hooks hinterlegt:

Hook-Positionen​

Feed​

symplr_engage_after_feed_block_0 ... symplr_engage_after_feed_block_11 sind die 12 hooks, mit denen du Inhalte zwischen die einzelnen Empfehlungs-"Zeilen" hängen kannst.

In-Single​

symplr_engage_before_text_ad_0, symplr_engage_after_text_ad_0 sind die hooks, mit denen du vor/nach einer in-Text-Empfehlung Inhalte ausspielen kannst. die 0 kannst du einfach anpassen, um die anderen in-Text Widgets anzusprechen.

Inline-Group​

Bei der Inline-Group gibt es zwei Ebenen, auf denen Hooks platziert sind:

  • symplr_engage_before_inline_group_0, symplr_engage_after_inline_group_0 sind die hooks, mit denen du vor/nach einer Inline-Group Inhalte ausspielen kannst. die 0 kannst du einfach anpassen, um die anderen inline-group Widgets anzusprechen.
  • symplr_engage_inline_group_0_before_pos_1 sowie symplr_engage_inline_group_0_after_pos_1 sind die hooks, mit denen du innerhalb einer Inline-Group Inhalte vor oder nach einer einzelnen Empfehlung ausspielen kannst. die Werte 0 und 1 kannst du einfach anpassen, um die anderen Positionen innerhalb von Inline-Group-Widgets anzusprechen.

Filter​

Der Output jedes Widgets kann über einen Filter angepasst werden. Die dazu definierten Filtermöglichkeiten lauten:

Widget-NameFilter
Inline – Singlewp_engage_widget_inline_single
Inline – Groupwp_engage_widget_inline_group_1, wp_engage_widget_inline_group_2,...
Sidebar – Top-Postswp_engage_widget_sidebar_top_posts
Sidebar – Recommendationswp_engage_widget_sidebar_recommended_posts
Feedwp_engage_widget_after_post_feed

Einrichtung von Hooks​

Um an einem Hook eigene Inhalte auszugeben, hier ein paar Beispiele

Ausführen von HTML-Code​

add_action('symplr_engage_after_text_ad_0', function () { ?>
    <div id="eine_div_id">
        Dies ist ein Text, der dann genau an der Stelle des Hooks ausgegeben wird.
    </div>
<?php }, 10);

Ausführen eines Shortcodes​

add_action('symplr_engage_after_feed_block_3', function () {
    echo do_shortcode("[ein_wordpress_shortcode parameter='irgendein Parameter']");
}, 10);

Ausführen einer PHP Funktion​

add_action('symplr_engage_after_feed_block_2', function () {
    echo eine_php_funktion();
}, 10);