the_excerpt │ хук-фильтр │ WP 0.71

Применяется к содержимому поля "Отрывок / Цитата" записи, перед тем как вывести его на экран. Используется в функции the_excerpt().

Читайте описания функций the_excerpt() и get_the_excerpt(), чтобы узнать о других возможностях по изменению отрывка записи.

Использование

add_filter( 'the_excerpt', 'wp_kama_the_excerpt_filter' );

/**
 * Function for `the_excerpt` filter-hook.
 * 
 * @param string $post_excerpt The post excerpt.
 *
 * @return string
 */
function wp_kama_the_excerpt_filter( $post_excerpt ){

	// filter...
	return $post_excerpt;
}
$post_excerpt(строка)
Содержимое поля "Отрывок / Цитата".

Примеры

0

#1 Обернем содержимое отрывка в произвольный блок 

add_action( 'the_excerpt', 'modify_the_excerpt' );

function modify_the_excerpt( $post_excerpt ) {
	return '<div class="custom-block">' . $post_excerpt . '</div>';
}

Список изменений

С версии 0.71 Введена.

Где вызывается хук

the_excerpt()
the_excerpt
do_trackbacks()
the_excerpt
WP_REST_Attachments_Controller::prepare_item_for_response()
the_excerpt
WP_REST_Revisions_Controller::prepare_excerpt_response()
the_excerpt
WP_REST_Posts_Controller::prepare_item_for_response()
the_excerpt
wp-includes/post-template.php 399 
echo apply_filters( 'the_excerpt', get_the_excerpt() );
wp-includes/comment.php 2986 
$excerpt = apply_filters( 'the_excerpt', $post->post_excerpt );
wp-includes/rest-api/endpoints/class-wp-rest-attachments-controller.php 812 
$caption = apply_filters( 'the_excerpt', $caption );
wp-includes/rest-api/endpoints/class-wp-rest-revisions-controller.php 861 
$excerpt = apply_filters( 'the_excerpt', $excerpt, $post );
wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php 1879 
$excerpt = apply_filters( 'the_excerpt', $excerpt );

Где используется хук в WordPress

wp-includes/default-filters.php 202 
add_filter( 'the_excerpt', 'wptexturize' );
wp-includes/default-filters.php 203 
add_filter( 'the_excerpt', 'convert_smilies' );
wp-includes/default-filters.php 204 
add_filter( 'the_excerpt', 'convert_chars' );
wp-includes/default-filters.php 205 
add_filter( 'the_excerpt', 'wpautop' );
wp-includes/default-filters.php 206 
add_filter( 'the_excerpt', 'shortcode_unautop' );
wp-includes/default-filters.php 207 
add_filter( 'the_excerpt', 'wp_replace_insecure_home_url' );
wp-includes/default-filters.php 208 
add_filter( 'the_excerpt', 'wp_filter_content_tags', 12 );