Actions and Filters

WordPress has the feature of “hooks” with which users can add extra functionality to WordPress and its plugins and themes. Super RSS Reader has included below hooks using which you can manipulate/customize the plugin output as needed.

Using hooks

If you use a hook to add or manipulate code, you can add your custom code in a variety of ways:

Filters

This type of hook allows to tap into the plugin process and manipulate/tweak before it is processed. Below are the filters supported by Super RSS Reader.

srr_mod_item_html

This filter allows to tweak the feed item’s HTML before it is displayed. It supports 3 parameters.

Parameters

apply_filters( 'srr_mod_item_html', $html, $feed_url, $feed_item );
  • $html (array) – An array which contains the elements to modify. See supported keys below.
    • title – The title HTML of the feed item.
    • meta – The metadata HTML of the feed item.
    • thumbnail – The thumbnail HTML of the feed item.
    • description – The description HTML of the feed item.
    • before – HTML to display before the feed item.
    • after – HTML to display after the feed item.
  • $feed_url (string) – The feed URL which is under process.
  • $feed_item __(SimplePie_Item)__ – The current feed item’s SimplePie_item object.

Example

<?php
    add_filter( 'srr_mod_item_html', 'my_srr_modifier', 10, 3 );

    // This example modifies the title tag and appends a text to it.

    function my_srr_modifier( $html, $feed_url, $feed_item ){
        $html[ 'title' ] = $html[ 'title' ] . ' extra text';
        return $html;
    }
?>

srr_mod_thumbnail_url

This filter allows to change the feed item’s thumbnail URL.

Parameters

apply_filters( 'srr_mod_thumbnail_url', $thumbnail_url, $item, $feed, $default_url );
  • $thumbnail_url (string) – The thumbnail URL retrieved from the feed.
  • $item __(SimplePie_Item)__ – The current feed item’s SimplePie_item object.
  • $feed (SimplePie) – The feed’s SimplePie object.
  • $default_url (string) – The default thumbnail URL as mentioned in settings.

Example

<?php
    add_filter( 'srr_mod_thumbnail_url', 'srr_change_thumbnail_url', 10, 4 );

    // This example sets the feed's top level image as the thumbnail for all items. If not present then sets the default thumbnail URL.

    function srr_change_thumbnail_url( $thumbnail_url, $item, $feed, $default_url ){
        $feed_level_image = $feed->get_image_url();
        if( !empty( $feed_level_image ) ){
            return $feed_level_image;
        }else{
            return $default_url;
        }
    }
?>

srr_mod_source_html

This filter allows to change the source feed text when multiple RSS feeds are merged into one (only in PRO version).

Parameters

apply_filters( 'srr_mod_source_html', $source, $item, $feed );
  • $source (string) – The source text HTML.
  • $item __(SimplePie_Item)__ – The current feed item’s SimplePie_item object.
  • $feed (SimplePie) – The feed’s SimplePie object.

Example

<?php
    add_filter( 'srr_mod_source_html', 'srr_change_source_text', 10, 4 );

    // This example changes the source text for all RSS feed URLs.

    function srr_change_source_text( $source, $item, $feed ){
        $source = '<a href="#">Custom feed source text</a>';
        return $source;
    }
?>

Actions

Actions allows to execute function at specific point during the execution. Right now Super RSS Reader does not have any actions.