Filters

There are several filters you can use to control and customize what the plugin does.

gtaxi_get_taxonomy_image_default_args

Allows modifications to the default arguments.

// Set the default options
$defaults = array(
	'format'   => 'html',
	'size'     => 'full',
	'attr'     => '',
	'fallback' => 'placeholder',
	'term'     => '',
);

/**
 * Filter the default options
 *
 * @since 0.8.0
 *
 * @param array $defaults The default options.
 */
$defaults = apply_filters( 'gtaxi_get_taxonomy_image_default_args', $defaults );

gtaxi_get_taxonomy_image

Filters the returned value before it’s returned.

/**
 * Filter the retrieved and calculated values
 *
 * @since 0.8.0
 *
 * @param string $output The requested image in the requested 'format'. Note: if not filtering, this is what is returned
 * @param string $args The arguments used
 * @param string $term_image_id The ID of the image
 * @param string $url The full url to the image
 */
return apply_filters( 'gtaxi_get_taxonomy_image', $output, $args, $term_image_id, $url );

gtaxi_get_taxonomies

Filters the taxonomies that the plugin will work with. Use this to enable only for specific taxonomies.

/**
 * gtaxi_get_taxonomies to filter the list of applicable taxonomies.
 *
 * By default, all public taxonomies that have a public UI are returned
 *
 * @since 0.8.1
 *
 * @param array array Results from get_taxonomies( array( 'show_ui' => true ) )
 */
return apply_filters( 'gtaxi_get_taxonomies', get_taxonomies( array( 'show_ui' => true ) ) );

gtaxi_get_placeholder_img_src

Allows you to set the default image instead of the built-in one.

/**
 * gtaxi_get_placeholder_img_src to filter the placeholder image.
 *
 * By default, uses a provided image
 *
 * @since 0.8.0
 *
 * @param string void URL to default image
 */
return apply_filters( 'gtaxi_get_placeholder_img_src', TIG_URL . $this->default_placeholder_img_src, TIG_BASENAME );