WordPress.org
Get WordPress

Make WordPress Core

Changeset 60818


Ignore:
Timestamp:
09/30/2025 04:59:02 PM (2 months ago)
Author:
johnbillion
Message:

Menus: Prevent HTML in menu item titles from being rendered unexpectedly.

Merges [60815] and [60816] to the 6.8 branch.

Props audrasjb, desrosj, johnbillion, jorbin, phillsav, vortfu, westonruter

Location:
branches/6.8
Files:
7 edited

Legend:

Unmodified
Added
Removed

  • branches/6.8

  • branches/6.8/src/js/_enqueues/lib/nav-menu.js

    r59950 r60818  
    299299                        $.each( parentDropdowns, function() {
    300300                            var parentDropdown = $( this ),
    301                                 $html = '',
    302                                 $selected = '',
    303                                 currentItemID = parentDropdown.closest( 'li.menu-item' ).find( '.menu-item-data-db-id' ).val(),
    304                                 currentparentID = parentDropdown.closest( 'li.menu-item' ).find( '.menu-item-data-parent-id' ).val(),
     301                                currentItemID = parseInt( parentDropdown.closest( 'li.menu-item' ).find( '.menu-item-data-db-id' ).val() ),
     302                                currentParentID = parseInt( parentDropdown.closest( 'li.menu-item' ).find( '.menu-item-data-parent-id' ).val() ),
    305303                                currentItem = parentDropdown.closest( 'li.menu-item' ),
    306304                                currentMenuItemChild = currentItem.childMenuItems(),
    307                                 excludeMenuItem = [ currentItemID ];
     305                                excludeMenuItem =  /** @type {number[]} */ [ currentItemID ];
     306
     307                            parentDropdown.empty();
    308308
    309309                            if ( currentMenuItemChild.length > 0 ) {
    310310                                $.each( currentMenuItemChild, function(){
    311311                                    var childItem = $(this),
    312                                         childID = childItem.find( '.menu-item-data-db-id' ).val();
     312                                        childID = parseInt( childItem.find( '.menu-item-data-db-id' ).val() );
    313313
    314314                                    excludeMenuItem.push( childID );
    … …  
    316316                            }
    317317
    318                             if ( currentparentID == 0 ) {
    319                                 $selected = 'selected';
    320                             }
    321 
    322                             $html += '<option ' + $selected + ' value="0">' + wp.i18n._x( 'No Parent', 'menu item without a parent in navigation menu' ) + '</option>';
     318                            parentDropdown.append(
     319                                $( '<option>', {
     320                                    value: '0',
     321                                    selected: currentParentID === 0,
     322                                    text: wp.i18n._x( 'No Parent', 'menu item without a parent in navigation menu' ),
     323                                } )
     324                            );
    323325
    324326                            $.each( menuItems, function() {
    325327                                var menuItem = $(this),
    326                                 $selected = '',
    327                                 menuID = menuItem.find( '.menu-item-data-db-id' ).val(),
     328                                menuID = parseInt( menuItem.find( '.menu-item-data-db-id' ).val() ),
    328329                                menuTitle = menuItem.find( '.edit-menu-item-title' ).val();
    329330
    330331                                if ( ! excludeMenuItem.includes( menuID ) ) {
    331                                     if ( currentparentID == menuID ) {
    332                                         $selected = 'selected';
    333                                     }
    334                                     $html += '<option ' + $selected + ' value="' + menuID + '">' + menuTitle + '</option>';
     332                                    parentDropdown.append(
     333                                        $( '<option>', {
     334                                            value: menuID.toString(),
     335                                            selected: currentParentID === menuID,
     336                                            text: menuTitle,
     337                                        } )
     338                                    );
    335339                                }
    336340                            });
    337 
    338                             parentDropdown.html( $html );
    339341                        });
    340342                       
    … …  
    350352                                menuItem = orderDropdown.closest( 'li.menu-item' ).first(),
    351353                                depth = menuItem.menuItemDepth(),
    352                                 isPrimaryMenuItem = ( 0 === depth ),
    353                                 $html = '',
    354                                 $selected = '';
     354                                isPrimaryMenuItem = ( 0 === depth );
     355
     356                            orderDropdown.empty();
    355357
    356358                            if ( isPrimaryMenuItem ) {
    … …  
    361363
    362364                                for ( let i = 1; i < totalMenuItems + 1; i++ ) {
    363                                     $selected = '';
    364                                     if ( i == itemPosition ) {
    365                                         $selected = 'selected';
    366                                     }
    367                                     var itemString = wp.i18n.sprintf(
     365                                    var itemString = wp.i18n.sprintf(
    368366                                        /* translators: 1: The current menu item number, 2: The total number of menu items. */
    369367                                        wp.i18n._x( '%1$s of %2$s', 'part of a total number of menu items' ),
    … …  
    371369                                        totalMenuItems
    372370                                    );
    373                                     $html += '<option ' + $selected + ' value="' + i + '">' + itemString + '</option>';
     371                                    orderDropdown.append(
     372                                        $( '<option>', {
     373                                            selected: i === itemPosition,
     374                                            value: i.toString(),
     375                                            text: itemString,
     376                                        } )
     377                                    );
    374378                                }
    375379
    … …  
    383387
    384388                                for ( let i = 1; i < totalSubMenuItems + 1; i++ ) {
    385                                     $selected = '';
    386                                     if ( i == itemPosition ) {
    387                                         $selected = 'selected';
    388                                     }
    389                                     var submenuString = wp.i18n.sprintf(
     389                                    var submenuString = wp.i18n.sprintf(
    390390                                        /* translators: 1: The current submenu item number, 2: The total number of submenu items. */
    391391                                        wp.i18n._x( '%1$s of %2$s', 'part of a total number of menu items' ),
    … …  
    393393                                        totalSubMenuItems
    394394                                    );
    395                                     $html += '<option ' + $selected + ' value="' + i + '">' + submenuString + '</option>';
     395                                    orderDropdown.append(
     396                                        $( '<option>', {
     397                                            selected: i === itemPosition,
     398                                            value: i.toString(),
     399                                            text: submenuString,
     400                                        } )
     401                                    );
    396402                                }
    397403
    398404                            }
    399 
    400                             orderDropdown.html( $html );
    401405                        });
    402406                       
    … …  
    12911295
    12921296                if ( this.checked === true ) {
    1293                     $( '#pending-menu-items-to-delete ul' ).append(
    1294                         '<li data-menu-item-id="' + menuItemID + '">' +
    1295                             '<span class="pending-menu-item-name">' + menuItemName + '</span> ' +
    1296                             '<span class="pending-menu-item-type">(' + menuItemType + ')</span>' +
    1297                             '<span class="separator"></span>' +
    1298                         '</li>'
    1299                     );
     1297                    const $li = $( '<li>', { 'data-menu-item-id': menuItemID } );
     1298                    $li.append( $( '<span>', {
     1299                        'class': 'pending-menu-item-name',
     1300                        text: menuItemName
     1301                    } ) );
     1302                    $li.append( ' ' );
     1303                    $li.append( $( '<span>', {
     1304                        'class': 'pending-menu-item-type',
     1305                        text: '(' + menuItemType + ')',
     1306                    } ) );
     1307                    $li.append( $( '<span>', { 'class': 'separator' } ) );
     1308                    $( '#pending-menu-items-to-delete ul' ).append( $li );
    13001309                }
    13011310
    … …  
    17001709
    17011710        eventOnClickMenuSave : function() {
    1702             var locs = '',
    1703             menuName = $('#menu-name'),
    1704             menuNameVal = menuName.val();
     1711            var menuName = $('#menu-name'),
     1712                menuNameVal = menuName.val();
    17051713
    17061714            // Cancel and warn if invalid menu name.
    … …  
    17101718            }
    17111719            // Copy menu theme locations.
     1720            // Note: This appears to be dead code since #nav-menu-theme-locations no longer exists, perhaps removed in r32842.
     1721            var $updateNavMenu = $('#update-nav-menu');
    17121722            $('#nav-menu-theme-locations select').each(function() {
    1713                 locs += '<input type="hidden" name="' + this.name + '" value="' + $(this).val() + '" />';
    1714             });
    1715             $('#update-nav-menu').append( locs );
     1723                $updateNavMenu.append(
     1724                    $( '<input>', {
     1725                        type: 'hidden',
     1726                        name: this.name,
     1727                        value: $( this ).val(),
     1728                    } )
     1729                );
     1730            });
    17161731            // Update menu item position data.
    17171732            api.menuList.find('.menu-item-data-position').val( function(index) { return index + 1; } );
    … …  
    17561771
    17571772            if( ! $items.length ) {
    1758                 $('.categorychecklist', panel).html( '<li><p>' + wp.i18n.__( 'No results found.' ) + '</p></li>' );
     1773                const li = $( '<li>' );
     1774                const p = $( '<p>', { text: wp.i18n.__( 'No results found.' ) } );
     1775                li.append( p );
     1776                $('.categorychecklist', panel).empty().append( li );
    17591777                $( '.spinner', panel ).removeClass( 'is-active' );
    17601778                wrapper.addClass( 'has-no-menu-item' );

  • branches/6.8/src/js/_enqueues/wp/customize/nav-menus.js

    r59948 r60818  
    530530            }
    531531
    532             this.currentMenuControl.addItemToMenu( menu_item.attributes );
     532            // Leave the title as empty to reuse the original title as a placeholder if set.
     533            var nav_menu_item = Object.assign( {}, menu_item.attributes );
     534            if ( nav_menu_item.title === nav_menu_item.original_title ) {
     535                nav_menu_item.title = '';
     536            }
     537
     538            this.currentMenuControl.addItemToMenu( nav_menu_item );
    533539
    534540            $( menuitemTpl ).find( '.menu-item-handle' ).addClass( 'item-added' );
    … …  
    31373143                {
    31383144                    nav_menu_term_id: menuControl.params.menu_id,
    3139                     original_title: item.title,
    31403145                    position: position
    31413146                }

  • branches/6.8/src/wp-includes/class-wp-customize-nav-menus.php

    r59948 r60818  
    192192            } elseif ( 'post' !== $object_name && 0 === $page && $post_type->has_archive ) {
    193193                // Add a post type archive link.
     194                $title   = $post_type->labels->archives;
    194195                $items[] = array(
    195                     'id'         => $object_name . '-archive',
    196                     'title'      => $post_type->labels->archives,
    197                     'type'       => 'post_type_archive',
    198                     'type_label' => __( 'Post Type Archive' ),
    199                     'object'     => $object_name,
    200                     'url'        => get_post_type_archive_link( $object_name ),
     196                    'id'             => $object_name . '-archive',
     197                    'title'          => $title,
     198                    'original_title' => $title,
     199                    'type'           => 'post_type_archive',
     200                    'type_label'     => __( 'Post Type Archive' ),
     201                    'object'         => $object_name,
     202                    'url'            => get_post_type_archive_link( $object_name ),
    201203                );
    202204            }
    … …  
    245247                }
    246248
     249                $title   = html_entity_decode( $post_title, ENT_QUOTES, get_bloginfo( 'charset' ) );
    247250                $items[] = array(
    248                     'id'         => "post-{$post->ID}",
    249                     'title'      => html_entity_decode( $post_title, ENT_QUOTES, get_bloginfo( 'charset' ) ),
    250                     'type'       => 'post_type',
    251                     'type_label' => $post_type_label,
    252                     'object'     => $post->post_type,
    253                     'object_id'  => (int) $post->ID,
    254                     'url'        => get_permalink( (int) $post->ID ),
     251                    'id'             => "post-{$post->ID}",
     252                    'title'          => $title,
     253                    'original_title' => $title,
     254                    'type'           => 'post_type',
     255                    'type_label'     => $post_type_label,
     256                    'object'         => $post->post_type,
     257                    'object_id'      => (int) $post->ID,
     258                    'url'            => get_permalink( (int) $post->ID ),
    255259                );
    256260            }
    … …  
    277281
    278282            foreach ( $terms as $term ) {
     283                $title   = html_entity_decode( $term->name, ENT_QUOTES, get_bloginfo( 'charset' ) );
    279284                $items[] = array(
    280                     'id'         => "term-{$term->term_id}",
    281                     'title'      => html_entity_decode( $term->name, ENT_QUOTES, get_bloginfo( 'charset' ) ),
    282                     'type'       => 'taxonomy',
    283                     'type_label' => get_taxonomy( $term->taxonomy )->labels->singular_name,
    284                     'object'     => $term->taxonomy,
    285                     'object_id'  => (int) $term->term_id,
    286                     'url'        => get_term_link( (int) $term->term_id, $term->taxonomy ),
     285                    'id'             => "term-{$term->term_id}",
     286                    'title'          => $title,
     287                    'original_title' => $title,
     288                    'type'           => 'taxonomy',
     289                    'type_label'     => get_taxonomy( $term->taxonomy )->labels->singular_name,
     290                    'object'         => $term->taxonomy,
     291                    'object_id'      => (int) $term->term_id,
     292                    'url'            => get_term_link( (int) $term->term_id, $term->taxonomy ),
    287293                );
    288294            }

  • branches/6.8/src/wp-includes/customize/class-wp-customize-nav-menu-item-setting.php

    r56548 r60818  
    5757        'xfn'              => '',
    5858        'status'           => 'publish',
    59         'original_title'   => '',
    6059        'nav_menu_term_id' => 0, // This will be supplied as the $menu_id arg for wp_update_nav_menu_item().
    6160        '_invalid'         => false,
    … …  
    211210     */
    212211    public function value() {
     212        $type_label = null;
    213213        if ( $this->is_previewed && get_current_blog_id() === $this->_previewed_blog_id ) {
    214214            $undefined  = new stdClass(); // Symbol.
    … …  
    219219            } else {
    220220                $value = $post_value;
    221             }
    222             if ( ! empty( $value ) && empty( $value['original_title'] ) ) {
    223                 $value['original_title'] = $this->get_original_title( (object) $value );
    224221            }
    225222        } elseif ( isset( $this->value ) ) {
    … …  
    234231                    $is_title_empty = empty( $post->post_title );
    235232                    $value          = (array) wp_setup_nav_menu_item( $post );
     233                    if ( isset( $value['type_label'] ) ) {
     234                        $type_label = $value['type_label'];
     235                    }
    236236                    if ( $is_title_empty ) {
    237237                        $value['title'] = '';
    … …  
    250250        }
    251251
    252         if ( ! empty( $value ) && empty( $value['type_label'] ) ) {
    253             $value['type_label'] = $this->get_type_label( (object) $value );
     252        // These properties are read-only and are part of the setting for use in the Customizer UI.
     253        if ( is_array( $value ) ) {
     254            $value_obj               = (object) $value;
     255            $value['type_label']     = isset( $type_label ) ? $type_label : $this->get_type_label( $value_obj );
     256            $value['original_title'] = $this->get_original_title( $value_obj );
    254257        }
    255258
    … …  
    258261
    259262    /**
     263     * Prepares the value for editing on the client.
     264     *
     265     * @since 6.8.3
     266     *
     267     * @return array|false Value prepared for the client.
     268     */
     269    public function js_value() {
     270        $value = parent::js_value();
     271        if ( is_array( $value ) && isset( $value['original_title'] ) ) {
     272            // Decode entities for the sake of displaying the original title as a placeholder.
     273            $value['original_title'] = html_entity_decode( $value['original_title'], ENT_QUOTES, get_bloginfo( 'charset' ) );
     274        }
     275        return $value;
     276    }
     277
     278    /**
    260279     * Get original title.
    261280     *
    … …  
    263282     *
    264283     * @param object $item Nav menu item.
    265      * @return string The original title.
     284     * @return string The original title, without entity decoding.
    266285     */
    267286    protected function get_original_title( $item ) {
    … …  
    289308            }
    290309        }
    291         $original_title = html_entity_decode( $original_title, ENT_QUOTES, get_bloginfo( 'charset' ) );
    292310        return $original_title;
    293311    }
    … …  
    345363            $this->value['status'] = $this->value['post_status'];
    346364            unset( $this->value['post_status'] );
    347         }
    348 
    349         if ( ! isset( $this->value['original_title'] ) ) {
    350             $this->value['original_title'] = $this->get_original_title( (object) $this->value );
    351365        }
    352366
    … …  
    595609        unset( $item->position );
    596610
    597         if ( empty( $item->original_title ) ) {
    598             $item->original_title = $this->get_original_title( $item );
    599         }
    600611        if ( empty( $item->title ) && ! empty( $item->original_title ) ) {
    601             $item->title = $item->original_title;
     612            $item->title = $item->original_title; // This is NOT entity-decoded. It comes from self::get_original_title().
    602613        }
    603614        if ( $item->title ) {
    … …  
    655666     * @since 5.9.0 Renamed `$menu_item_value` to `$value` for PHP 8 named parameter support.
    656667     *
    657      * @param array $value The menu item value to sanitize.
     668     * @param array|false $value The menu item value to sanitize.
    658669     * @return array|false|null|WP_Error Null or WP_Error if an input isn't valid. False if it is marked for deletion.
    659670     *                                   Otherwise the sanitized value.
    … …  
    712723        }
    713724
    714         $menu_item_value['original_title'] = sanitize_text_field( $menu_item_value['original_title'] );
    715 
    716725        // Apply the same filters as when calling wp_insert_post().
    717726

  • branches/6.8/tests/phpunit/tests/customize/nav-menu-item-setting.php

    r56421 r60818  
    9090            'xfn'              => '',
    9191            'status'           => 'publish',
    92             'original_title'   => '',
    9392            'nav_menu_term_id' => 0,
    9493            '_invalid'         => false,
    … …  
    582581            'xfn'              => 'hello  inject',
    583582            'status'           => 'draft',
    584             'original_title'   => 'Hi',
     583            'original_title'   => 'Hi<script>unfilteredHtml()</script>',
    585584            'nav_menu_term_id' => 0,
    586585        );

  • branches/6.8/tests/phpunit/tests/customize/nav-menus.php

    r59224 r60818  
    169169        // Expected menu item array.
    170170        $expected = array(
    171             'id'         => "post-{$post_id}",
    172             'title'      => 'Post Title',
    173             'type'       => 'post_type',
    174             'type_label' => 'Post',
    175             'object'     => 'post',
    176             'object_id'  => (int) $post_id,
    177             'url'        => get_permalink( (int) $post_id ),
     171            'id'             => "post-{$post_id}",
     172            'title'          => 'Post Title',
     173            'original_title' => 'Post Title',
     174            'type'           => 'post_type',
     175            'type_label'     => 'Post',
     176            'object'         => 'post',
     177            'object_id'      => (int) $post_id,
     178            'url'            => get_permalink( (int) $post_id ),
    178179        );
    179180
    … …  
    201202        // Expected menu item array.
    202203        $expected = array(
    203             'id'         => "post-{$page_id}",
    204             'title'      => 'Page Title',
    205             'type'       => 'post_type',
    206             'type_label' => 'Page',
    207             'object'     => 'page',
    208             'object_id'  => (int) $page_id,
    209             'url'        => get_permalink( (int) $page_id ),
     204            'id'             => "post-{$page_id}",
     205            'title'          => 'Page Title',
     206            'original_title' => 'Page Title',
     207            'type'           => 'post_type',
     208            'type_label'     => 'Page',
     209            'object'         => 'page',
     210            'object_id'      => (int) $page_id,
     211            'url'            => get_permalink( (int) $page_id ),
    210212        );
    211213
    … …  
    227229        // Expected menu item array.
    228230        $expected = array(
    229             'id'         => "post-{$post_id}",
    230             'title'      => 'Post Title',
    231             'type'       => 'post_type',
    232             'type_label' => 'Post',
    233             'object'     => 'post',
    234             'object_id'  => (int) $post_id,
    235             'url'        => get_permalink( (int) $post_id ),
     231            'id'             => "post-{$post_id}",
     232            'title'          => 'Post Title',
     233            'original_title' => 'Post Title',
     234            'type'           => 'post_type',
     235            'type_label'     => 'Post',
     236            'object'         => 'post',
     237            'object_id'      => (int) $post_id,
     238            'url'            => get_permalink( (int) $post_id ),
    236239        );
    237240
    … …  
    253256        // Expected menu item array.
    254257        $expected = array(
    255             'id'         => "term-{$term_id}",
    256             'title'      => 'Term Title',
    257             'type'       => 'taxonomy',
    258             'type_label' => 'Category',
    259             'object'     => 'category',
    260             'object_id'  => (int) $term_id,
    261             'url'        => get_term_link( (int) $term_id, 'category' ),
     258            'id'             => "term-{$term_id}",
     259            'title'          => 'Term Title',
     260            'original_title' => 'Term Title',
     261            'type'           => 'taxonomy',
     262            'type_label'     => 'Category',
     263            'object'         => 'category',
     264            'object_id'      => (int) $term_id,
     265            'url'            => get_term_link( (int) $term_id, 'category' ),
    262266        );
    263267
Note: See TracChangeset for help on using the changeset viewer.