抜粋でHTMLを許可する
回答:
抜粋の完全ガイド
私は最近、抜粋に関するいくつかの質問に答えたので、できる限り多くをカバーする詳細な説明をするつもりです。
序文
コードがどこに行くべきかについてのこの回答から生じる質問がいくつかあるようであり、答えは、それは本当にあなた次第であり、あなたがどのように適合すると思うかです。コードを配置できるオプションがいくつかあります（明示的に指定されていない場合）。
テーマのfunctions.phpまたは任意のファイルで、関数ファイルとして使用します。これを行うときに覚えておいてください、テーマが自分のものでない場合、テーマをアップグレードするとすべての変更が失われます
より良い方法は、子テーマでコードを使用することです。上記のように、functions.phpまたは機能関連ファイル
プラグインでコードを使用します。これにより、すべてのテーマでコードを使用できるようになるため、この方法をお勧めします。テーマを切り替えれば、同じコードを書き直すことを心配する必要はありません。
私はこれが少し物事をクリアすることを願っています:-)
HTMLタグ/フォーマット
the_excerpt()まず、パラメーターを受け入れないため、何も渡すことができません。the_excerpt()コンテンツを55ワードにトリミングし、テキストを返す前にすべてのHTMLタグを削除するのは事実です。the_excerpt()位置しています/ポストtemplate.phpをWP-含み。抜粋で特定またはすべてのHTMLタグを許可するには、新しい抜粋を作成する必要があります。
まず、元の関数を削除してから、新しい関数をにフックする必要がありますget_the_excerpt。この新しい抜粋はthe_excerpt()、テンプレートファイルの場合と同様に呼び出し可能であり、変更する必要はありません。get_the_excerpt()位置しています/ポストtemplate.phpをWP-含み。
抜粋はwp_trim_excerptトリミングされたテキストを返すために使用するため、wp_trim_excerpt最初に抜粋フィルタから削除する必要があります。wp_trim_excerpt()位置しているWP-含ま/ 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());2番目の引数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より大きい優先度を設定する必要があることを忘れないでください。
詳細リンクを追加
抜粋によって返されたすべてのテキスト[...]の最後には、クリックできない憎しみがあります。ヘリックスの場所にさらにテキストを追加するには、この関数を使用します
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);
}
から：http : //bacsoftwareconsulting.com/blog/index.php/wordpress-cat/how-to-preserve-html-tags-in-wordpress-excerpt-without-a-plugin/
抜粋用のリッチテキストエディターも追加できます。プラグインファイルまたはテーマのfunction.phpファイルに以下のコードを追加すると、抜粋用のHTMLエディターを表示できます。さらに、抜粋もHTML形式でレンダリングします。＃乾杯
私はどこかからこれをコピーしましたが、ソースを覚えていません。私はこれをすべてのプロジェクトで使用していますが、機能しています。
/**
* 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>'; }イム混乱