WordPress.org

Make WordPress Core


Ignore:
Timestamp:
08/30/2019 04:56:39 PM (8 weeks ago)
Author:
SergeyBiryukov
Message:

Docs: Simplify get_plugin_data() and get_file_data() description.

See #47110.

File:
1 edited

Legend:

Unmodified
Added
Removed
  • trunk/src/wp-admin/includes/plugin.php

    r45916 r45917  
    1010 * Parses the plugin contents to retrieve plugin's metadata.
    1111 *
    12  * The metadata of the plugin's data searches for the following in the plugin's
    13  * header. All plugin data must be on its own line. For plugin description, it
    14  * must not have any newlines or only parts of the description will be displayed
    15  * and the same goes for the plugin data. The below is formatted for printing.
     12 * All plugin headers must be on their own line. Plugin description must not have
     13 * any newlines, otherwise only parts of the description will be displayed.
     14 * The below is formatted for printing.
    1615 *
    1716 *     /*
     
    3433 *     Requires at least: Optional. Specify the minimum required WordPress version.
    3534 *     Requires PHP: Optional. Specify the minimum required PHP version.
    36  *      * / # Remove the space to close comment
    37  *
    38  * Some users have issues with opening large files and manipulating the contents
    39  * for want is usually the first 1kiB or 2kiB. This function stops pulling in
    40  * the plugin contents when it has all of the required plugin data.
    41  *
    42  * The first 8kiB of the file will be pulled in and if the plugin data is not
    43  * within that first 8kiB, then the plugin author should correct their plugin
     35 *     * / # Remove the space to close comment.
     36 *
     37 * The first 8 KB of the file will be pulled in and if the plugin data is not
     38 * within that first 8 KB, then the plugin author should correct their plugin
    4439 * and move the plugin data headers to the top.
    4540 *
     
    4944 *
    5045 * @since 1.5.0
    51  * @since 5.3.0 Added support for `Requires at least` and `Requires PHP`.
     46 * @since 5.3.0 Added support for `Requires at least` and `Requires PHP` headers.
    5247 *
    5348 * @param string $plugin_file Absolute path to the main plugin file.
Note: See TracChangeset for help on using the changeset viewer.