WordPress.org
Get WordPress

Make WordPress Core

Changeset 51338


Ignore:
Timestamp:
07/06/2021 12:34:36 PM (3 years ago)
Author:
desrosj
Message:

Twenty Twenty: Add missing documentation for some filters.

Add missing @since tags for some functions.

Correct alignment of some @param tags.

Follow-up to [46271], [46278], [51304].

Props SergeyBiryukov.
Merges [51322] to the 5.8 branch.
See #52628, #53461.

Location:
branches/5.8
Files:
20 edited

Legend:

Unmodified
Added
Removed

  • branches/5.8

  • branches/5.8/src/wp-content/themes/twentytwenty/assets/js/customize-preview.js

    r47122 r51338  
    1111    /**
    1212     * Return a value for our partial refresh.
     13     *
     14     * @since Twenty Twenty 1.0
    1315     *
    1416     * @param {Object} partial  Current partial.
    … …  
    3133        /**
    3234         * Override the refresh method.
     35         *
     36         * @since Twenty Twenty 1.0
    3337         *
    3438         * @return {jQuery.Promise} Resolved promise.
    … …  
    5660         * Input attributes.
    5761         *
     62         * @since Twenty Twenty 1.0
    5863         * @type {Object}
    5964         */
    … …  
    6267        /**
    6368         * Override the refresh method.
     69         *
     70         * @since Twenty Twenty 1.0
    6471         *
    6572         * @return {jQuery.Promise} Resolved promise.

  • branches/5.8/src/wp-content/themes/twentytwenty/assets/js/index.js

    r50033 r51338  
    647647 * This implementation is coming from https://gomakethings.com/a-native-javascript-equivalent-of-jquerys-ready-method/
    648648 *
     649 * @since Twenty Twenty 1.0
     650 *
    649651 * @param {Function} fn Callback function to run.
    650652 */
    … …  
    695697/**
    696698 * Toggle a menu item on or off.
     699 *
     700 * @since Twenty Twenty 1.0
    697701 *
    698702 * @param {HTMLElement} target
    … …  
    797801 * Traverses the DOM up to find elements matching the query.
    798802 *
     803 * @since Twenty Twenty 1.0
     804 *
    799805 * @param {HTMLElement} target
    800806 * @param {string} query

  • branches/5.8/src/wp-content/themes/twentytwenty/assets/js/skip-link-focus-fix.js

    r46613 r51338  
    77 *
    88 * Learn more: https://git.io/vWdr2
     9 *
     10 * @since Twenty Twenty 1.0
    911 */
    1012( function() {

  • branches/5.8/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-customize.php

    r48861 r51338  
    1111    /**
    1212     * CUSTOMIZER SETTINGS
     13     *
     14     * @since Twenty Twenty 1.0
    1315     */
    1416    class TwentyTwenty_Customize {
    … …  
    1618        /**
    1719         * Register customizer options.
     20         *
     21         * @since Twenty Twenty 1.0
    1822         *
    1923         * @param WP_Customize_Manager $wp_customize Theme Customizer object.
    … …  
    413417         * Sanitization callback for the "accent_accessible_colors" setting.
    414418         *
    415          * @static
    416          * @access public
    417419         * @since Twenty Twenty 1.0
     420         *
    418421         * @param array $value The value we want to sanitize.
    419422         * @return array Returns sanitized value. Each item in the array gets sanitized separately.
    … …  
    437440         * Sanitize select.
    438441         *
    439          * @param string $input The input from the setting.
     442         * @since Twenty Twenty 1.0
     443         *
     444         * @param string $input   The input from the setting.
    440445         * @param object $setting The selected setting.
    441446         * @return string The input from the setting or the default setting.
    … …  
    450455         * Sanitize boolean for checkbox.
    451456         *
     457         * @since Twenty Twenty 1.0
     458         *
    452459         * @param bool $checked Whether or not a box is checked.
    453460         * @return bool
    … …  
    470477    /**
    471478     * Render the site title for the selective refresh partial.
     479     *
     480     * @since Twenty Twenty 1.0
    472481     */
    473482    function twentytwenty_customize_partial_blogname() {
    … …  
    479488    /**
    480489     * Render the site description for the selective refresh partial.
     490     *
     491     * @since Twenty Twenty 1.0
    481492     */
    482493    function twentytwenty_customize_partial_blogdescription() {
    … …  
    490501     *
    491502     * Doing it this way so we don't have issues with `render_callback`'s arguments.
     503     *
     504     * @since Twenty Twenty 1.0
    492505     */
    493506    function twentytwenty_customize_partial_site_logo() {
    … …  
    500513 * Input attributes for cover overlay opacity option.
    501514 *
     515 * @since Twenty Twenty 1.0
     516 *
    502517 * @return array Array containing attribute names and their values.
    503518 */
    504519function twentytwenty_customize_opacity_range() {
    505520    /**
    506      * Filters the input attributes for opacity
     521     * Filters the input attributes for opacity.
     522     *
     523     * @since Twenty Twenty 1.0
    507524     *
    508525     * @param array $attrs {
    509      *     The attributes
    510      *
    511      *     @type int $min Minimum value
    512      *     @type int $max Maximum value
    513      *     @type int $step Interval between numbers
     526     *     The attributes.
     527     *
     528     *     @type int $min  Minimum value.
     529     *     @type int $max  Maximum value.
     530     *     @type int $step Interval between numbers.
    514531     * }
    515532     */

  • branches/5.8/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-non-latin-languages.php

    r48102 r51338  
    1313    /**
    1414     * Language handling.
     15     *
     16     * @since Twenty Twenty 1.0
    1517     */
    1618    class TwentyTwenty_Non_Latin_Languages {
    … …  
    2123         * Return CSS for non-latin language, if available, or null
    2224         *
    23          * @param string $type Whether to return CSS for the "front-end", "block-editor" or "classic-editor".
     25         * @since Twenty Twenty 1.0
     26         *
     27         * @param string $type Whether to return CSS for the "front-end", "block-editor", or "classic-editor".
    2428         * @return void
    2529         */
    … …  
    2933            $locale = get_bloginfo( 'language' );
    3034
    31             // Define fallback fonts for non-latin languages.
     35            /**
     36             * Filters the fallback fonts for non-latin languages.
     37             *
     38             * @since Twenty Twenty 1.0
     39             *
     40             * @param array $font_family An array of locales and font families.
     41             */
    3242            $font_family = apply_filters(
    3343                'twentytwenty_get_localized_font_family_types',
    … …  
    99109            }
    100110
    101             // Define elements to apply fallback fonts to.
     111            /**
     112             * Filters the elements to apply fallback fonts to.
     113             *
     114             * @since Twenty Twenty 1.0
     115             *
     116             * @param array $elements An array of elements for "front-end", "block-editor", or "classic-editor".
     117             */
    102118            $elements = apply_filters(
    103119                'twentytwenty_get_localized_font_family_elements',

  • branches/5.8/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-script-loader.php

    r47122 r51338  
    1515    /**
    1616     * A class that provides a way to add `async` or `defer` attributes to scripts.
     17     *
     18     * @since Twenty Twenty 1.0
    1719     */
    1820    class TwentyTwenty_Script_Loader {
    … …  
    2224         *
    2325         * If #12009 lands in WordPress, this function can no-op since it would be handled in core.
     26         *
     27         * @since Twenty Twenty 1.0
    2428         *
    2529         * @link https://core.trac.wordpress.org/ticket/12009

  • branches/5.8/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-separator-control.php

    r46827 r51338  
    1313        /**
    1414         * Separator Control.
     15         *
     16         * @since Twenty Twenty 1.0
    1517         */
    1618        class TwentyTwenty_Separator_Control extends WP_Customize_Control {
    1719            /**
    1820             * Render the hr.
     21             *
     22             * @since Twenty Twenty 1.0
    1923             */
    2024            public function render_content() {

  • branches/5.8/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-svg-icons.php

    r48181 r51338  
    1212     * SVG ICONS CLASS
    1313     * Retrieve the SVG code for the specified icon. Based on a solution in Twenty Nineteen.
     14     *
     15     * @since Twenty Twenty 1.0
    1416     */
    1517    class TwentyTwenty_SVG_Icons {
    … …  
    1719         * GET SVG CODE
    1820         * Get the SVG code for the specified icon
     21         *
     22         * @since Twenty Twenty 1.0
    1923         *
    2024         * @param string $icon  Icon name.
    … …  
    6973         * GET SOCIAL LINK SVG
    7074         * Detects the social network from a URL and returns the SVG code for its icon.
     75         *
     76         * @since Twenty Twenty 1.0
    7177         *
    7278         * @param string $uri The URL to retrieve SVG for.
    … …  
    117123         * Store the code for all SVGs in an array.
    118124         *
     125         * @since Twenty Twenty 1.0
    119126         * @var array
    120127         */
    … …  
    170177         * specify all the domains it covers (including the .com TLD too, if applicable).
    171178         *
     179         * @since Twenty Twenty 1.0
    172180         * @var array
    173181         */
    … …  
    225233         * Social Icons – svg sources.
    226234         *
     235         * @since Twenty Twenty 1.0
    227236         * @var array
    228237         */

  • branches/5.8/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-walker-comment.php

    r49158 r51338  
    1212     * CUSTOM COMMENT WALKER
    1313     * A custom walker for comments, based on the walker in Twenty Nineteen.
     14     *
     15     * @since Twenty Twenty 1.0
    1416     */
    1517    class TwentyTwenty_Walker_Comment extends Walker_Comment {
    … …  
    1719        /**
    1820         * Outputs a comment in the HTML5 format.
     21         *
     22         * @since Twenty Twenty 1.0
    1923         *
    2024         * @see wp_list_comments()

  • branches/5.8/src/wp-content/themes/twentytwenty/classes/class-twentytwenty-walker-page.php

    r47122 r51338  
    1212     * CUSTOM PAGE WALKER
    1313     * A custom walker for pages.
     14     *
     15     * @since Twenty Twenty 1.0
    1416     */
    1517    class TwentyTwenty_Walker_Page extends Walker_Page {
    … …  
    1820         * Outputs the beginning of the current element in the tree.
    1921         *
     22         * @since Twenty Twenty 1.0
     23         *
    2024         * @see Walker::start_el()
    21          * @since 2.1.0
    2225         *
    2326         * @param string  $output       Used to append additional content. Passed by reference.

  • branches/5.8/src/wp-content/themes/twentytwenty/functions.php

    r49347 r51338  
    3131 * runs before the init hook. The init hook is too late for some features, such
    3232 * as indicating support for post thumbnails.
     33 *
     34 * @since Twenty Twenty 1.0
    3335 */
    3436function twentytwenty_theme_support() {
    … …  
    184186/**
    185187 * Register and Enqueue Styles.
     188 *
     189 * @since Twenty Twenty 1.0
    186190 */
    187191function twentytwenty_register_styles() {
    … …  
    204208/**
    205209 * Register and Enqueue Scripts.
     210 *
     211 * @since Twenty Twenty 1.0
    206212 */
    207213function twentytwenty_register_scripts() {
    … …  
    225231 * This does not enqueue the script because it is tiny and because it is only for IE11,
    226232 * thus it does not warrant having an entire dedicated blocking script being loaded.
     233 *
     234 * @since Twenty Twenty 1.0
    227235 *
    228236 * @link https://git.io/vWdr2
    … …  
    238246add_action( 'wp_print_footer_scripts', 'twentytwenty_skip_link_focus_fix' );
    239247
    240 /** Enqueue non-latin language styles
     248/**
     249 * Enqueue non-latin language styles.
    241250 *
    242251 * @since Twenty Twenty 1.0
    … …  
    256265/**
    257266 * Register navigation menus uses wp_nav_menu in five places.
     267 *
     268 * @since Twenty Twenty 1.0
    258269 */
    259270function twentytwenty_menus() {
    … …  
    274285/**
    275286 * Get the information about the logo.
     287 *
     288 * @since Twenty Twenty 1.0
    276289 *
    277290 * @param string $html The HTML output from get_custom_logo (core function).
    … …  
    332345    /**
    333346     * Shim for wp_body_open, ensuring backward compatibility with versions of WordPress older than 5.2.
     347     *
     348     * @since Twenty Twenty 1.0
    334349     */
    335350    function wp_body_open() {
     351        /** This action is documented in wp-includes/general-template.php */
    336352        do_action( 'wp_body_open' );
    337353    }
    … …  
    340356/**
    341357 * Include a skip to content link at the top of the page so that users can bypass the menu.
     358 *
     359 * @since Twenty Twenty 1.0
    342360 */
    343361function twentytwenty_skip_link() {
    … …  
    349367/**
    350368 * Register widget areas.
     369 *
     370 * @since Twenty Twenty 1.0
    351371 *
    352372 * @link https://developer.wordpress.org/themes/functionality/sidebars/#registering-a-sidebar
    … …  
    392412/**
    393413 * Enqueue supplemental block editor styles.
     414 *
     415 * @since Twenty Twenty 1.0
    394416 */
    395417function twentytwenty_block_editor_styles() {
    … …  
    413435/**
    414436 * Enqueue classic editor styles.
     437 *
     438 * @since Twenty Twenty 1.0
    415439 */
    416440function twentytwenty_classic_editor_styles() {
    … …  
    429453 * Output Customizer settings in the classic editor.
    430454 * Adds styles to the head of the TinyMCE iframe. Kudos to @Otto42 for the original solution.
     455 *
     456 * @since Twenty Twenty 1.0
    431457 *
    432458 * @param array $mce_init TinyMCE styles.
    … …  
    480506 * Block Editor Settings.
    481507 * Add custom colors and font sizes to the block editor.
     508 *
     509 * @since Twenty Twenty 1.0
    482510 */
    483511function twentytwenty_block_editor_settings() {
    … …  
    633661 * @since Twenty Twenty 1.0
    634662 *
    635  * @param string $area The area we want to get the colors for.
     663 * @param string $area    The area we want to get the colors for.
    636664 * @param string $context Can be 'text' or 'accent'.
    637665 * @return string Returns a HEX color.
    … …  
    751779
    752780    /**
    753     * Filters Twenty Twenty theme elements
    754     *
    755     * @since Twenty Twenty 1.0
    756     *
    757     * @param array Array of elements
    758     */
     781     * Filters Twenty Twenty theme elements.
     782     *
     783     * @since Twenty Twenty 1.0
     784     *
     785     * @param array Array of elements.
     786     */
    759787    return apply_filters( 'twentytwenty_get_elements_array', $elements );
    760788}

  • branches/5.8/src/wp-content/themes/twentytwenty/inc/custom-css.php

    r51095 r51338  
    1313     * Generate CSS.
    1414     *
     15     * @since Twenty Twenty 1.0
     16     *
    1517     * @param string $selector The CSS selector.
    16      * @param string $style The CSS style.
    17      * @param string $value The CSS value.
    18      * @param string $prefix The CSS prefix.
    19      * @param string $suffix The CSS suffix.
    20      * @param bool   $echo Echo the styles.
     18     * @param string $style    The CSS style.
     19     * @param string $value    The CSS value.
     20     * @param string $prefix   The CSS prefix.
     21     * @param string $suffix   The CSS suffix.
     22     * @param bool   $echo     Echo the styles.
    2123     */
    2224    function twentytwenty_generate_css( $selector, $style, $value, $prefix = '', $suffix = '', $echo = true ) {
    … …  
    5153     * Build CSS reflecting colors, fonts and other options set in the Customizer, and return them for output.
    5254     *
    53      * @param string $type Whether to return CSS for the "front-end", "block-editor" or "classic-editor".
     55     * @since Twenty Twenty 1.0
     56     *
     57     * @param string $type Whether to return CSS for the "front-end", "block-editor", or "classic-editor".
    5458     */
    5559    function twentytwenty_get_customizer_css( $type = 'front-end' ) {
    … …  
    7983        ob_start();
    8084
    81         /**
     85        /*
    8286         * Note – Styles are applied in this order:
    8387         * 1. Element specific
    … …  
    8791         * meaning that any color classes applied in the block editor will
    8892         * have a higher priority than the base element styles.
    89         */
     93         */
    9094
    9195        // Front-End Styles.

  • branches/5.8/src/wp-content/themes/twentytwenty/inc/svg-icons.php

    r47122 r51338  
    1313     * Output and get the SVG markup for an icon in the TwentyTwenty_SVG_Icons class.
    1414     *
     15     * @since Twenty Twenty 1.0
     16     *
    1517     * @param string $svg_name The name of the icon.
    16      * @param string $group The group the icon belongs to.
    17      * @param string $color Color code.
     18     * @param string $group    The group the icon belongs to.
     19     * @param string $color    Color code.
    1820     */
    1921    function twentytwenty_the_theme_svg( $svg_name, $group = 'ui', $color = '' ) {
    … …  
    2729     * Get information about the SVG icon.
    2830     *
     31     * @since Twenty Twenty 1.0
     32     *
    2933     * @param string $svg_name The name of the icon.
    30      * @param string $group The group the icon belongs to.
    31      * @param string $color Color code.
     34     * @param string $group    The group the icon belongs to.
     35     * @param string $color    Color code.
    3236     */
    3337    function twentytwenty_get_theme_svg( $svg_name, $group = 'ui', $color = '' ) {

  • branches/5.8/src/wp-content/themes/twentytwenty/inc/template-tags.php

    r49120 r51338  
    2626 * Displays the site logo, either text or image.
    2727 *
    28  * @param array   $args Arguments for displaying the site logo either as an image or text.
    29  * @param bool    $echo Echo or return the HTML.
     28 * @since Twenty Twenty 1.0
     29 *
     30 * @param array $args Arguments for displaying the site logo either as an image or text.
     31 * @param bool  $echo Echo or return the HTML.
    3032 * @return string Compiled HTML based on our arguments.
    3133 */
    … …  
    5153     * Filters the arguments for `twentytwenty_site_logo()`.
    5254     *
    53      * @param array  $args     Parsed arguments.
    54      * @param array  $defaults Function's default arguments.
     55     * @since Twenty Twenty 1.0
     56     *
     57     * @param array $args     Parsed arguments.
     58     * @param array $defaults Function's default arguments.
    5559     */
    5660    $args = apply_filters( 'twentytwenty_site_logo_args', $args, $defaults );
    … …  
    7175     * Filters the arguments for `twentytwenty_site_logo()`.
    7276     *
     77     * @since Twenty Twenty 1.0
     78     *
    7379     * @param string $html      Compiled HTML based on our arguments.
    7480     * @param array  $args      Parsed arguments.
    … …  
    8995 * Displays the site description.
    9096 *
     97 * @since Twenty Twenty 1.0
     98 *
    9199 * @param bool $echo Echo or return the html.
    92100 * @return string The HTML to display.
    … …  
    108116     * @since Twenty Twenty 1.0
    109117     *
    110      * @param string $html         The HTML to display.
    111      * @param string $description  Site description via `bloginfo()`.
    112      * @param string $wrapper      The format used in case you want to reuse it in a `sprintf()`.
     118     * @param string $html        The HTML to display.
     119     * @param string $description Site description via `bloginfo()`.
     120     * @param string $wrapper     The format used in case you want to reuse it in a `sprintf()`.
    113121     */
    114122    $html = apply_filters( 'twentytwenty_site_description', $html, $description, $wrapper );
    … …  
    128136 * Checks if the specified comment is written by the author of the post commented on.
    129137 *
     138 * @since Twenty Twenty 1.0
     139 *
    130140 * @param object $comment Comment data.
    131141 * @return bool
    … …  
    154164 * makes it scroll to the wrong position on the page.
    155165 *
     166 * @since Twenty Twenty 1.0
     167 *
    156168 * @param string $link Link to the top of the page.
    157169 * @return string Link to the top of the page.
    … …  
    175187 * If it's a single post, outputs the post meta values specified in the Customizer settings.
    176188 *
     189 * @since Twenty Twenty 1.0
     190 *
    177191 * @param int    $post_id  The ID of the post for which the post meta should be output.
    178192 * @param string $location Which post meta location to output – single or preview.
    … …  
    186200/**
    187201 * Filters the edit post link to add an icon and use the post meta structure.
     202 *
     203 * @since Twenty Twenty 1.0
    188204 *
    189205 * @param string $link    Anchor tag for the edit link.
    … …  
    224240 * Retrieves the post meta.
    225241 *
    226  * @param int    $post_id The ID of the post.
     242 * @since Twenty Twenty 1.0
     243 *
     244 * @param int    $post_id  The ID of the post.
    227245 * @param string $location The location where the meta is shown.
    228246 */
    … …  
    242260     * @since Twenty Twenty 1.0
    243261     *
    244      * @param array Array of post types
     262     * @param array Array of post types.
    245263     */
    246264    $disallowed_post_types = apply_filters( 'twentytwenty_disallowed_post_types_for_meta_output', array( 'page' ) );
    … …  
    264282         *
    265283         * @param array $args {
    266          *  @type string 'author'
    267          *  @type string 'post-date'
    268          *  @type string 'comments'
    269          *  @type string 'sticky'
     284         *     @type string $author
     285         *     @type string $post-date
     286         *     @type string $comments
     287         *     @type string $sticky
    270288         * }
    271289         */
    … …  
    292310         *
    293311         * @param array $args {
    294          *   @type string 'tags'
     312         *     @type string $tags
    295313         * }
    296314         */
    … …  
    500518 * styling of sub levels in the fallback. Only applied if the match_menu_classes argument is set.
    501519 *
     520 * @since Twenty Twenty 1.0
     521 *
    502522 * @param string[] $css_class    An array of CSS classes to be applied to each list item.
    503523 * @param WP_Post  $page         Page data object.
    … …  
    534554/**
    535555 * Adds a Sub Nav Toggle to the Expanded Menu and Mobile Menu.
     556 *
     557 * @since Twenty Twenty 1.0
    536558 *
    537559 * @param stdClass $args  An object of wp_nav_menu() arguments.
    … …  
    580602/**
    581603 * Displays SVG icons in social links menu.
     604 *
     605 * @since Twenty Twenty 1.0
    582606 *
    583607 * @param string   $item_output The menu item's starting HTML output.
    … …  
    610634 *
    611635 * If we're missing JavaScript support, the HTML element will have a 'no-js' class.
     636 *
     637 * @since Twenty Twenty 1.0
    612638 */
    613639function twentytwenty_no_js_class() {
    … …  
    623649/**
    624650 * Adds conditional body classes.
     651 *
     652 * @since Twenty Twenty 1.0
    625653 *
    626654 * @param array $classes Classes added to the body tag.
    … …  
    725753 * Filters the archive title and styles the word before the first colon.
    726754 *
     755 * @since Twenty Twenty 1.0
     756 *
    727757 * @param string $title Current archive title.
    728758 * @return string Current archive title.
    … …  
    730760function twentytwenty_get_the_archive_title( $title ) {
    731761
     762    /**
     763     * Filters the regular expression used to style the word before the first colon.
     764     *
     765     * @since Twenty Twenty 1.0
     766     *
     767     * @param array $regex An array of regular expression pattern and replacement.
     768     */
    732769    $regex = apply_filters(
    733770        'twentytwenty_get_the_archive_title_regex',
    … …  
    757794 * Toggles animation duration in milliseconds.
    758795 *
     796 * @since Twenty Twenty 1.0
     797 *
    759798 * @return int Duration in milliseconds
    760799 */
    … …  
    780819 * but it is unique across the life of the PHP process.
    781820 *
     821 * @since Twenty Twenty 1.0
     822 *
    782823 * @see wp_unique_id() Themes requiring WordPress 5.0.3 and greater should use this instead.
    783824 *

  • branches/5.8/src/wp-content/themes/twentytwenty/template-parts/content-cover.php

    r47799 r51338  
    6060                             * @since Twenty Twenty 1.0
    6161                             *
    62                              * @param bool Whether to show the categories in article header, Default true.
     62                             * @param bool Whether to show the categories in article header. Default true.
    6363                             */
    6464                            $show_categories = apply_filters( 'twentytwenty_show_categories_in_entry_header', true );
    … …  
    163163    }
    164164
    165     /**
    166      *  Output comments wrapper if it's a post, or if comments are open,
     165    /*
     166     * Output comments wrapper if it's a post, or if comments are open,
    167167     * or if there's a comment number – and check for password.
    168      * */
     168     */
    169169    if ( ( is_single() || is_page() ) && ( comments_open() || get_comments_number() ) && ! post_password_required() ) {
    170170        ?>

  • branches/5.8/src/wp-content/themes/twentytwenty/template-parts/content.php

    r47799 r51338  
    7575    }
    7676
    77     /**
    78      *  Output comments wrapper if it's a post, or if comments are open,
     77    /*
     78     * Output comments wrapper if it's a post, or if comments are open,
    7979     * or if there's a comment number – and check for password.
    80      * */
     80     */
    8181    if ( ( is_single() || is_page() ) && ( comments_open() || get_comments_number() ) && ! post_password_required() ) {
    8282        ?>

  • branches/5.8/src/wp-content/themes/twentytwenty/template-parts/entry-header.php

    r48264 r51338  
    2626         * @since Twenty Twenty 1.0
    2727         *
    28          * @param bool   Whether to show the categories in header, Default true.
     28         * @param bool Whether to show the categories in header. Default true.
    2929         */
    3030        $show_categories = apply_filters( 'twentytwenty_show_categories_in_entry_header', true );

  • branches/5.8/src/wp-content/themes/twentytwenty/template-parts/pagination.php

    r47122 r51338  
    1010 */
    1111
    12 /**
    13  * Translators:
    14  * This text contains HTML to allow the text to be shorter on small screens.
    15  * The text inside the span with the class nav-short will be hidden on small screens.
    16  */
    17 
    1812$prev_text = sprintf(
    1913    '%s <span class="nav-prev-text">%s</span>',
    2014    '<span aria-hidden="true">&larr;</span>',
     15    /*
     16     * Translators: This text contains HTML to allow the text to be shorter on small screens.
     17     * The text inside the span with the class nav-short will be hidden on small screens.
     18     */
    2119    __( 'Newer <span class="nav-short">Posts</span>', 'twentytwenty' )
    2220);
    2321$next_text = sprintf(
    2422    '<span class="nav-next-text">%s</span> %s',
     23    /*
     24     * Translators: This text contains HTML to allow the text to be shorter on small screens.
     25     * The text inside the span with the class nav-short will be hidden on small screens.
     26     */
    2527    __( 'Older <span class="nav-short">Posts</span>', 'twentytwenty' ),
    2628    '<span aria-hidden="true">&rarr;</span>'

  • branches/5.8/src/wp-content/themes/twentytwentyone/functions.php

    r51320 r51338  
    508508add_action( 'wp_print_footer_scripts', 'twenty_twenty_one_skip_link_focus_fix' );
    509509
    510 /** Enqueue non-latin language styles
     510/**
     511 * Enqueue non-latin language styles.
    511512 *
    512513 * @since Twenty Twenty-One 1.0
Note: See TracChangeset for help on using the changeset viewer.