web-dev-qa-db-ja.com

抜粋でHTMLを許可

これが私の抜粋コードです。

// Generate custom excerpt length
function wpbx_excerpt_length($length) {
    return 300;
}
add_filter('excerpt_length', 'wpbx_excerpt_length');

<a> <b> <i> <br>のようなHTMLを許可するにはどうすればよいですか

53
user32447

熟練者向けの完全なガイド

私は最近抜粋に関していくつかの質問に答えました、それで私はできる限りカバーする詳細な説明をするつもりです。

_はじめに_

コードがどこに行くべきかについてのこの答えから生じる質問がいくつかあるように思われます、そして答えは、それは本当にあなた次第であり、あなたがどのようにフィットするかはあなた次第です。明示的に記述されていない場合は、コードを配置できるオプションがいくつかあります。

  • あなたのテーマのfunctions.phpまたはどんなファイルでも関数フ​​ァイルとして使います。テーマを自分のものにしていない場合は、テーマをアップグレードするとすべての変更内容が失われます。

  • もっと良い方法は、子テーマでコードを使用することです。上記のとおり、functions.phpまたはfunctions関連ファイル内

  • プラグイン内のコードを使用してください。これにより、すべてのテーマでコードが使用可能になるため、これが推奨される方法です。テーマを切り替えても、同じコードを書き換えることを心配する必要はありません。

私はこれが物事を少しクリアすることを願います:-)

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/format.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タグの完全なリストについては、チェックアウトして here をチェックしてください。これが関数です、これに任意の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タグが許可されている場合、これらのタグは単語としてカウントされるため、タグ付きのタグとタグなしの抜粋の単語数は同じにはなりません。これを修正するには、まず実際の単語数からこれらのタグを削除して、単語のみを数えるようにする必要があります。

すべてのタグを許可し、単語のみを単語として数え、一定量の単語の後に文章を完成させ(テキストは文の途中でトリミングされない)、最後のWordの後にさらにテキストを追加する抜粋。

これが完全なコードです。

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(']]>', ']]&gt;', $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() ) . '">' . '&nbsp;&raquo;&nbsp;' . sprintf(__( 'Read more about: %s &nbsp;&raquo;', '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() ) . '">' . '&nbsp;&hellip;' . __( 'Read more &nbsp;&raquo;', 'wpse' ) . '</a>');
}

この小さな関数がすることはget_the_excerptを取って、それをユーザによって設定された$limitにトリミングして、そして最後にもっと多くのリンクを含むテキストを返すことです。

この抜粋は、テンプレート内で次のように呼び出すことができます。

echo wpse_custom_excerpts($limit);

ここで$limitはあなたのワード数になるでしょう、それで30ワードの抜粋はそうなるでしょう

echo wpse_custom_excerpts(30);

ここで覚えておくべきことは1つだけです。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(']]>', ']]&gt;', $wpse0001_excerpt);

            $excerpt_end = ' <a href="'. esc_url( get_permalink() ) . '">' . '&nbsp;&raquo;&nbsp;' . sprintf(__( 'Read more about: %s &nbsp;&raquo;', '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

抜粋が設定した単語数より短い場合に抜粋の後に[続きを読む]リンクを表示しないようにするための回避策が必要な場合は、次の質問と回答を参照してください。

117
Pieter Goosen

必要に応じてタグを追加してください$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(']]>', ']]&gt;', $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/

1
prosti

抜粋用のリッチテキストエディタを追加したり、プラグインファイルやテーマのfunction.phpファイルに以下のコードを追加したりすると、抜粋用のHTMLエディタが表示されます。さらに、抜粋もHTML形式でレンダリングします。 #乾杯

私はこれをどこかからコピーしましたが、出典を覚えていません。私は私のすべてのプロジェクトでこれを使っています、そしてそれは働いています。

enter image description here 

/**
  * 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 ( '&lt;', '&gt;', '&quot;', '&amp;', '&nbsp;', '&amp;nbsp;' ),
                array ( '<',    '>',    '"',      '&',     ' ', ' ' ),
                $str
        );
    }
}
0
Mayur Chauhan