API – Thumbnail – Introduction

Available on: Newspaper V11+

The td_api_thumb class allows you to add or modify a thumbnail. The thumbnails are used on modules which appear on loops and on blocks.

In Theme Panel you can find an option to disable cropping for the thumbs you don’t use. If you add a new thumb it will look like this:

The theme thumbnails are registered in td-composer/legacy/Newspaper/includes/td_config.php, the code looks like this:

td_api_thumb::add('td_150x0',
    array(
        'name' => 'td_150x0',
        'width' => 150,
        'height' => 0,
        'crop' => array('center', 'top'),
        'post_format_icon_size' => 'normal',
        'used_on' => array(
            'Flex blocks 1, 2, 3, 4, 5'
        ),
        'no_image_path' => TDC_URL_LEGACY . '/assets',
        'b64_encoded' => 'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAJYAAAB4AQMAAAAqgZlTAAAAA1BMVEWurq51dlI4AAAAAXRSTlMmkutdmwAAABlJREFUSMftwTEBAAAAwiD7p7bETmAAAKQOCWAAAaG6mx4AAAAASUVORK5CYII=',
    )
);

Parameters:

$id (string) (required)

  • the thumbnail id – if you add a new thumbnail the id has to be different from the ones used on the other thumbnails which are registered in theme, if you plan to modify one of the existing thumbnails the id has to match with the one you’re planing to modify.

$params_array (array) (required)

  • an array which contains the parameters of the thumbnail:
Key name
Type
Description
name string the thumbnail name
width integer the thumbnail width in pixels
height integer the thumbnail height in pixels
crop mixed the cropping method (array, true or false), it is passed to the add_image_size() function, for more information check the following resources – function – extra
post_format_icon_size string specify what play icon to load for video posts (small or normal)
used_on array the locations on which thumb appears, it’s just an info and appears in Theme Panel -> Block Settings