WordPress.org
Get WordPress

Make WordPress Core

Ticket #30473: 30473.diff

File 30473.diff, 54.8 KB (added by DrewAPicture, 12 years ago)

props rarst

  • src/wp-admin/admin-header.php

     
    108108do_action( 'admin_print_scripts' );
    109109
    110110/**
    111  * Fires in <head> for a specific admin page based on $hook_suffix.
     111 * Fires in head section for a specific admin page based on $hook_suffix.
    112112 *
    113113 * @since 2.1.0
    114114 */
    115115do_action( "admin_head-$hook_suffix" );
    116116
    117117/**
    118  * Fires in <head> for all admin pages.
     118 * Fires in head section for all admin pages.
    119119 *
    120120 * @since 2.1.0
    121121 */
    … …  
    159159</head>
    160160<?php
    161161/**
    162  * Filter the admin <body> CSS classes.
     162 * Filter the admin body tag CSS classes.
    163163 *
    164164 * This filter differs from the post_class or body_class filters in two important ways:
    165165 * 1. $classes is a space-separated string of class names instead of an array.

  • src/wp-admin/edit-form-advanced.php

     
    400400</div>
    401401<?php
    402402/**
    403  * Fires inside the post editor <form> tag.
     403 * Fires inside the post editor form tag.
    404404 *
    405405 * @since 3.0.0
    406406 *

  • src/wp-admin/includes/class-wp-list-table.php

     
    913913        }
    914914
    915915        /**
    916          * Get a list of CSS classes for the <table> tag
     916         * Get a list of CSS classes for the table tag
    917917         *
    918918         * @since 3.1.0
    919919         * @access protected
    … …  
    958958        protected function extra_tablenav( $which ) {}
    959959
    960960        /**
    961          * Generate the <tbody> part of the table
     961         * Generate the tbody part of the table
    962962         *
    963963         * @since 3.1.0
    964964         * @access public

  • src/wp-admin/includes/class-wp-users-list-table.php

     
    331331         * @access public
    332332         *
    333333         * @param object $user_object The current user object.
    334          * @param string $style       Optional. Style attributes added to the <tr> element.
     334         * @param string $style       Optional. Style attributes added to the tr element.
    335335         *                            Must be sanitized. Default empty.
    336336         * @param string $role        Optional. Key for the $wp_roles array. Default empty.
    337337         * @param int    $numposts    Optional. Post count to display for this user. Defaults

  • src/wp-admin/includes/file.php

     
    871871 * The priority of the Transports are: Direct, SSH2, FTP PHP Extension, FTP Sockets (Via Sockets class, or fsockopen())
    872872 *
    873873 * Note that the return value of this function can be overridden in 2 ways
    874  *  - By defining FS_METHOD in your <code>wp-config.php</code> file
     874 *  - By defining FS_METHOD in your `wp-config.php` file
    875875 *  - By using the filesystem_method filter
    876876 * Valid values for these are: 'direct', 'ssh2', 'ftpext' or 'ftpsockets'
    877877 * Plugins may also define a custom transport handler, See the WP_Filesystem function for more information.
    … …  
    948948 *
    949949 * Hostnames may be in the form of hostname:portnumber (eg: wordpress.org:2467) to specify an alternate FTP/SSH port.
    950950 *
    951  * Plugins may override this form by returning true|false via the <code>request_filesystem_credentials</code> filter.
     951 * Plugins may override this form by returning true|false via the `request_filesystem_credentials` filter.
    952952 *
    953953 * @since 2.5.0
    954954 *

  • src/wp-admin/includes/media.php

     
    23492349/**
    23502350 * Filter the media upload mime type list items.
    23512351 *
    2352  * Returned values should begin with an <li> tag.
     2352 * Returned values should begin with an li tag.
    23532353 *
    23542354 * @since 3.1.0
    23552355 *

  • src/wp-admin/includes/plugin.php

     
    1414 * must not have any newlines or only parts of the description will be displayed
    1515 * and the same goes for the plugin data. The below is formatted for printing.
    1616 *
    17  * <code>
    18  * /*
    19  * Plugin Name: Name of Plugin
    20  * Plugin URI: Link to plugin information
    21  * Description: Plugin Description
    22  * Author: Plugin author's name
    23  * Author URI: Link to the author's web site
    24  * Version: Must be set in the plugin for WordPress 2.3+
    25  * Text Domain: Optional. Unique identifier, should be same as the one used in
    26  *              plugin_text_domain()
    27  * Domain Path: Optional. Only useful if the translations are located in a
    28  *              folder above the plugin's base path. For example, if .mo files are
    29  *              located in the locale folder then Domain Path will be "/locale/" and
    30  *              must have the first slash. Defaults to the base folder the plugin is
    31  *              located in.
    32  * Network: Optional. Specify "Network: true" to require that a plugin is activated
    33  *              across all sites in an installation. This will prevent a plugin from being
    34  *              activated on a single site when Multisite is enabled.
    35  *  * / # Remove the space to close comment
    36  * </code>
     17 *     /*
     18 *     Plugin Name: Name of Plugin
     19 *     Plugin URI: Link to plugin information
     20 *     Description: Plugin Description
     21 *     Author: Plugin author's name
     22 *     Author URI: Link to the author's web site
     23 *     Version: Must be set in the plugin for WordPress 2.3+
     24 *     Text Domain: Optional. Unique identifier, should be same as the one used in
     25 *              plugin_text_domain()
     26 *     Domain Path: Optional. Only useful if the translations are located in a
     27 *              folder above the plugin's base path. For example, if .mo files are
     28 *              located in the locale folder then Domain Path will be "/locale/" and
     29 *              must have the first slash. Defaults to the base folder the plugin is
     30 *              located in.
     31 *     Network: Optional. Specify "Network: true" to require that a plugin is activated
     32 *              across all sites in an installation. This will prevent a plugin from being
     33 *              activated on a single site when Multisite is enabled.
     34 *      * / # Remove the space to close comment
    3735 *
    3836 * Plugin data returned array contains the following:
    3937 *              'Name' - Name of the plugin, must be unique.

  • src/wp-admin/includes/template.php

     
    1313//
    1414
    1515/**
    16  * Walker to output an unordered list of category checkbox <input> elements.
     16 * Walker to output an unordered list of category checkbox input elements.
    1717 *
    1818 * @see Walker
    1919 * @see wp_category_checklist()
    … …  
    112112}
    113113
    114114/**
    115  * Output an unordered list of checkbox <input> elements labelled
     115 * Output an unordered list of checkbox input elements labelled
    116116 * with category names.
    117117 *
    118118 * @see wp_terms_checklist()
    … …  
    137137}
    138138
    139139/**
    140  * Output an unordered list of checkbox <input> elements labelled
     140 * Output an unordered list of checkbox input elements labelled
    141141 * with term names. Taxonomy independent version of wp_category_checklist().
    142142 *
    143143 * @since 3.0.0
    … …  
    236236 * Retrieve a list of the most popular terms from the specified taxonomy.
    237237 *
    238238 * If the $echo argument is true then the elements for a list of checkbox
    239  * <input> elements labelled with the names of the selected terms is output.
     239 * input elements labelled with the names of the selected terms is output.
    240240 * If the $post_ID global isn't empty then the terms associated with that
    241241 * post will be marked as checked.
    242242 *
    … …  
    782782}
    783783
    784784/**
    785  * Print out <option> HTML elements for the page templates drop-down.
     785 * Print out option HTML elements for the page templates drop-down.
    786786 *
    787787 * @since 1.5.0
    788788 *
    … …  
    798798}
    799799
    800800/**
    801  * Print out <option> HTML elements for the page parents drop-down.
     801 * Print out option HTML elements for the page parents drop-down.
    802802 *
    803803 * @since 1.5.0
    804804 *
    … …  
    831831}
    832832
    833833/**
    834  * Print out <option> html elements for role selectors
     834 * Print out option html elements for role selectors
    835835 *
    836836 * @since 2.1.0
    837837 *
    … …  
    13111311 *
    13121312 * @param string $setting Slug title of the setting to which this error applies
    13131313 * @param string $code Slug-name to identify the error. Used as part of 'id' attribute in HTML output.
    1314  * @param string $message The formatted message text to display to the user (will be shown inside styled <div> and <p>)
     1314 * @param string $message The formatted message text to display to the user (will be shown inside styled 'div' and 'p')
    13151315 * @param string $type The type of message it is, controls HTML class. Use 'error' or 'updated'.
    13161316 */
    13171317function add_settings_error( $setting, $code, $message, $type = 'error' ) {
    … …  
    13841384/**
    13851385 * Display settings errors registered by add_settings_error()
    13861386 *
    1387  * Part of the Settings API. Outputs a <div> for each error retrieved by get_settings_errors().
     1387 * Part of the Settings API. Outputs a div for each error retrieved by get_settings_errors().
    13881388 *
    13891389 * This is called automatically after a settings page based on the Settings API is submitted.
    13901390 * Errors should be added during the validation callback function for a setting defined in register_setting()

  • src/wp-admin/index.php

     
    112112                 * Add content to the welcome panel on the admin dashboard.
    113113                 *
    114114                 * To remove the default welcome panel, use remove_action():
    115                  * <code>remove_action( 'welcome_panel', 'wp_welcome_panel' );</code>
     115                 * `remove_action( 'welcome_panel', 'wp_welcome_panel' );`
    116116                 *
    117117                 * @since 3.5.0
    118118                 */

  • src/wp-admin/install-helper.php

     
    1010 * needing to use these functions a lot, you might experience time outs. If you
    1111 * do, then it is advised to just write the SQL code yourself.
    1212 *
    13  * <code>
    14  * check_column('wp_links', 'link_description', 'mediumtext');
    15  * if (check_column($wpdb->comments, 'comment_author', 'tinytext'))
    16  *     echo "ok\n";
     13 *     check_column('wp_links', 'link_description', 'mediumtext');
     14 *     if (check_column($wpdb->comments, 'comment_author', 'tinytext'))
     15 *         echo "ok\n";
    1716 *
    18  * $error_count = 0;
    19  * $tablename = $wpdb->links;
    20  * // check the column
    21  * if (!check_column($wpdb->links, 'link_description', 'varchar(255)')) {
    22  *     $ddl = "ALTER TABLE $wpdb->links MODIFY COLUMN link_description varchar(255) NOT NULL DEFAULT '' ";
    23  *     $q = $wpdb->query($ddl);
    24  * }
     17 *     $error_count = 0;
     18 *     $tablename = $wpdb->links;
     19 *     // check the column
     20 *     if (!check_column($wpdb->links, 'link_description', 'varchar(255)')) {
     21 *         $ddl = "ALTER TABLE $wpdb->links MODIFY COLUMN link_description varchar(255) NOT NULL DEFAULT '' ";
     22 *         $q = $wpdb->query($ddl);
     23 *     }
    2524 *
    26  * if (check_column($wpdb->links, 'link_description', 'varchar(255)')) {
    27  *     $res .= $tablename . ' - ok <br />';
    28  * } else {
    29  *     $res .= 'There was a problem with ' . $tablename . '<br />';
    30  *     ++$error_count;
    31  * }
    32  * </code>
     25 *     if (check_column($wpdb->links, 'link_description', 'varchar(255)')) {
     26 *         $res .= $tablename . ' - ok <br />';
     27 *     } else {
     28 *         $res .= 'There was a problem with ' . $tablename . '<br />';
     29 *         ++$error_count;
     30 *     }
    3331 *
    3432 * @package WordPress
    3533 * @subpackage Plugin

  • src/wp-includes/bookmark-template.php

     
    3434 *                                      or 0|false. Default 1|true.
    3535 *     @type int|bool $show_name        Whether to show link name if available. Accepts 1|true or
    3636 *                                      0|false. Default 0|false.
    37  *     @type string   $before           The HTML or text to prepend to each bookmark. Default '<li>'.
    38  *     @type string   $after            The HTML or text to append to each bookmark. Default '</li>'.
     37 *     @type string   $before           The HTML or text to prepend to each bookmark. Defaults to opening li tag..
     38 *     @type string   $after            The HTML or text to append to each bookmark. Defaults to closing li tag..
    3939 *     @type string   $link_before      The HTML or text to prepend to each bookmark inside the anchor
    4040 *                                      tags. Default empty.
    4141 *     @type string   $link_after       The HTML or text to append to each bookmark inside the anchor

  • src/wp-includes/capabilities.php

     
    1313 * the name in value of the 'name' key. The capabilities are stored as an array
    1414 * in the value of the 'capability' key.
    1515 *
    16  * <code>
    17  * array (
    18  *              'rolename' => array (
    19  *                      'name' => 'rolename',
    20  *                      'capabilities' => array()
    21  *              )
    22  * )
    23  * </code>
     16 *     array (
     17 *              'rolename' => array (
     18 *                      'name' => 'rolename',
     19 *                      'capabilities' => array()
     20 *              )
     21 *     )
    2422 *
    2523 * @since 2.0.0
    2624 * @package WordPress

  • src/wp-includes/class-http.php

     
    16601660 * </ol>
    16611661 *
    16621662 * An example can be as seen below.
    1663  * <code>
    1664  * define('WP_PROXY_HOST', '192.168.84.101');
    1665  * define('WP_PROXY_PORT', '8080');
    1666  * define('WP_PROXY_BYPASS_HOSTS', 'localhost, www.example.com, *.wordpress.org');
    1667  * </code>
    16681663 *
     1664 *     define('WP_PROXY_HOST', '192.168.84.101');
     1665 *     define('WP_PROXY_PORT', '8080');
     1666 *     define('WP_PROXY_BYPASS_HOSTS', 'localhost, www.example.com, *.wordpress.org');
     1667 *
    16691668 * @link https://core.trac.wordpress.org/ticket/4011 Proxy support ticket in WordPress.
    16701669 * @link https://core.trac.wordpress.org/ticket/14636 Allow wildcard domains in WP_PROXY_BYPASS_HOSTS
    16711670 * @since 2.8.0

  • src/wp-includes/class-oembed.php

     
    291291        }
    292292
    293293        /**
    294          * Attempts to find oEmbed provider discovery <link> tags at the given URL.
     294         * Attempts to find oEmbed provider discovery link tags at the given URL.
    295295         *
    296          * @param string $url The URL that should be inspected for discovery <link> tags.
     296         * @param string $url The URL that should be inspected for discovery link tags.
     297         *
    297298         * @return bool|string False on failure, otherwise the oEmbed provider URL.
    298299         */
    299300        public function discover( $url ) {

  • src/wp-includes/class-wp-editor.php

     
    4848         *     @type string     $tabfocus_elements The previous and next element ID to move the focus to
    4949         *                                         when pressing the Tab key in TinyMCE. Defualt ':prev,:next'.
    5050         *     @type string     $editor_css        Intended for extra styles for both Visual and Text editors.
    51          *                                         Should include <style> tags, and can use "scoped". Default empty.
     51         *                                         Should include style tags, and can use "scoped". Default empty.
    5252         *     @type string     $editor_class      Extra classes to add to the editor textarea elemen. Default empty.
    5353         *     @type bool       $teeny             Whether to output the minimal editor config. Examples include
    5454         *                                         Press This and the Comment editor. Default false.

  • src/wp-includes/class-wp-embed.php

     
    223223                        }
    224224
    225225                        /**
    226                          * Filter whether to inspect the given URL for discoverable <link> tags.
     226                         * Filter whether to inspect the given URL for discoverable link tags.
    227227                         *
    228228                         * @since 2.9.0
    229229                         *
    230230                         * @see WP_oEmbed::discover()
    231231                         *
    232                          * @param bool $enable Whether to enable <link> tag discovery. Default false.
     232                         * @param bool $enable Whether to enable link tag discovery. Default false.
    233233                         */
    234234                        $attr['discover'] = ( apply_filters( 'embed_oembed_discover', false ) && author_can( $post_ID, 'unfiltered_html' ) );
    235235

  • src/wp-includes/class.wp-dependencies.php

     
    104104                                 * but no source. Queuing the item queues the dependencies.
    105105                                 *
    106106                                 * Example: The extending class WP_Scripts is used to register 'scriptaculous' as a set of registered handles:
    107                                  *   <code>add( 'scriptaculous', false, array( 'scriptaculous-dragdrop', 'scriptaculous-slider', 'scriptaculous-controls' ) );</code>
     107                                 * `add( 'scriptaculous', false, array( 'scriptaculous-dragdrop', 'scriptaculous-slider', 'scriptaculous-controls' ) );`
    108108                                 *
    109109                                 * The src property is false.
    110110                                **/

  • src/wp-includes/comment-template.php

     
    21372137 *     }
    21382138 *     @type string $comment_field        The comment textarea field HTML.
    21392139 *     @type string $must_log_in          HTML element for a 'must be logged in to comment' message.
    2140  *     @type string $logged_in_as         HTML element for a 'logged in as <user>' message.
     2140 *     @type string $logged_in_as         HTML element for a 'logged in as [user]' message.
    21412141 *     @type string $comment_notes_before HTML element for a message displayed before the comment form.
    21422142 *                                        Default 'Your email address will not be published.'.
    21432143 *     @type string $comment_notes_after  HTML element for a message displayed after the comment form.
    … …  
    22462246                                        <form action="<?php echo site_url( '/wp-comments-post.php' ); ?>" method="post" id="<?php echo esc_attr( $args['id_form'] ); ?>" class="comment-form"<?php echo $html5 ? ' novalidate' : ''; ?>>
    22472247                                                <?php
    22482248                                                /**
    2249                                                  * Fires at the top of the comment form, inside the <form> tag.
     2249                                                 * Fires at the top of the comment form, inside the form tag.
    22502250                                                 *
    22512251                                                 * @since 3.0.0
    22522252                                                 */

  • src/wp-includes/cron.php

     
    349349 * 60*60*24*7 or 604800. The value of 'interval' would then be 604800.
    350350 *
    351351 * The 'display' is the description. For the 'weekly' key, the 'display' would
    352  * be <code>__('Once Weekly')</code>.
     352 * be `__('Once Weekly')`.
    353353 *
    354354 * For your plugin, you will be passed an array. you can easily add your
    355355 * schedule by doing the following.
    356  * <code>
    357  * // filter parameter variable name is 'array'
    358  *      $array['weekly'] = array(
    359  *              'interval' => 604800,
    360  *              'display' => __('Once Weekly')
    361  *      );
    362  * </code>
    363356 *
     357 *     // filter parameter variable name is 'array'
     358 *     $array['weekly'] = array(
     359 *      'interval' => 604800,
     360 *      'display' => __('Once Weekly')
     361 *     );
     362 *
     363 *
    364364 * @since 2.1.0
    365365 *
    366366 * @return array

  • src/wp-includes/deprecated.php

     
    451451/**
    452452 * Gets an array of link objects associated with category $cat_name.
    453453 *
    454  * <code>
    455  *      $links = get_linkobjectsbyname('fred');
    456  *      foreach ($links as $link) {
    457  *              echo '<li>'.$link->link_name.'</li>';
    458  *      }
    459  * </code>
     454 *     $links = get_linkobjectsbyname('fred');
     455 *     foreach ($links as $link) {
     456 *              echo '<li>'.$link->link_name.'</li>';
     457 *     }
    460458 *
    461459 * @since 1.0.1
    462460 * @deprecated 2.1.0
    … …  
    485483 * Gets an array of link objects associated with category n.
    486484 *
    487485 * Usage:
    488  * <code>
    489  *      $links = get_linkobjects(1);
    490  *      if ($links) {
    491  *              foreach ($links as $link) {
    492  *                      echo '<li>'.$link->link_name.'<br />'.$link->link_description.'</li>';
    493  *              }
    494  *      }
    495  * </code>
    496486 *
     487 *     $links = get_linkobjects(1);
     488 *     if ($links) {
     489 *      foreach ($links as $link) {
     490 *              echo '<li>'.$link->link_name.'<br />'.$link->link_description.'</li>';
     491 *      }
     492 *     }
     493 *
    497494 * Fields are:
    498  * <ol>
    499  *      <li>link_id</li>
    500  *      <li>link_url</li>
    501  *      <li>link_name</li>
    502  *      <li>link_image</li>
    503  *      <li>link_target</li>
    504  *      <li>link_category</li>
    505  *      <li>link_description</li>
    506  *      <li>link_visible</li>
    507  *      <li>link_owner</li>
    508  *      <li>link_rating</li>
    509  *      <li>link_updated</li>
    510  *      <li>link_rel</li>
    511  *      <li>link_notes</li>
    512  * </ol>
    513495 *
     496 * - link_id
     497 * - link_url
     498 * - link_name
     499 * - link_image
     500 * - link_target
     501 * - link_category
     502 * - link_description
     503 * - link_visible
     504 * - link_owner
     505 * - link_rating
     506 * - link_updated
     507 * - link_rel
     508 * - link_notes
     509 *
     510 *
    514511 * @since 1.0.1
    515512 * @deprecated 2.1.0
    516513 * @deprecated Use get_bookmarks()
    … …  
    29892986/**
    29902987 * Accepts matches array from preg_replace_callback in wpautop() or a string.
    29912988 *
    2992  * Ensures that the contents of a <<pre>>...<</pre>> HTML block are not
     2989 * Ensures that the contents of a `<pre>...</pre>` HTML block are not
    29932990 * converted into paragraphs or line-breaks.
    29942991 *
    29952992 * @since 1.2.0

  • src/wp-includes/feed-rss2.php

     
    1111echo '<?xml version="1.0" encoding="'.get_option('blog_charset').'"?'.'>';
    1212
    1313/**
    14  * Fires between the <xml> and <rss> tags in a feed.
     14 * Fires between the xml and rss tags in a feed.
    1515 *
    1616 * @since 4.0.0
    1717 *

  • src/wp-includes/formatting.php

     
    1111 * Replaces common plain text characters into formatted entities
    1212 *
    1313 * As an example,
    14  * <code>
    15  * 'cause today's effort makes it worth tomorrow's "holiday"...
    16  * </code>
     14 *
     15 *     'cause today's effort makes it worth tomorrow's "holiday"...
     16 *
    1717 * Becomes:
    18  * <code>
    19  * &#8217;cause today&#8217;s effort makes it worth tomorrow&#8217;s &#8220;holiday&#8221;&#8230;
    20  * </code>
     18 *
     19 *     &#8217;cause today&#8217;s effort makes it worth tomorrow&#8217;s &#8220;holiday&#8221;&#8230;
     20 *
    2121 * Code within certain html blocks are skipped.
    2222 *
    2323 * @since 0.71
    … …  
    312312 * @since 2.9.0
    313313 * @access private
    314314 *
    315  * @param string $text Text to check. Must be a tag like <html> or [shortcode].
     315 * @param string $text Text to check. Must be a tag like html or [shortcode].
    316316 * @param array $stack List of open tag elements.
    317317 * @param array $disabled_elements The tag names to match against. Spaces are not allowed in tag names.
    318318 */
    … …  
    480480/**
    481481 * Don't auto-p wrap shortcodes that stand alone
    482482 *
    483  * Ensures that shortcodes are not wrapped in <<p>>...<</p>>.
     483 * Ensures that shortcodes are not wrapped in `<p>...</p>`.
    484484 *
    485485 * @since 2.9.0
    486486 *
    … …  
    13661366/**
    13671367 * Converts a number of characters from a string.
    13681368 *
    1369  * Metadata tags <<title>> and <<category>> are removed, <<br>> and <<hr>> are
     1369 * Metadata tags `<title>` and `<category>` are removed, `<br>` and `<hr>` are
    13701370 * converted into correct XHTML and Unicode characters are converted to the
    13711371 * valid range.
    13721372 *
    … …  
    19351935 *
    19361936 * Input string must have no null characters (or eventual transformations on output chunks must not care about null characters)
    19371937 *
    1938  * <code>
    1939  * _split_str_by_whitespace( "1234 67890 1234 67890a cd 1234   890 123456789 1234567890a    45678   1 3 5 7 90 ", 10 ) ==
    1940  * array (
    1941  *   0 => '1234 67890 ',  // 11 characters: Perfect split
    1942  *   1 => '1234 ',        //  5 characters: '1234 67890a' was too long
    1943  *   2 => '67890a cd ',   // 10 characters: '67890a cd 1234' was too long
    1944  *   3 => '1234   890 ',  // 11 characters: Perfect split
    1945  *   4 => '123456789 ',   // 10 characters: '123456789 1234567890a' was too long
    1946  *   5 => '1234567890a ', // 12 characters: Too long, but no inner whitespace on which to split
    1947  *   6 => '   45678   ',  // 11 characters: Perfect split
    1948  *   7 => '1 3 5 7 9',    //  9 characters: End of $string
    1949  * );
    1950  * </code>
     1938 *     _split_str_by_whitespace( "1234 67890 1234 67890a cd 1234   890 123456789 1234567890a    45678   1 3 5 7 90 ", 10 ) ==
     1939 *     array (
     1940 *       0 => '1234 67890 ',  // 11 characters: Perfect split
     1941 *       1 => '1234 ',        //  5 characters: '1234 67890a' was too long
     1942 *       2 => '67890a cd ',   // 10 characters: '67890a cd 1234' was too long
     1943 *       3 => '1234   890 ',  // 11 characters: Perfect split
     1944 *       4 => '123456789 ',   // 10 characters: '123456789 1234567890a' was too long
     1945 *       5 => '1234567890a ', // 12 characters: Too long, but no inner whitespace on which to split
     1946 *       6 => '   45678   ',  // 11 characters: Perfect split
     1947 *       7 => '1 3 5 7 9',    //  9 characters: End of $string
     1948 *     );
    19511949 *
    19521950 * @since 3.4.0
    19531951 * @access private
    … …  
    20212019 *
    20222020 * Callback handler for {@link convert_smilies()}.
    20232021 * Looks up one smiley code in the $wpsmiliestrans global array and returns an
    2024  * <img> string for that smiley.
     2022 * `<img>` string for that smiley.
    20252023 *
    20262024 * @global array $wpsmiliestrans
    20272025 * @since 2.8.0
    … …  
    37033701/**
    37043702 * Adds a Target attribute to all links in passed content.
    37053703 *
    3706  * This function by default only applies to <a> tags, however this can be
     3704 * This function by default only applies to `<a>` tags, however this can be
    37073705 * modified by the 3rd param.
    37083706 *
    3709  * <b>NOTE:</b> Any current target attributed will be stripped and replaced.
     3707 * NOTE: Any current target attributed will be stripped and replaced.
    37103708 *
    37113709 * @since 2.7.0
    37123710 *
    … …  
    37573755 * Properly strip all HTML tags including script and style
    37583756 *
    37593757 * This differs from strip_tags() because it removes the contents of
    3760  * the <script> and <style> tags. E.g. strip_tags( '<script>something</script>' )
     3758 * the `<script>` and `<style>` tags. E.g. `strip_tags( '<script>something</script>' )`
    37613759 * will return 'something'. wp_strip_all_tags will return ''
    37623760 *
    37633761 * @since 2.9.0

  • src/wp-includes/functions.php

     
    34453445 * Before this function is called, the argument must be checked for whether it was
    34463446 * used by comparing it to its default value or evaluating whether it is empty.
    34473447 * For example:
    3448  * <code>
    3449  * if ( ! empty( $deprecated ) ) {
    3450  *      _deprecated_argument( __FUNCTION__, '3.0' );
    3451  * }
    3452  * </code>
    34533448 *
     3449 *     if ( ! empty( $deprecated ) ) {
     3450 *      _deprecated_argument( __FUNCTION__, '3.0' );
     3451 *     }
     3452 *
     3453 *
    34543454 * There is a hook deprecated_argument_run that will be called that can be used
    34553455 * to get the backtrace up to what file and function used the deprecated
    34563456 * argument.

  • src/wp-includes/functions.wp-scripts.php

     
    9090 * Works only if the script has already been added.
    9191 *
    9292 * Accepts an associative array $l10n and creates a JavaScript object:
    93  * <code>
    94  * "$object_name" = {
    95  *       key: value,
    96  *       key: value,
    97  *       ...
    98  * }
    99  * </code>
    10093 *
     94 *     "$object_name" = {
     95 *           key: value,
     96 *           key: value,
     97 *           ...
     98 *     }
     99 *
     100 *
    101101 * @see WP_Dependencies::localize()
    102102 * @link https://core.trac.wordpress.org/ticket/11520
    103103 * @global WP_Scripts $wp_scripts The WP_Scripts object for printing scripts.

  • src/wp-includes/general-template.php

     
    511511 *
    512512 * @since 1.5.0
    513513 *
    514  * @param string $before Text to output before the link (defaults to <li>).
    515  * @param string $after Text to output after the link (defaults to </li>).
     514 * @param string $before Text to output before the link (defaults to opening li tag).
     515 * @param string $after Text to output after the link (defaults to closing li tag).
    516516 * @param boolean $echo Default to echo and not return the link.
    517517 * @return string|null String when retrieving, null when displaying.
    518518 */
    … …  
    585585 * The deprecated blog info options are listed in the function contents.
    586586 *
    587587 * The possible values for the 'show' parameter are listed below.
    588  * <ol>
    589  * <li><strong>url</strong> - Blog URI to homepage.</li>
    590  * <li><strong>wpurl</strong> - Blog URI path to WordPress.</li>
    591  * <li><strong>description</strong> - Secondary title</li>
    592  * </ol>
    593588 *
     589 * 1. url - Blog URI to homepage.
     590 * 2. wpurl - Blog URI path to WordPress.
     591 * 3. description - Secondary title
     592 *
    594593 * The feed URL options can be retrieved from 'rdf_url' (RSS 0.91),
    595594 * 'rss_url' (RSS 1.0), 'rss2_url' (RSS 2.0), or 'atom_url' (Atom feed). The
    596595 * comment feeds can be retrieved from the 'comments_atom_url' (Atom comment
    … …  
    714713}
    715714
    716715/**
    717  * Display <title> tag with contents.
     716 * Display title tag with contents.
    718717 *
    719718 * @since 4.1.0
    720719 * @access private
    … …  
    12331232 * elements). Custom content is also supported using the before and after
    12341233 * parameters.
    12351234 *
    1236  * The 'link' format uses the link HTML element with the <em>archives</em>
     1235 * The 'link' format uses the link HTML element with the archives
    12371236 * relationship. The before and after parameters are not used. The text
    12381237 * parameter is used to describe the link.
    12391238 *
    … …  
    27062705 * Registers an admin colour scheme css file.
    27072706 *
    27082707 * Allows a plugin to register a new admin colour scheme. For example:
    2709  * <code>
    2710  * wp_admin_css_color('classic', __('Classic'), admin_url("css/colors-classic.css"),
    2711  * array('#07273E', '#14568A', '#D54E21', '#2683AE'));
    2712  * </code>
    27132708 *
     2709 *     wp_admin_css_color('classic', __('Classic'), admin_url("css/colors-classic.css"),
     2710 *     array('#07273E', '#14568A', '#D54E21', '#2683AE'));
     2711 *
    27142712 * @since 2.5.0
    27152713 *
    27162714 * @param string $key The unique key for this theme.

  • src/wp-includes/l10n.php

     
    7676 *
    7777 * If there is no translation, or the text domain isn't loaded, the original text is returned.
    7878 *
    79  * <strong>Note:</strong> Don't use translate() directly, use __() or related functions.
     79 * Note: Don't use translate() directly, use __() or related functions.
    8080 *
    8181 * @since 2.2.0
    8282 *
    … …  
    364364 * strings and use them later.
    365365 *
    366366 * Example:
    367  * <code>
    368  * $messages = array(
    369  *      'post' => _n_noop('%s post', '%s posts'),
    370  *      'page' => _n_noop('%s pages', '%s pages')
    371  * );
    372  * ...
    373  * $message = $messages[$type];
    374  * $usable_text = sprintf( translate_nooped_plural( $message, $count ), $count );
    375  * </code>
    376367 *
     368 *     $messages = array(
     369 *              'post' => _n_noop('%s post', '%s posts'),
     370 *              'page' => _n_noop('%s pages', '%s pages')
     371 *     );
     372 *     ...
     373 *     $message = $messages[$type];
     374 *     $usable_text = sprintf( translate_nooped_plural( $message, $count ), $count );
     375 *
    377376 * @since 2.5.0
    378377 *
    379378 * @param string $singular Single form to be i18ned.

  • src/wp-includes/media.php

     
    31003100}
    31013101
    31023102/**
    3103  * Check the content blob for an <audio>, <video> <object>, <embed>, or <iframe>
     3103 * Check the content blob for an audio, video, object, embed, or iframe tags.
    31043104 *
    31053105 * @since 3.6.0
    31063106 *
    … …  
    32863286}
    32873287
    32883288/**
    3289  * Return the URls for CSS files used in an <iframe>-sandbox'd TinyMCE media view
     3289 * Return the URls for CSS files used in an iframe-sandbox'd TinyMCE media view
    32903290 *
    32913291 * @since 4.0.0
    32923292 *

  • src/wp-includes/ms-load.php

     
    2929 * Returns array of network plugin files to be included in global scope.
    3030 *
    3131 * The default directory is wp-content/plugins. To change the default directory
    32  * manually, define <code>WP_PLUGIN_DIR</code> and <code>WP_PLUGIN_URL</code>
     32 * manually, define `WP_PLUGIN_DIR` and `WP_PLUGIN_URL`
    3333 * in wp-config.php.
    3434 *
    3535 * @access private

  • src/wp-includes/nav-menu-template.php

     
    8585                $classes[] = 'menu-item-' . $item->ID;
    8686
    8787                /**
    88                  * Filter the CSS class(es) applied to a menu item's <li>.
     88                 * Filter the CSS class(es) applied to a menu item's li element.
    8989                 *
    9090                 * @since 3.0.0
    9191                 * @since 4.1.0 The `$depth` parameter was added.
    9292                 *
    9393                 * @see wp_nav_menu()
    9494                 *
    95                  * @param array  $classes The CSS classes that are applied to the menu item's <li>.
     95                 * @param array  $classes The CSS classes that are applied to the menu item's li element.
    9696                 * @param object $item    The current menu item.
    9797                 * @param array  $args    An array of wp_nav_menu() arguments.
    9898                 * @param int    $depth   Depth of menu item. Used for padding.
    … …  
    101101                $class_names = $class_names ? ' class="' . esc_attr( $class_names ) . '"' : '';
    102102
    103103                /**
    104                  * Filter the ID applied to a menu item's <li>.
     104                 * Filter the ID applied to a menu item's li element.
    105105                 *
    106106                 * @since 3.0.1
    107107                 * @since 4.1.0 The `$depth` parameter was added.
    108108                 *
    109109                 * @see wp_nav_menu()
    110110                 *
    111                  * @param string $menu_id The ID that is applied to the menu item's <li>.
     111                 * @param string $menu_id The ID that is applied to the menu item's li element.
    112112                 * @param object $item    The current menu item.
    113113                 * @param array  $args    An array of wp_nav_menu() arguments.
    114114                 * @param int    $depth   Depth of menu item. Used for padding.
    … …  
    125125                $atts['href']   = ! empty( $item->url )        ? $item->url        : '';
    126126
    127127                /**
    128                  * Filter the HTML attributes applied to a menu item's <a>.
     128                 * Filter the HTML attributes applied to a menu item's 'a' element.
    129129                 *
    130130                 * @since 3.6.0
    131131                 * @since 4.1.0 The `$depth` parameter was added.
    … …  
    133133                 * @see wp_nav_menu()
    134134                 *
    135135                 * @param array $atts {
    136                  *     The HTML attributes applied to the menu item's <a>, empty strings are ignored.
     136                 *     The HTML attributes applied to the menu item's 'a' element, empty strings are ignored.
    137137                 *
    138138                 *     @type string $title  Title attribute.
    139139                 *     @type string $target Target attribute.
    … …  
    164164                /**
    165165                 * Filter a menu item's starting output.
    166166                 *
    167                  * The menu item's starting output only includes $args->before, the opening <a>,
    168                  * the menu item's title, the closing </a>, and $args->after. Currently, there is
    169                  * no filter for modifying the opening and closing <li> for a menu item.
     167                 * The menu item's starting output only includes $args->before, the opening `<a>`,
     168                 * the menu item's title, the closing `</a>`, and $args->after. Currently, there is
     169                 * no filter for modifying the opening and closing `<li>` for a menu item.
    170170                 *
    171171                 * @since 3.0.0
    172172                 *

  • src/wp-includes/pluggable.php

     
    17721772 * {@link https://api.wordpress.org/secret-key/1.1/salt/ secret key created} just
    17731773 * for you.
    17741774 *
    1775  * <code>
    1776  * define('AUTH_KEY',         ' Xakm<o xQy rw4EMsLKM-?!T+,PFF})H4lzcW57AF0U@N@< >M%G4Yt>f`z]MON');
    1777  * define('SECURE_AUTH_KEY',  'LzJ}op]mr|6+![P}Ak:uNdJCJZd>(Hx.-Mh#Tz)pCIU#uGEnfFz|f ;;eU%/U^O~');
    1778  * define('LOGGED_IN_KEY',    '|i|Ux`9<p-h$aFf(qnT:sDO:D1P^wZ$$/Ra@miTJi9G;ddp_<q}6H1)o|a +&JCM');
    1779  * define('NONCE_KEY',        '%:R{[P|,s.KuMltH5}cI;/k<Gx~j!f0I)m_sIyu+&NJZ)-iO>z7X>QYR0Z_XnZ@|');
    1780  * define('AUTH_SALT',        'eZyT)-Naw]F8CwA*VaW#q*|.)g@o}||wf~@C-YSt}(dh_r6EbI#A,y|nU2{B#JBW');
    1781  * define('SECURE_AUTH_SALT', '!=oLUTXh,QW=H `}`L|9/^4-3 STz},T(w}W<I`.JjPi)<Bmf1v,HpGe}T1:Xt7n');
    1782  * define('LOGGED_IN_SALT',   '+XSqHc;@Q*K_b|Z?NC[3H!!EONbh.n<+=uKR:>*c(u`g~EJBf#8u#R{mUEZrozmm');
    1783  * define('NONCE_SALT',       'h`GXHhD>SLWVfg1(1(N{;.V!MoE(SfbA_ksP@&`+AycHcAV$+?@3q+rxV{%^VyKT');
    1784  * </code>
     1775 *     define('AUTH_KEY',         ' Xakm<o xQy rw4EMsLKM-?!T+,PFF})H4lzcW57AF0U@N@< >M%G4Yt>f`z]MON');
     1776 *     define('SECURE_AUTH_KEY',  'LzJ}op]mr|6+![P}Ak:uNdJCJZd>(Hx.-Mh#Tz)pCIU#uGEnfFz|f ;;eU%/U^O~');
     1777 *     define('LOGGED_IN_KEY',    '|i|Ux`9<p-h$aFf(qnT:sDO:D1P^wZ$$/Ra@miTJi9G;ddp_<q}6H1)o|a +&JCM');
     1778 *     define('NONCE_KEY',        '%:R{[P|,s.KuMltH5}cI;/k<Gx~j!f0I)m_sIyu+&NJZ)-iO>z7X>QYR0Z_XnZ@|');
     1779 *     define('AUTH_SALT',        'eZyT)-Naw]F8CwA*VaW#q*|.)g@o}||wf~@C-YSt}(dh_r6EbI#A,y|nU2{B#JBW');
     1780 *     define('SECURE_AUTH_SALT', '!=oLUTXh,QW=H `}`L|9/^4-3 STz},T(w}W<I`.JjPi)<Bmf1v,HpGe}T1:Xt7n');
     1781 *     define('LOGGED_IN_SALT',   '+XSqHc;@Q*K_b|Z?NC[3H!!EONbh.n<+=uKR:>*c(u`g~EJBf#8u#R{mUEZrozmm');
     1782 *     define('NONCE_SALT',       'h`GXHhD>SLWVfg1(1(N{;.V!MoE(SfbA_ksP@&`+AycHcAV$+?@3q+rxV{%^VyKT');
    17851783 *
    17861784 * Salting passwords helps against tools which has stored hashed values of
    17871785 * common dictionary strings. The added values makes it harder to crack.
    … …  
    20902088 * @param int $size Size of the avatar image
    20912089 * @param string $default URL to a default image to use if no avatar is available
    20922090 * @param string $alt Alternative text to use in image tag. Defaults to blank
    2093  * @return string <img> tag for the user's avatar
     2091 * @return string img tag for the user's avatar
    20942092*/
    20952093function get_avatar( $id_or_email, $size = '96', $default = '', $alt = false ) {
    20962094        if ( ! get_option('show_avatars') )

  • src/wp-includes/plugin.php

     
    4747 * The following example shows how a callback function is bound to a filter hook.
    4848 * Note that $example is passed to the callback, (maybe) modified, then returned:
    4949 *
    50  * <code>
    51  * function example_callback( $example ) {
    52  *      // Maybe modify $example in some way
    53  *      return $example;
    54  * }
    55  * add_filter( 'example_filter', 'example_callback' );
    56  * </code>
     50 *     function example_callback( $example ) {
     51 *      // Maybe modify $example in some way
     52 *      return $example;
     53 *     }
     54 *     add_filter( 'example_filter', 'example_callback' );
    5755 *
    5856 * Since WordPress 1.5.1, bound callbacks can take as many arguments as are
    5957 * passed as parameters in the corresponding apply_filters() call. The $accepted_args
    6058 * parameter allows for calling functions only when the number of args match.
    6159 *
    62  * <strong>Note:</strong> the function will return true whether or not the callback
     60 * Note: the function will return true whether or not the callback
    6361 * is valid. It is up to you to take care. This is done for optimization purposes,
    6462 * so everything is as quick as possible.
    6563 *
    … …  
    148146 * the $tag parameter.
    149147 *
    150148 * The function allows for additional arguments to be added and passed to hooks.
    151  * <code>
    152  * // Our filter callback function
    153  * function example_callback( $string, $arg1, $arg2 ) {
    154  *      // (maybe) modify $string
    155  *      return $string;
    156  * }
    157  * add_filter( 'example_filter', 'example_callback', 10, 3 );
    158149 *
    159  * // Apply the filters by calling the 'example_callback' function we
    160  * // "hooked" to 'example_filter' using the add_filter() function above.
    161  * // - 'example_filter' is the filter hook $tag
    162  * // - 'filter me' is the value being filtered
    163  * // - $arg1 and $arg2 are the additional arguments passed to the callback.
    164  * $value = apply_filters( 'example_filter', 'filter me', $arg1, $arg2 );
    165  * </code>
     150 *     // Our filter callback function
     151 *     function example_callback( $string, $arg1, $arg2 ) {
     152 *      // (maybe) modify $string
     153 *      return $string;
     154 *     }
     155 *     add_filter( 'example_filter', 'example_callback', 10, 3 );
    166156 *
     157 *     // Apply the filters by calling the 'example_callback' function we
     158 *     // "hooked" to 'example_filter' using the add_filter() function above.
     159 *     // - 'example_filter' is the filter hook $tag
     160 *     // - 'filter me' is the value being filtered
     161 *     // - $arg1 and $arg2 are the additional arguments passed to the callback.
     162 *     $value = apply_filters( 'example_filter', 'filter me', $arg1, $arg2 );
     163 *
    167164 * @since 0.71
    168165 *
    169166 * @global array $wp_filter         Stores all of the filters.
    … …  
    171168 * @global array $wp_current_filter Stores the list of current filters with the current one last.
    172169 *
    173170 * @param string $tag   The name of the filter hook.
    174  * @param mixed  $value The value on which the filters hooked to <tt>$tag</tt> are applied on.
    175  * @param mixed  $var   Additional variables passed to the functions hooked to <tt>$tag</tt>.
     171 * @param mixed  $value The value on which the filters hooked to '$tag' are applied on.
     172 * @param mixed  $var   Additional variables passed to the functions hooked to '$tag'.
    176173 * @return mixed The filtered value after all hooked functions are applied to it.
    177174 */
    178175function apply_filters( $tag, $value ) {
    … …  
    225222 * Execute functions hooked on a specific filter hook, specifying arguments in an array.
    226223 *
    227224 * @see apply_filters() This function is identical, but the arguments passed to the
    228  * functions hooked to <tt>$tag</tt> are supplied using an array.
     225 * functions hooked to '$tag' are supplied using an array.
    229226 *
    230227 * @since 3.0.0
    231228 *
    … …  
    434431/**
    435432 * Execute functions hooked on a specific action hook.
    436433 *
    437  * This function invokes all functions attached to action hook $tag. It is
     434 * This function invokes all functions attached to action hook `$tag`. It is
    438435 * possible to create new action hooks by simply calling this function,
    439  * specifying the name of the new hook using the <tt>$tag</tt> parameter.
     436 * specifying the name of the new hook using the `$tag` parameter.
    440437 *
    441438 * You can pass extra arguments to the hooks, much like you can with
    442439 * apply_filters().
    … …  
    533530 * @global array $wp_actions Increments the amount of times action was triggered.
    534531 *
    535532 * @param string $tag  The name of the action to be executed.
    536  * @param array  $args The arguments supplied to the functions hooked to <tt>$tag</tt>
     533 * @param array  $args The arguments supplied to the functions hooked to '$tag'
    537534 * @return null Will return null if $tag does not exist in $wp_filter array
    538535 */
    539536function do_action_ref_array($tag, $args) {

  • src/wp-includes/post-template.php

     
    730730 * @param string|array $args {
    731731 *     Optional. Array or string of default arguments.
    732732 *
    733  *     @type string       $before           HTML or text to prepend to each link. Default is '<p> Pages:'.
    734  *     @type string       $after            HTML or text to append to each link. Default is '</p>'.
    735  *     @type string       $link_before      HTML or text to prepend to each link, inside the <a> tag.
     733 *     @type string       $before           HTML or text to prepend to each link.
     734 *     @type string       $after            HTML or text to append to each link.
     735 *     @type string       $link_before      HTML or text to prepend to each link, inside the 'a' tag.
    736736 *                                          Also prepended to the current item, which is not linked. Default empty.
    737  *     @type string       $link_after       HTML or text to append to each Pages link inside the <a> tag.
     737 *     @type string       $link_after       HTML or text to append to each Pages link inside the 'a' tag.
    738738 *                                          Also appended to the current item, which is not linked. Default empty.
    739739 *     @type string       $next_or_number   Indicates whether page numbers should be used. Valid values are number
    740740 *                                          and next. Default is 'number'.
    … …  
    15101510}
    15111511
    15121512/**
    1513  * Wrap attachment in <<p>> element before content.
     1513 * Wrap attachment in p tag before content.
    15141514 *
    15151515 * @since 2.0.0
    15161516 *

  • src/wp-includes/post.php

     
    372372 * referenced.
    373373 *
    374374 * The returned array has 'main', 'extended', and 'more_text' keys. Main has the text before
    375  * the <code><!--more--></code>. The 'extended' key has the content after the
    376  * <code><!--more--></code> comment. The 'more_text' key has the custom "Read More" text.
     375 * the `<!--more-->`. The 'extended' key has the content after the
     376 * `<!--more-->` comment. The 'more_text' key has the custom "Read More" text.
    377377 *
    378378 * @since 1.0.0
    379379 *
    … …  
    15951595 * - add_new - Default is Add New for both hierarchical and non-hierarchical types.
    15961596 *             When internationalizing this string, please use a gettext context
    15971597 *             {@see http://codex.wordpress.org/I18n_for_WordPress_Developers#Disambiguation_by_context}
    1598  *             matching your post type. Example: <code>_x('Add New', 'product');</code>.
     1598 *             matching your post type. Example: `_x('Add New', 'product');`.
    15991599 * - add_new_item - Default is Add New Post/Add New Page.
    16001600 * - edit_item - Default is Edit Post/Edit Page.
    16011601 * - new_item - Default is New Post/New Page.
    … …  
    16061606 * - parent_item_colon - This string isn't used on non-hierarchical types. In hierarchical
    16071607 *                       ones the default is 'Parent Page:'.
    16081608 * - all_items - String for the submenu. Default is All Posts/All Pages.
    1609  * - menu_name - Default is the same as <code>name</code>.
     1609 * - menu_name - Default is the same as `name`.
    16101610 *
    16111611 * Above, the first default value is for non-hierarchical post types (like posts)
    16121612 * and the second one is for hierarchical post types (like pages).

  • src/wp-includes/rewrite.php

     
    226226 * Adding an endpoint creates extra rewrite rules for each of the matching
    227227 * places specified by the provided bitmask. For example:
    228228 *
    229  * <code>
    230  * add_rewrite_endpoint( 'json', EP_PERMALINK | EP_PAGES );
    231  * </code>
     229 *     add_rewrite_endpoint( 'json', EP_PERMALINK | EP_PAGES );
    232230 *
    233231 * will add a new rewrite rule ending with "json(/(.*))?/?$" for every permastruct
    234232 * that describes a permalink (post) or page. This is rewritten to "json=$match"
    235233 * where $match is the part of the URL matched by the endpoint regex (e.g. "foo" in
    236  * "<permalink>/json/foo/").
     234 * "[permalink]/json/foo/").
    237235 *
    238236 * A new query var with the same name as the endpoint will also be created.
    239237 *

  • src/wp-includes/shortcodes.php

     
    2121 *
    2222 * To apply shortcode tags to content:
    2323 *
    24  * <code>
    25  * $out = do_shortcode($content);
    26  * </code>
     24 *     $out = do_shortcode($content);
    2725 *
    2826 * @link http://codex.wordpress.org/Shortcode_API
    2927 *
    … …  
    5250 *
    5351 * Simplest example of a shortcode tag using the API:
    5452 *
    55  * <code>
    56  * // [footag foo="bar"]
    57  * function footag_func($atts) {
    58  *      return "foo = {$atts[foo]}";
    59  * }
    60  * add_shortcode('footag', 'footag_func');
    61  * </code>
     53 *     // [footag foo="bar"]
     54 *     function footag_func($atts) {
     55 *      return "foo = {$atts[foo]}";
     56 *     }
     57 *     add_shortcode('footag', 'footag_func');
    6258 *
    6359 * Example with nice attribute defaults:
    6460 *
    65  * <code>
    66  * // [bartag foo="bar"]
    67  * function bartag_func($atts) {
    68  *      $args = shortcode_atts(array(
    69  *              'foo' => 'no foo',
    70  *              'baz' => 'default baz',
    71  *      ), $atts);
     61 *     // [bartag foo="bar"]
     62 *     function bartag_func($atts) {
     63 *      $args = shortcode_atts(array(
     64 *              'foo' => 'no foo',
     65 *              'baz' => 'default baz',
     66 *      ), $atts);
    7267 *
    73  *      return "foo = {$args['foo']}";
    74  * }
    75  * add_shortcode('bartag', 'bartag_func');
    76  * </code>
     68 *      return "foo = {$args['foo']}";
     69 *     }
     70 *     add_shortcode('bartag', 'bartag_func');
    7771 *
    7872 * Example with enclosed content:
    7973 *
    80  * <code>
    81  * // [baztag]content[/baztag]
    82  * function baztag_func($atts, $content='') {
    83  *      return "content = $content";
    84  * }
    85  * add_shortcode('baztag', 'baztag_func');
    86  * </code>
     74 *     // [baztag]content[/baztag]
     75 *     function baztag_func($atts, $content='') {
     76 *      return "content = $content";
     77 *     }
     78 *     add_shortcode('baztag', 'baztag_func');
    8779 *
    8880 * @since 2.5.0
    8981 *

  • src/wp-includes/taxonomy.php

     
    155155 * It appears that this function can be used to find all of the names inside of
    156156 * $wp_taxonomies global variable.
    157157 *
    158  * <code><?php $taxonomies = get_object_taxonomies('post'); ?></code> Should
    159  * result in <code>Array('category', 'post_tag')</code>
     158 * `<?php $taxonomies = get_object_taxonomies('post'); ?>` Should
     159 * result in `Array('category', 'post_tag')`
    160160 *
    161161 * @since 2.3.0
    162162 *
    … …  
    440440 * - popular_items - This string isn't used on hierarchical taxonomies. Default is Popular Tags
    441441 * - all_items - Default is All Tags/All Categories
    442442 * - parent_item - This string isn't used on non-hierarchical taxonomies. In hierarchical ones the default is Parent Category
    443  * - parent_item_colon - The same as <code>parent_item</code>, but with colon <code>:</code> in the end
     443 * - parent_item_colon - The same as `parent_item`, but with colon `:ё in the end
    444444 * - edit_item - Default is Edit Tag/Edit Category
    445445 * - view_item - Default is View Tag/View Category
    446446 * - update_item - Default is Update Tag/Update Category

  • src/wp-includes/wp-db.php

     
    11721172         *
    11731173         * Both %d and %s should be left unquoted in the query string.
    11741174         *
    1175          * <code>
    1176          * wpdb::prepare( "SELECT * FROM `table` WHERE `column` = %s AND `field` = %d", 'foo', 1337 )
    1177          * wpdb::prepare( "SELECT DATE_FORMAT(`field`, '%%c') FROM `table` WHERE `column` = %s", 'foo' );
    1178          * </code>
     1175         *     wpdb::prepare( "SELECT * FROM `table` WHERE `column` = %s AND `field` = %d", 'foo', 1337 )
     1176         *     wpdb::prepare( "SELECT DATE_FORMAT(`field`, '%%c') FROM `table` WHERE `column` = %s", 'foo' );
    11791177         *
    11801178         * @link http://php.net/sprintf Description of syntax.
    11811179         * @since 2.3.0
    … …  
    17241722        /**
    17251723         * Insert a row into a table.
    17261724         *
    1727          * <code>
    1728          * wpdb::insert( 'table', array( 'column' => 'foo', 'field' => 'bar' ) )
    1729          * wpdb::insert( 'table', array( 'column' => 'foo', 'field' => 1337 ), array( '%s', '%d' ) )
    1730          * </code>
     1725         *     wpdb::insert( 'table', array( 'column' => 'foo', 'field' => 'bar' ) )
     1726         *     wpdb::insert( 'table', array( 'column' => 'foo', 'field' => 1337 ), array( '%s', '%d' ) )
    17311727         *
    17321728         * @since 2.5.0
    17331729         * @see wpdb::prepare()
    … …  
    17471743        /**
    17481744         * Replace a row into a table.
    17491745         *
    1750          * <code>
    1751          * wpdb::replace( 'table', array( 'column' => 'foo', 'field' => 'bar' ) )
    1752          * wpdb::replace( 'table', array( 'column' => 'foo', 'field' => 1337 ), array( '%s', '%d' ) )
    1753          * </code>
     1746         *     wpdb::replace( 'table', array( 'column' => 'foo', 'field' => 'bar' ) )
     1747         *     wpdb::replace( 'table', array( 'column' => 'foo', 'field' => 1337 ), array( '%s', '%d' ) )
    17541748         *
    17551749         * @since 3.0.0
    17561750         * @see wpdb::prepare()
    … …  
    18141808        /**
    18151809         * Update a row in the table
    18161810         *
    1817          * <code>
    1818          * wpdb::update( 'table', array( 'column' => 'foo', 'field' => 'bar' ), array( 'ID' => 1 ) )
    1819          * wpdb::update( 'table', array( 'column' => 'foo', 'field' => 1337 ), array( 'ID' => 1 ), array( '%s', '%d' ), array( '%d' ) )
    1820          * </code>
     1811         *     wpdb::update( 'table', array( 'column' => 'foo', 'field' => 'bar' ), array( 'ID' => 1 ) )
     1812         *     wpdb::update( 'table', array( 'column' => 'foo', 'field' => 1337 ), array( 'ID' => 1 ), array( '%s', '%d' ), array( '%d' ) )
    18211813         *
    18221814         * @since 2.5.0
    18231815         * @see wpdb::prepare()
    … …  
    18681860        /**
    18691861         * Delete a row in the table
    18701862         *
    1871          * <code>
    1872          * wpdb::delete( 'table', array( 'ID' => 1 ) )
    1873          * wpdb::delete( 'table', array( 'ID' => 1 ), array( '%d' ) )
    1874          * </code>
     1863         *     wpdb::delete( 'table', array( 'ID' => 1 ) )
     1864         *     wpdb::delete( 'table', array( 'ID' => 1 ), array( '%d' ) )
    18751865         *
    18761866         * @since 3.4.0
    18771867         * @see wpdb::prepare()

  • src/wp-login.php

     
    2525/**
    2626 * Output the login page header.
    2727 *
    28  * @param string   $title    Optional. WordPress Log In Page title to display in <title> element. Default 'Log In'.
     28 * @param string   $title    Optional. WordPress login Page title to display in title element. Default 'Log In'.
    2929 * @param string   $message  Optional. Message to display in header. Default empty.
    3030 * @param WP_Error $wp_error Optional. The error to pass. Default empty.
    3131 */
    … …  
    537537        </p>
    538538        <?php
    539539        /**
    540          * Fires inside the lostpassword <form> tags, before the hidden fields.
     540         * Fires inside the lostpassword form tags, before the hidden fields.
    541541         *
    542542         * @since 2.1.0
    543543         */

  • src/wp-signup.php

     
    1919 */
    2020function do_signup_header() {
    2121        /**
    22          * Fires within the <head> section of the site sign-up screen.
     22         * Fires within the head section of the site sign-up screen.
    2323         *
    2424         * @since 3.0.0
    2525         */