disable_captions │ filter-hook │ WP 2.6.0

Filters whether to disable captions.

Prevents image captions from being appended to image HTML when inserted into the editor.

Usage

add_filter( 'disable_captions', 'wp_kama_disable_captions_filter' );

/**
 * Function for `disable_captions` filter-hook.
 * 
 * @param bool $bool Whether to disable appending captions. Returning true from the filter will disable captions.
 *
 * @return bool
 */
function wp_kama_disable_captions_filter( $bool ){

	// filter...
	return $bool;
}

$bool(true|false)

Whether to disable appending captions. Returning true from the filter will disable captions.
Default: empty string

Changelog

Where the hook is called

if ( empty( $caption ) || apply_filters( 'disable_captions', '' ) ) {

if ( ! apply_filters( 'disable_captions', '' ) ) {

if ( ! apply_filters( 'disable_captions', '' ) ) {

if ( apply_filters( 'disable_captions', '' ) ) {

if ( apply_filters( 'disable_captions', '' ) ) {

'captions'          => ! apply_filters( 'disable_captions', '' ),

if ( ! apply_filters( 'disable_captions', '' ) ) :

if ( ! apply_filters( 'disable_captions', '' ) ) :

Where the hook is used in WordPress