WordPress.org

Make WordPress Core

Ticket #41069: tags.js.patch

File tags.js.patch, 7.1 KB (added by jipmoors, 5 years ago)

Documented tags.js

  • src/wp-admin/includes/class-wp-community-events.php

    diff --git src/wp-admin/includes/class-wp-community-events.php src/wp-admin/includes/class-wp-community-events.php
    index cfe12fd52c..211d37ea5e 100644
    class WP_Community_Events { 
    107107                } elseif ( 200 !== $response_code ) {
    108108                        $response_error = new WP_Error(
    109109                                'api-error',
    110                                 /* translators: %s is a numeric HTTP status code; e.g., 400, 403, 500, 504, etc. */
     110                                /* translators: %d: numeric HTTP status code, e.g. 400, 403, 500, 504, etc. */
    111111                                sprintf( __( 'Invalid API response code (%d)' ), $response_code )
    112112                        );
    113113                } elseif ( ! isset( $response_body['location'], $response_body['events'] ) ) {
  • src/wp-admin/js/tags.js

    diff --git src/wp-admin/js/tags.js src/wp-admin/js/tags.js
    index fc923f1f8d..c35efaa177 100644
     
    11/* global ajaxurl, wpAjax, tagsl10n, showNotice, validateForm */
     2/**
     3 * Contains logic for both adding and deleting tags. For deleting tags it makes a request
     4 * to the server to delete the tag. For adding tags it makes a request to the server to
     5 * add the tag.
     6 *
     7 * @summary Contains logic for deleting and adding tags
     8 */
    29
    310jQuery(document).ready(function($) {
    411
     12        /**
     13         * @summary Adds an event handler to the delete term link on the term overview page.
     14         *
     15         * Adds an event handler to the delete term link on the term overview page.
     16         * Cancels default event handling and event bubbling.
     17         *
     18         * @since 2.8.0
     19         *
     20         * @returns boolean Always returns false to cancel the default event handling.
     21         */
    522        $( '#the-list' ).on( 'click', '.delete-tag', function() {
    623                var t = $(this), tr = t.parents('tr'), r = true, data;
     24
    725                if ( 'undefined' != showNotice )
    826                        r = showNotice.warn();
     27
    928                if ( r ) {
    1029                        data = t.attr('href').replace(/[^?]*\?/, '').replace(/action=delete/, 'action=delete-tag');
     30
     31                        /**
     32                         * @summary Makes a request to the server to delete the term that
     33                         * corresponds to the delete term button.
     34                         *
     35                         * @param {string} r The response from the server.
     36                         *
     37                         * @returns {void}
     38                         */
    1139                        $.post(ajaxurl, data, function(r){
    1240                                if ( '1' == r ) {
    1341                                        $('#ajax-response').empty();
    1442                                        tr.fadeOut('normal', function(){ tr.remove(); });
    15                                         // Remove the term from the parent box and tag cloud
     43
     44                                        /**
     45                                         * @summary Remove the term from the parent box and the tag cloud
     46                                         *
     47                                         * `data.match(/tag_ID=(\d+)/)[1]` matches the term id from the data variable.
     48                                         * This term id is then used to select the relevant HTML elements:
     49                                         * The parent box and the tag cloud.
     50                                         */
    1651                                        $('select#parent option[value="' + data.match(/tag_ID=(\d+)/)[1] + '"]').remove();
    1752                                        $('a.tag-link-' + data.match(/tag_ID=(\d+)/)[1]).remove();
     53
    1854                                } else if ( '-1' == r ) {
    1955                                        $('#ajax-response').empty().append('<div class="error"><p>' + tagsl10n.noPerm + '</p></div>');
    2056                                        tr.children().css('backgroundColor', '');
     57
    2158                                } else {
    2259                                        $('#ajax-response').empty().append('<div class="error"><p>' + tagsl10n.broken + '</p></div>');
    2360                                        tr.children().css('backgroundColor', '');
    2461                                }
    2562                        });
     63
    2664                        tr.children().css('backgroundColor', '#f33');
    2765                }
     66
    2867                return false;
    2968        });
    3069
     70        /**
     71         * Adds a deletion confirmation when removing a tag.
     72         *
     73         * @since 4.8.0
     74         *
     75         * @returns {void}
     76         */
    3177        $( '#edittag' ).on( 'click', '.delete', function( e ) {
    3278                if ( 'undefined' === typeof showNotice ) {
    3379                        return true;
    3480                }
    3581
     82                // Confirms the deletion, a negative response means the deletion must not be executed.
    3683                var response = showNotice.warn();
    3784                if ( ! response ) {
    3885                        e.preventDefault();
    3986                }
    4087        });
    4188
     89        /**
     90         * @summary Adds an event handler tot he form submit on the term overview page.
     91         *
     92         * Cancels default event handling and event bubbling.
     93         *
     94         * @since 2.8.0
     95         *
     96         * @returns boolean Always returns false to cancel the default event handling.
     97         */
    4298        $('#submit').click(function(){
    4399                var form = $(this).parents('form');
    44100
    45101                if ( ! validateForm( form ) )
    46102                        return false;
    47103
     104                /**
     105                 * Does a request to the server to add a new term to the database
     106                 *
     107                 * @param {string} r The response from the server.
     108                 *
     109                 * @returns {void}
     110                 */
    48111                $.post(ajaxurl, $('#addtag').serialize(), function(r){
    49112                        var res, parent, term, indent, i;
    50113
  • src/wp-content/themes/twentysixteen/inc/template-tags.php

    diff --git src/wp-content/themes/twentysixteen/inc/template-tags.php src/wp-content/themes/twentysixteen/inc/template-tags.php
    index eb87203062..fa1ad8efed 100644
    function twentysixteen_categorized_blog() { 
    213213                set_transient( 'twentysixteen_categories', $all_the_cool_cats );
    214214        }
    215215
    216         if ( $all_the_cool_cats > 1 ) {
     216        if ( $all_the_cool_cats > 1 || is_preview() ) {
    217217                // This blog has more than 1 category so twentysixteen_categorized_blog should return true.
    218218                return true;
    219219        } else {
  • src/wp-includes/class-wp-editor.php

    diff --git src/wp-includes/class-wp-editor.php src/wp-includes/class-wp-editor.php
    index 8879797914..73de84de2b 100644
    final class _WP_Editors { 
    144144         * @static
    145145         * @param string $content The initial content of the editor.
    146146         * @param string $editor_id ID for the textarea and TinyMCE and Quicktags instances (can contain only ASCII letters and numbers).
    147          * @param array $settings See the _parse_settings() method for description.
     147         * @param array $settings See _WP_Editors()::parse_settings() for description.
    148148         */
    149149        public static function editor( $content, $editor_id, $settings = array() ) {
    150150                $set = self::parse_settings( $editor_id, $settings );
  • src/wp-includes/functions.php

    diff --git src/wp-includes/functions.php src/wp-includes/functions.php
    index 966dcd8265..828f123491 100644
    function date_i18n( $dateformatstring, $unixtimestamp = false, $gmt = false ) { 
    158158 *
    159159 * @since 4.4.0
    160160 *
     161 * @global WP_Locale $wp_locale
     162 *
    161163 * @param string $date Formatted date string.
    162164 * @return string The date, declined if locale specifies it.
    163165 */
  • src/wp-includes/vars.php

    diff --git src/wp-includes/vars.php src/wp-includes/vars.php
    index 2e97c9a0ae..89b3532327 100644
    function wp_is_mobile() { 
    139139                $is_mobile = false;
    140140        }
    141141
    142         return $is_mobile;
     142        /**
     143         * Filters whether the request should be treated as coming from a mobile device or not.
     144         *
     145         * @since 4.9.0
     146         *
     147         * @param bool $is_mobile Whether the request is from a mobile device or not.
     148         */
     149        return apply_filters( 'wp_is_mobile', $is_mobile );
    143150}
  • src/wp-includes/wp-db.php

    diff --git src/wp-includes/wp-db.php src/wp-includes/wp-db.php
    index 74dedd5130..2c9cceabf7 100644
    class wpdb { 
    32683268         *
    32693269         * @param string $db_cap The feature to check for. Accepts 'collation',
    32703270         *                       'group_concat', 'subqueries', 'set_charset',
    3271          *                       or 'utf8mb4'.
     3271         *                       'utf8mb4', or 'utf8mb4_520'.
    32723272         * @return int|false Whether the database feature is supported, false otherwise.
    32733273         */
    32743274        public function has_cap( $db_cap ) {