Code Coverage
 
Lines
Functions and Methods
Classes and Traits
Total
0.00%
0 / 32
100.00%
7 / 7
 CRAP
n/a
0 / 0
jetpack_blog_display_custom_excerpt
n/a
0 / 0
n/a
0 / 0
 7
jetpack_the_content_to_the_excerpt
n/a
0 / 0
n/a
0 / 0
 6
jetpack_the_excerpt_to_the_content
n/a
0 / 0
n/a
0 / 0
 4
jetpack_the_content_customizer
n/a
0 / 0
n/a
0 / 0
 6
jetpack_the_excerpt_customizer
n/a
0 / 0
n/a
0 / 0
 5
jetpack_the_excerpt_mixed_customizer
n/a
0 / 0
n/a
0 / 0
 4
jetpack_the_content_customizer_class
n/a
0 / 0
n/a
0 / 0
 3
1<?php
2/**
3 * Theme Tools: the functions to display Content or Excerpt in a theme.
4 *
5 * @package automattic/jetpack
6 */
7
8if ( ! defined( 'ABSPATH' ) ) {
9    exit( 0 );
10}
11
12/**
13 * If the theme doesn't support 'jetpack-content-options', don't continue.
14 */
15if ( ! current_theme_supports( 'jetpack-content-options' ) ) {
16    return;
17}
18
19/**
20 * Get the Blog Display setting.
21 * If theme is using both 'Content' and 'Excerpt' then this setting will be called 'Mixed'.
22 */
23$options      = get_theme_support( 'jetpack-content-options' );
24$blog_display = ( ! empty( $options[0]['blog-display'] ) ) ? $options[0]['blog-display'] : null;
25$blog_display = preg_grep( '/^(content|excerpt)$/', (array) $blog_display );
26sort( $blog_display );
27$blog_display = implode( ', ', $blog_display );
28$blog_display = ( 'content, excerpt' === $blog_display ) ? 'mixed' : $blog_display;
29
30/**
31 * If the theme doesn't support 'jetpack-content-options[ 'blog-display' ]', don't continue.
32 */
33if ( ! in_array( $blog_display, array( 'content', 'excerpt', 'mixed' ), true ) ) {
34    return;
35}
36
37if ( ! function_exists( 'jetpack_blog_display_custom_excerpt' ) ) {
38
39    /**
40     * Apply Content filters.
41     *
42     * @deprecated 13.9 Moved to Classic Theme Helper package.
43     * @since 9.7.0 Deprecated $content parameter.
44     *
45     * @param string $content Post content. Deprecated.
46     */
47    function jetpack_blog_display_custom_excerpt( $content = '' ) {
48        _deprecated_function( __FUNCTION__, 'jetpack-13.9' );
49        if ( ! empty( $content ) ) {
50            _doing_it_wrong(
51                'jetpack_blog_display_custom_excerpt',
52                esc_html__( 'You do not need to pass a $content parameter anymore.', 'jetpack' ),
53                'jetpack-9.7.0'
54            );
55        }
56
57        $post = get_post();
58        if ( empty( $post ) ) {
59            return '';
60        }
61
62        if ( empty( $post->post_excerpt ) ) {
63            $text = strip_shortcodes( $post->post_content );
64            $text = str_replace( ']]>', ']]&gt;', $text );
65            $text = wp_strip_all_tags( $text );
66            /** This filter is documented in wp-includes/formatting.php */
67            $excerpt_length = apply_filters( 'excerpt_length', 55 );
68            /** This filter is documented in wp-includes/formatting.php */
69            $excerpt_more = apply_filters( 'excerpt_more', ' [...]' );
70
71            /*
72            * translators: If your word count is based on single characters (e.g. East Asian characters),
73            * enter 'characters_excluding_spaces' or 'characters_including_spaces'. Otherwise, enter 'words'.
74            * Do not translate into your own language.
75            */
76            if ( strpos( _x( 'words', 'Word count type. Do not translate!', 'jetpack' ), 'characters' ) === 0 && preg_match( '/^utf\-?8$/i', get_option( 'blog_charset' ) ) ) {
77                $text = trim( preg_replace( "/[\n\r\t ]+/", ' ', $text ), ' ' );
78                preg_match_all( '/./u', $text, $words );
79                $words = array_slice( $words[0], 0, $excerpt_length + 1 );
80                $sep   = '';
81            } else {
82                $words = preg_split( "/[\n\r\t ]+/", $text, $excerpt_length + 1, PREG_SPLIT_NO_EMPTY );
83                $sep   = ' ';
84            }
85
86            if ( count( $words ) > $excerpt_length ) {
87                array_pop( $words );
88                $text = implode( $sep, $words );
89                $text = $text . $excerpt_more;
90            } else {
91                $text = implode( $sep, $words );
92            }
93        } else {
94            $text = wp_kses_post( $post->post_excerpt );
95        }
96        return sprintf( '<p>%s</p>', $text );
97    }
98
99}
100
101if ( ! function_exists( 'jetpack_the_content_to_the_excerptt' ) ) {
102
103    /**
104     * Display Excerpt instead of Content.
105     *
106     * @deprecated 13.9 Moved to Classic Theme Helper package.
107     *
108     * @param string $content Post content.
109     */
110    function jetpack_the_content_to_the_excerpt( $content ) {
111        _deprecated_function( __FUNCTION__, 'jetpack-13.9' );
112        if ( ( is_home() || is_archive() ) && ! is_post_type_archive( array( 'jetpack-testimonial', 'jetpack-portfolio', 'product' ) ) ) {
113            if ( post_password_required() ) {
114                $excerpt = sprintf( '<p>%s</p>', esc_html__( 'There is no excerpt because this is a protected post.', 'jetpack' ) );
115            } else {
116                $excerpt = jetpack_blog_display_custom_excerpt();
117            }
118        }
119        if ( empty( $excerpt ) ) {
120            return $content;
121        } else {
122            return $excerpt;
123        }
124    }
125
126}
127
128if ( ! function_exists( 'jetpack_the_excerpt_to_the_content' ) ) {
129
130    /**
131     * Display Content instead of Excerpt.
132     *
133     * @deprecated 13.9 Moved to Classic Theme Helper package.
134     *
135     * @param string $content The post excerpt.
136     */
137    function jetpack_the_excerpt_to_the_content( $content ) {
138        _deprecated_function( __FUNCTION__, 'jetpack-13.9' );
139        if ( ( is_home() || is_archive() ) && ! is_post_type_archive( array( 'jetpack-testimonial', 'jetpack-portfolio', 'product' ) ) ) {
140            ob_start();
141            the_content(
142                sprintf(
143                    wp_kses(
144                        /* translators: %s: Name of current post. Only visible to screen readers */
145                        __( 'Continue reading<span class="screen-reader-text"> "%s"</span>', 'jetpack' ),
146                        array(
147                            'span' => array(
148                                'class' => array(),
149                            ),
150                        )
151                    ),
152                    get_the_title()
153                )
154            );
155            $content = ob_get_clean();
156        }
157        return $content;
158    }
159
160}
161
162if ( ! function_exists( 'jetpack_the_content_customizer' ) ) {
163
164    /**
165     * Display both Content and Excerpt instead of Content in the Customizer so live preview can switch between them.
166     *
167     * @deprecated 13.9 Moved to Classic Theme Helper package.
168     * @param string $content The post content.
169     */
170    function jetpack_the_content_customizer( $content ) {
171        _deprecated_function( __FUNCTION__, 'jetpack-13.9' );
172        $class = jetpack_the_content_customizer_class();
173        if ( ( is_home() || is_archive() ) && ! is_post_type_archive( array( 'jetpack-testimonial', 'jetpack-portfolio', 'product' ) ) ) {
174            if ( post_password_required() ) {
175                $excerpt = sprintf( '<p>%s</p>', esc_html__( 'There is no excerpt because this is a protected post.', 'jetpack' ) );
176            } else {
177                $excerpt = jetpack_blog_display_custom_excerpt();
178            }
179        }
180        if ( empty( $excerpt ) ) {
181            return $content;
182        } else {
183            return sprintf( '<div class="jetpack-blog-display %s jetpack-the-content">%s</div><div class="jetpack-blog-display %s jetpack-the-excerpt">%s</div>', $class, $content, $class, $excerpt );
184        }
185    }
186
187}
188
189if ( ! function_exists( 'jetpack_the_excerpt_customizer' ) ) {
190
191    /**
192     * Display both Content and Excerpt instead of Excerpt in the Customizer so live preview can switch between them.
193     *
194     * @deprecated 13.9 Moved to Classic Theme Helper package.
195     * @param string $excerpt The post excerpt.
196     */
197    function jetpack_the_excerpt_customizer( $excerpt ) {
198        _deprecated_function( __FUNCTION__, 'jetpack-13.9' );
199        if ( ( is_home() || is_archive() ) && ! is_post_type_archive( array( 'jetpack-testimonial', 'jetpack-portfolio', 'product' ) ) ) {
200            ob_start();
201            the_content(
202                sprintf(
203                    wp_kses(
204                        /* translators: %s: Name of current post. Only visible to screen readers */
205                        __( 'Continue reading<span class="screen-reader-text"> "%s"</span>', 'jetpack' ),
206                        array(
207                            'span' => array(
208                                'class' => array(),
209                            ),
210                        )
211                    ),
212                    get_the_title()
213                )
214            );
215            $content = ob_get_clean();
216        }
217        if ( empty( $content ) ) {
218            return $excerpt;
219        } else {
220            return sprintf( '<div class="jetpack-blog-display jetpack-the-content">%s</div><div class="jetpack-blog-display jetpack-the-excerpt">%s</div>', $content, $excerpt );
221        }
222    }
223
224}
225
226if ( ! function_exists( 'jetpack_the_excerpt_mixed_customizer' ) ) {
227
228    /**
229     * Display Content instead of Excerpt in the Customizer when theme uses a 'Mixed' display.
230     *
231     * @deprecated 13.9 Moved to Classic Theme Helper package.
232     * @param string $content The post excerpt.
233     */
234    function jetpack_the_excerpt_mixed_customizer( $content ) {
235        _deprecated_function( __FUNCTION__, 'jetpack-13.9' );
236        if ( ( is_home() || is_archive() ) && ! is_post_type_archive( array( 'jetpack-testimonial', 'jetpack-portfolio', 'product' ) ) ) {
237            jetpack_the_content_customizer_class( 'output-the-excerpt' );
238            ob_start();
239            the_content();
240            $content = ob_get_clean();
241        }
242        return $content;
243    }
244
245}
246
247if ( ! function_exists( 'jetpack_the_content_customizer_class' ) ) {
248
249    /**
250     * Returns a class value, `output-the-content` by default.
251     * Used for themes with a 'Mixed' Blog Display so we can tell which output is by default.
252     *
253     * @deprecated 13.9 Moved to Classic Theme Helper package.
254     * @param string|null $new_class CSS class added to content container.
255     */
256    function jetpack_the_content_customizer_class( $new_class = null ) {
257        _deprecated_function( __FUNCTION__, 'jetpack-13.9' );
258        static $class;
259        if ( isset( $new_class ) ) {
260            // Assign a new class and return.
261            $class = $new_class;
262        } elseif ( isset( $class ) ) {
263            // Reset the class after getting value.
264            $prev_class = $class;
265            $class      = null;
266            return $prev_class;
267        } else {
268            // Return default class value.
269            return 'output-the-content';
270        }
271    }
272
273}
274
275if ( is_customize_preview() ) {
276    /*
277     * Display Content and Excerpt if the default Blog Display is 'Content'
278     * and we are in the Customizer.
279     */
280    if ( 'content' === $blog_display ) {
281        add_filter( 'the_content', 'jetpack_the_content_customizer' );
282    }
283
284    /*
285     * Display Content and Excerpt if the default Blog Display is 'Excerpt'
286     * and we are in the Customizer.
287     */
288    if ( 'excerpt' === $blog_display ) {
289        add_filter( 'the_excerpt', 'jetpack_the_excerpt_customizer' );
290    }
291
292    /*
293     * Display Content and Excerpt if the default Blog Display is 'Mixed'
294     * and we are in the Customizer.
295     */
296    if ( 'mixed' === $blog_display ) {
297        add_filter( 'the_content', 'jetpack_the_content_customizer' );
298        add_filter( 'the_excerpt', 'jetpack_the_excerpt_mixed_customizer' );
299    }
300} else {
301    $display_option = get_option( 'jetpack_content_blog_display', $blog_display );
302
303    /*
304     * Display Excerpt if the default Blog Display is 'Content'
305     * or default Blog Display is 'Mixed'
306     * and the Option picked is 'Post Excerpt'
307     * and we aren't in the Customizer.
308     */
309    if ( ( 'content' === $blog_display || 'mixed' === $blog_display ) && 'excerpt' === $display_option ) {
310        add_filter( 'the_content', 'jetpack_the_content_to_the_excerpt' );
311    }
312
313    /*
314     * Display Content if the default Blog Display is 'Excerpt'
315     * or default Blog Display is 'Mixed'
316     * and the Option picked is 'Full Post'
317     * and we aren't in the Customizer.
318     */
319    if ( ( 'excerpt' === $blog_display || 'mixed' === $blog_display ) && 'content' === $display_option ) {
320        add_filter( 'the_excerpt', 'jetpack_the_excerpt_to_the_content' );
321    }
322}