Разрешить HTML в выдержке
Ответы:
ПОЛНОЕ РУКОВОДСТВО ПО ЭКСПЕРТАМ
Я недавно ответил на несколько вопросов относительно выдержек, поэтому я собираюсь дать подробное объяснение, охватывающее как можно больше.
ПРЕДИСЛОВИЕ
Похоже, из этого ответа возникла пара вопросов о том, куда должен идти код, и ответ таков: это действительно ваше дело и то, как вы считаете нужным. Существует несколько вариантов размещения кода (если это не указано явно):
В вашей теме functions.php или любой файл использовать в качестве файла функций. Просто помните, что когда вы делаете это, если тема не ваша, все изменения будут потеряны при обновлении вашей темы.
Лучшим способом было бы использовать код в дочерней теме. Как и выше, в файле functions.php или функциях, связанных с
Используйте код в плагине. Это предпочтительный способ, поскольку это делает код доступным для всех тем. Если вы переключаете темы, вам не нужно беспокоиться о переписывании того же кода.
Надеюсь, это немного прояснит ситуацию :-)
HTML-теги / форматирование
the_excerpt()в первую очередь не принимает никаких параметров, поэтому ничего нельзя передать ему. Это факт, который the_excerpt()сокращает содержимое до 55 слов, и все теги HTML удаляются перед возвратом текста. the_excerpt()находится в wp-includes / post-template.php . Чтобы разрешить определенные или все теги HTML в выдержке, необходимо создать новую выдержку.
Прежде всего, сначала необходимо удалить исходную функцию, а затем подключить новую функцию get_the_excerpt. Обратите внимание, что этот новый отрывок будет по-прежнему вызываться так же, как и the_excerpt()в файлах шаблонов, изменять его не нужно. get_the_excerpt()находится в wp-includes / post-template.php .
Отрывок используется wp_trim_excerptдля возврата обрезанного текста, поэтому нам нужно wp_trim_excerptсначала удалить его из фильтра отрывков. wp_trim_excerpt()находится в wp-includes / formatting.php , строка 2355. Вот как:
remove_filter('get_the_excerpt', 'wp_trim_excerpt');Теперь вы можете добавить свой новый отрывок в get_the_excerpt
add_filter('get_the_excerpt', 'wpse_custom_wp_trim_excerpt');Чтобы разрешить HTML-теги / форматирование, нам нужно указать, какие теги вам нужно разрешить. Вы можете использовать следующее strip_tagsутверждение для достижения этого
$wpse_excerpt = strip_tags($wpse_excerpt, wpse_allowedtags());Второй аргумент wpse_allowedtags()- это небольшая функция, которая используется для добавления the_excerpt()разрешенных тегов . Полный список допустимых тегов HTML 5 можно найти здесь . Вот функция, добавьте к ней любые HTML-теги, которые вам нужно разрешить / сохранить.
function wpse_allowedtags() {
// Add custom tags to this string
return '<script>,<style>,<br>,<em>,<i>,<ul>,<ol>,<li>,<a>,<p>,<img>,<video>,<audio>';
}
Если вам нужно разрешить все теги HTML, то есть не strips_tags()удалять теги, функция может быть полностью исключена / удалена.
Однако следует отметить, что, когда html-теги разрешены, эти теги считаются словами, поэтому ваш счетчик слов для выдержек с тегами и без тегов не будет одинаковым. Чтобы исправить это, вам нужно сначала удалить эти теги из фактического количества слов, чтобы учитывались только слова.
Я написал отрывок, который позволит использовать все теги, считать только слова как слова и завершит предложение после заданного количества слов (чтобы текст не был обрезан в середине предложения) и добавил текст для чтения после последнего слова. ,
Вот полный код
function wpse_allowedtags() {
// Add custom tags to this string
return '<script>,<style>,<br>,<em>,<i>,<ul>,<ol>,<li>,<a>,<p>,<img>,<video>,<audio>';
}
if ( ! function_exists( 'wpse_custom_wp_trim_excerpt' ) ) :
function wpse_custom_wp_trim_excerpt($wpse_excerpt) {
$raw_excerpt = $wpse_excerpt;
if ( '' == $wpse_excerpt ) {
$wpse_excerpt = get_the_content('');
$wpse_excerpt = strip_shortcodes( $wpse_excerpt );
$wpse_excerpt = apply_filters('the_content', $wpse_excerpt);
$wpse_excerpt = str_replace(']]>', ']]>', $wpse_excerpt);
$wpse_excerpt = strip_tags($wpse_excerpt, wpse_allowedtags()); /*IF you need to allow just certain tags. Delete if all tags are allowed */
//Set the excerpt word count and only break after sentence is complete.
$excerpt_word_count = 75;
$excerpt_length = apply_filters('excerpt_length', $excerpt_word_count);
$tokens = array();
$excerptOutput = '';
$count = 0;
// Divide the string into tokens; HTML tags, or words, followed by any whitespace
preg_match_all('/(<[^>]+>|[^<>\s]+)\s*/u', $wpse_excerpt, $tokens);
foreach ($tokens[0] as $token) {
if ($count >= $excerpt_length && preg_match('/[\,\;\?\.\!]\s*$/uS', $token)) {
// Limit reached, continue until , ; ? . or ! occur at the end
$excerptOutput .= trim($token);
break;
}
// Add words to complete sentence
$count++;
// Append what's left of the token
$excerptOutput .= $token;
}
$wpse_excerpt = trim(force_balance_tags($excerptOutput));
$excerpt_end = ' <a href="'. esc_url( get_permalink() ) . '">' . ' » ' . sprintf(__( 'Read more about: %s »', 'wpse' ), get_the_title()) . '</a>';
$excerpt_more = apply_filters('excerpt_more', ' ' . $excerpt_end);
//$pos = strrpos($wpse_excerpt, '</');
//if ($pos !== false)
// Inside last HTML tag
//$wpse_excerpt = substr_replace($wpse_excerpt, $excerpt_end, $pos, 0); /* Add read more next to last word */
//else
// After the content
$wpse_excerpt .= $excerpt_more; /*Add read more in new paragraph */
return $wpse_excerpt;
}
return apply_filters('wpse_custom_wp_trim_excerpt', $wpse_excerpt, $raw_excerpt);
}
endif;
remove_filter('get_the_excerpt', 'wp_trim_excerpt');
add_filter('get_the_excerpt', 'wpse_custom_wp_trim_excerpt');
Вы можете просто удалить '//' из функций, которые вам нужны.
ТАМОЖЕННЫЕ ЭКСКЕРПТНЫЕ ДЛИНЫ
Иногда вам нужно отобразить простые выдержки разной длины, и невозможно написать выдержку для каждого поста / функции / страницы. Вот хорошая маленькая маленькая функция, использующаяwp_trim_words
function wpse_custom_excerpts($limit) {
return wp_trim_words(get_the_excerpt(), $limit, '<a href="'. esc_url( get_permalink() ) . '">' . ' …' . __( 'Read more »', 'wpse' ) . '</a>');
}
Эта маленькая функция берет get_the_excerpt, обрезает ее по $limitусмотрению пользователя и возвращает текст с ссылкой «читать дальше» в конце.
Вы можете назвать эту выдержку, как следует в вашем шаблоне
echo wpse_custom_excerpts($limit);где $limitбудет ваше количество слов, так что выдержка из 30 слов будет
echo wpse_custom_excerpts(30);Здесь нужно помнить одну вещь: если вы установите ограничение в более чем 55 слов, будет возвращено только 55 слов, поскольку выдержка составляет всего 55 слов. Если нужны более длинные выдержки, используйте get_the_contentвместо этого.
ТАМОЖЕННАЯ ЭКСКЕРПТНАЯ ДЛИНА
Если вам просто нужно изменить длину the_excerpt(), вы можете использовать следующую функцию
function wpse_excerpt_length( $length ) {
return 20;
}
add_filter( 'excerpt_length', 'wpse_excerpt_length', 999 );
Помните, что вам нужно установить приоритет больше 10, чтобы ваша пользовательская функция выполнялась после значения по умолчанию.
ДОБАВЬТЕ, ЧИТАЙТЕ БОЛЬШЕ ССЫЛКА
Весь текст, возвращенный отрывком, [...]в конце имеет ненавистный текст, на который нельзя нажать. Чтобы добавить текст для чтения вместо hellips, используйте эту функцию
function wpse_excerpt_more( $more ) {
return ' <a class="read-more" href="'. get_permalink( get_the_ID() ) . '">' . __('Read More', 'your-text-domain') . '</a>';
}
add_filter( 'excerpt_more', 'wpse_excerpt_more' );
РЕДАКТИРОВАТЬ
Выдержка первый абзац
Я хочу, чтобы это было завершено, поэтому вот выдержка, которая обрезается после первого абзаца.
Вот функция, которая держит HTML-теги в такте, добавляет ссылку «Подробнее» в конце отрывка и обрезает отрывок после первого абзаца.
if ( ! function_exists( 'wpse0001_custom_wp_trim_excerpt' ) ) :
function wpse0001_custom_wp_trim_excerpt($wpse0001_excerpt) {
global $post;
$raw_excerpt = $wpse0001_excerpt;
if ( '' == $wpse0001_excerpt ) {
$wpse0001_excerpt = get_the_content('');
$wpse0001_excerpt = strip_shortcodes( $wpse0001_excerpt );
$wpse0001_excerpt = apply_filters('the_content', $wpse0001_excerpt);
$wpse0001_excerpt = substr( $wpse0001_excerpt, 0, strpos( $wpse0001_excerpt, '</p>' ) + 4 );
$wpse0001_excerpt = str_replace(']]>', ']]>', $wpse0001_excerpt);
$excerpt_end = ' <a href="'. esc_url( get_permalink() ) . '">' . ' » ' . sprintf(__( 'Read more about: %s »', 'pietergoosen' ), get_the_title()) . '</a>';
$excerpt_more = apply_filters('excerpt_more', ' ' . $excerpt_end);
//$pos = strrpos($wpse0001_excerpt, '</');
//if ($pos !== false)
// Inside last HTML tag
//$wpse0001_excerpt = substr_replace($wpse0001_excerpt, $excerpt_end, $pos, 0);
//else
// After the content
$wpse0001_excerpt .= $excerpt_more;
return $wpse0001_excerpt;
}
return apply_filters('wpse0001_custom_wp_trim_excerpt', $wpse0001_excerpt, $raw_excerpt);
}
endif;
remove_filter('get_the_excerpt', 'wp_trim_excerpt');
add_filter('get_the_excerpt', 'wpse0001_custom_wp_trim_excerpt');
РЕДАКТИРОВАТЬ 29-10-2015
Для тех, кому нужен обходной путь, чтобы не отображать ссылку «читать дальше» после выдержки, когда выдержка короче установленного количества слов, см. Следующий вопрос и ответ
functions.php. Вы можете добавить это чуть выше if ( ! function_exists( 'wpse_custom_wp_trim_excerpt' ) ) :в своемfunctions.php
Добавьте больше тегов, если вам нужно в $allowed_tags = ...
function _20170529_excerpt($text) {
$raw_excerpt = $text;
if ( '' == $text ) {
//Retrieve the post content.
$text = get_the_content('');
//Delete all shortcode tags from the content.
$text = strip_shortcodes( $text );
$text = apply_filters('the_content', $text);
$text = str_replace(']]>', ']]>', $text);
$allowed_tags = '<a>,<b>,<br><i>';
$text = strip_tags($text, $allowed_tags);
$excerpt_word_count = 55; /*** MODIFY THIS. change the excerpt word count to any integer you like.***/
$excerpt_length = apply_filters('excerpt_length', $excerpt_word_count);
$excerpt_end = '[...]'; /*** MODIFY THIS. change the excerpt endind to something else.***/
$excerpt_more = apply_filters('excerpt_more', ' ' . $excerpt_end);
$words = preg_split("/[\n\r\t ]+/", $text, $excerpt_length + 1, PREG_SPLIT_NO_EMPTY);
if ( count($words) > $excerpt_length ) {
array_pop($words);
$text = implode(' ', $words);
$text = $text . $excerpt_more;
} else {
$text = implode(' ', $words);
}
}
return apply_filters('wp_trim_excerpt', $text, $raw_excerpt);
}
Вы можете добавить расширенный текстовый редактор для отрывков, добавить нижеприведенный код в файл плагина или файл function.php темы, и вы сможете увидеть HTML-редактор для отрывков. Кроме того, он будет отображать выдержки в формате HTML. #cheers
Я скопировал это откуда-то, но не помню источник. Я использую это во всех моих проектах, и это работает.
/**
* Replaces the default excerpt editor with TinyMCE.
*/
add_action( 'add_meta_boxes', array ( 'T5_Richtext_Excerpt', 'switch_boxes' ) );
class T5_Richtext_Excerpt
{
/**
* Replaces the meta boxes.
*
* @return void
*/
public static function switch_boxes()
{
if ( ! post_type_supports( $GLOBALS['post']->post_type, 'excerpt' ) )
{
return;
}
remove_meta_box(
'postexcerpt', // ID
'', // Screen, empty to support all post types
'normal' // Context
);
add_meta_box(
'postexcerpt2', // Reusing just 'postexcerpt' doesn't work.
__( 'Excerpt' ), // Title
array ( __CLASS__, 'show' ), // Display function
null, // Screen, we use all screens with meta boxes.
'normal', // Context
'core', // Priority
);
}
/**
* Output for the meta box.
*
* @param object $post
* @return void
*/
public static function show( $post )
{
?>
<label class="screen-reader-text" for="excerpt"><?php
_e( 'Excerpt' )
?></label>
<?php
// We use the default name, 'excerpt', so we don’t have to care about
// saving, other filters etc.
wp_editor(
self::unescape( $post->post_excerpt ),
'excerpt',
array (
'textarea_rows' => 15,
'media_buttons' => FALSE,
'teeny' => TRUE,
'tinymce' => TRUE
)
);
}
/**
* The excerpt is escaped usually. This breaks the HTML editor.
*
* @param string $str
* @return string
*/
public static function unescape( $str )
{
return str_replace(
array ( '<', '>', '"', '&', ' ', '&nbsp;' ),
array ( '<', '>', '"', '&', ' ', ' ' ),
$str
);
}
}
function wpse_allowedtags() { // Add custom tags to this string return '<script>,<style>,<br>,<em>,<i>,<ul>,<ol>,<li>,<a>,<p>,<img>,<video>,<audio>'; }