disable_captions
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
Since 2.6.0 | Introduced. |
Where the hook is called
disable_captions
disable_captions
disable_captions
disable_captions
disable_captions
wp-admin/includes/media.php 216
if ( empty( $caption ) || apply_filters( 'disable_captions', '' ) ) {
wp-includes/class-wp-editor.php 563
if ( apply_filters( 'disable_captions', '' ) ) {
wp-includes/script-loader.php 521
if ( apply_filters( 'disable_captions', '' ) ) {
wp-includes/media-template.php 1067
if ( ! apply_filters( 'disable_captions', '' ) ) :
wp-includes/media-template.php 1130
if ( ! apply_filters( 'disable_captions', '' ) ) :
wp-includes/media.php 4680
'captions' => ! apply_filters( 'disable_captions', '' ),
wp-admin/includes/media.php 2437
if ( ! apply_filters( 'disable_captions', '' ) ) {
wp-admin/includes/media.php 2921
if ( ! apply_filters( 'disable_captions', '' ) ) {