WordPress.org
Get WordPress

Make WordPress Core

Changeset 60178


Ignore:
Timestamp:
04/21/2025 11:47:11 AM (8 months ago)
Author:
johnbillion
Message:

Docs: Improve and standardise the format of placeholder strings that get replaced within email messages.

This prevents the strings being treated as h3 headings by the documentation parser on developer.wordpress.org.

See #63166

Location:
trunk/src
Files:
6 edited

Legend:

Unmodified
Added
Removed

  • trunk/src/wp-admin/includes/misc.php

    r59896 r60178  
    14841484     *
    14851485     * The following strings have a special meaning and will get replaced dynamically:
    1486      *  - ###USERNAME###  The current user's username.
    1487      *  - ###ADMIN_URL### The link to click on to confirm the email change.
    1488      *  - ###EMAIL###     The proposed new site admin email address.
    1489      *  - ###SITENAME###  The name of the site.
    1490      *  - ###SITEURL###   The URL to the site.
     1486     *
     1487     *  - `###USERNAME###`  The current user's username.
     1488     *  - `###ADMIN_URL###` The link to click on to confirm the email change.
     1489     *  - `###EMAIL###`     The proposed new site admin email address.
     1490     *  - `###SITENAME###`  The name of the site.
     1491     *  - `###SITEURL###`   The URL to the site.
    14911492     *
    14921493     * @since MU (3.0.0)

  • trunk/src/wp-admin/includes/privacy-tools.php

    r55988 r60178  
    614614    /**
    615615     * Filters the recipient of the personal data export email notification.
    616      * Should be used with great caution to avoid sending the data export link to wrong emails.
     616     * Should be used with great caution to avoid sending the data export link to the wrong email.
    617617     *
    618618     * @since 5.3.0
    … …  
    679679     *
    680680     * The following strings have a special meaning and will get replaced dynamically:
    681      * ###EXPIRATION###         The date when the URL will be automatically deleted.
    682      * ###LINK###               URL of the personal data export file for the user.
    683      * ###SITENAME###           The name of the site.
    684      * ###SITEURL###            The URL to the site.
     681     *
     682     *  - `###EXPIRATION###` The date when the URL will be automatically deleted.
     683     *  - `###LINK###`       URL of the personal data export file for the user.
     684     *  - `###SITENAME###`   The name of the site.
     685     *  - `###SITEURL###`    The URL to the site.
    685686     *
    686687     * @since 4.9.6

  • trunk/src/wp-admin/ms-delete-site.php

    r58975 r60178  
    7676     * Filters the text for the email sent to the site admin when a request to delete a site in a Multisite network is submitted.
    7777     *
     78     * The following strings have a special meaning and will get replaced dynamically:
     79     *
     80     *  - `###USERNAME###`   The current user's username.
     81     *  - `###URL_DELETE###` The link to click on to confirm the site deletion.
     82     *  - `###SITENAME###`   The name of the site.
     83     *  - `###SITEURL###`    The URL to the site.
     84     *
    7885     * @since 3.0.0
    7986     *

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

    r60153 r60178  
    81818181     *     @type string $message The content of the email.
    81828182     *         The following strings have a special meaning and will get replaced dynamically:
    8183      *         - ###OLD_EMAIL### The old site admin email address.
    8184      *         - ###NEW_EMAIL### The new site admin email address.
    8185      *         - ###SITENAME###  The name of the site.
    8186      *         - ###SITEURL###   The URL to the site.
     8183     *          - `###OLD_EMAIL###` The old site admin email address.
     8184     *          - `###NEW_EMAIL###` The new site admin email address.
     8185     *          - `###SITENAME###`  The name of the site.
     8186     *          - `###SITEURL###`   The URL to the site.
    81878187     *     @type string $headers Headers.
    81888188     * }

  • trunk/src/wp-includes/ms-functions.php

    r60153 r60178  
    28172817     *
    28182818     * The following strings have a special meaning and will get replaced dynamically:
    2819      * ###USERNAME###  The current user's username.
    2820      * ###ADMIN_URL### The link to click on to confirm the email change.
    2821      * ###EMAIL###     The proposed new network admin email address.
    2822      * ###SITENAME###  The name of the network.
    2823      * ###SITEURL###   The URL to the network.
     2819     *
     2820     *  - `###USERNAME###`  The current user's username.
     2821     *  - `###ADMIN_URL###` The link to click on to confirm the email change.
     2822     *  - `###EMAIL###`     The proposed new network admin email address.
     2823     *  - `###SITENAME###`  The name of the network.
     2824     *  - `###SITEURL###`   The URL to the network.
    28242825     *
    28252826     * @since 4.9.0
    … …  
    29282929     *     @type string $message The content of the email.
    29292930     *         The following strings have a special meaning and will get replaced dynamically:
    2930      *         - ###OLD_EMAIL### The old network admin email address.
    2931      *         - ###NEW_EMAIL### The new network admin email address.
    2932      *         - ###SITENAME###  The name of the network.
    2933      *         - ###SITEURL###   The URL to the site.
     2931     *          - `###OLD_EMAIL###` The old network admin email address.
     2932     *          - `###NEW_EMAIL###` The new network admin email address.
     2933     *          - `###SITENAME###`  The name of the network.
     2934     *          - `###SITEURL###`   The URL to the site.
    29342935     *     @type string $headers Headers.
    29352936     * }

  • trunk/src/wp-includes/user.php

    r59927 r60178  
    27592759         *     @type string $message The content of the email.
    27602760         *         The following strings have a special meaning and will get replaced dynamically:
    2761          *         - ###USERNAME###    The current user's username.
    2762          *         - ###ADMIN_EMAIL### The admin email in case this was unexpected.
    2763          *         - ###EMAIL###       The user's email address.
    2764          *         - ###SITENAME###    The name of the site.
    2765          *         - ###SITEURL###     The URL to the site.
     2761         *          - `###USERNAME###`    The current user's username.
     2762         *          - `###ADMIN_EMAIL###` The admin email in case this was unexpected.
     2763         *          - `###EMAIL###`       The user's email address.
     2764         *          - `###SITENAME###`    The name of the site.
     2765         *          - `###SITEURL###`     The URL to the site.
    27662766         *     @type string $headers Headers. Add headers in a newline (\r\n) separated string.
    27672767         * }
    … …  
    28172817         *     @type string $message The content of the email.
    28182818         *         The following strings have a special meaning and will get replaced dynamically:
    2819          *         - ###USERNAME###    The current user's username.
    2820          *         - ###ADMIN_EMAIL### The admin email in case this was unexpected.
    2821          *         - ###NEW_EMAIL###   The new email address.
    2822          *         - ###EMAIL###       The old email address.
    2823          *         - ###SITENAME###    The name of the site.
    2824          *         - ###SITEURL###     The URL to the site.
     2819         *          - `###USERNAME###`    The current user's username.
     2820         *          - `###ADMIN_EMAIL###` The admin email in case this was unexpected.
     2821         *          - `###NEW_EMAIL###`   The new email address.
     2822         *          - `###EMAIL###`       The old email address.
     2823         *          - `###SITENAME###`    The name of the site.
     2824         *          - `###SITEURL###`     The URL to the site.
    28252825         *     @type string $headers Headers.
    28262826         * }
    … …  
    38403840         *
    38413841         * The following strings have a special meaning and will get replaced dynamically:
    3842          * - ###USERNAME###  The current user's username.
    3843          * - ###ADMIN_URL### The link to click on to confirm the email change.
    3844          * - ###EMAIL###     The new email.
    3845          * - ###SITENAME###  The name of the site.
    3846          * - ###SITEURL###   The URL to the site.
     3842         *
     3843         *  - `###USERNAME###`  The current user's username.
     3844         *  - `###ADMIN_URL###` The link to click on to confirm the email change.
     3845         *  - `###EMAIL###`     The new email.
     3846         *  - `###SITENAME###`  The name of the site.
     3847         *  - `###SITEURL###`   The URL to the site.
    38473848         *
    38483849         * @since MU (3.0.0)
    … …  
    42694270     * The following strings have a special meaning and will get replaced dynamically:
    42704271     *
    4271      * ###SITENAME###    The name of the site.
    4272      * ###USER_EMAIL###  The user email for the request.
    4273      * ###DESCRIPTION### Description of the action being performed so the user knows what the email is for.
    4274      * ###MANAGE_URL###  The URL to manage requests.
    4275      * ###SITEURL###     The URL to the site.
     4272     *  - `###SITENAME###`    The name of the site.
     4273     *  - `###USER_EMAIL###`  The user email for the request.
     4274     *  - `###DESCRIPTION###` Description of the action being performed so the user knows what the email is for.
     4275     *  - `###MANAGE_URL###`  The URL to manage requests.
     4276     *  - `###SITEURL###`     The URL to the site.
    42764277     *
    42774278     * @since 4.9.6
    … …  
    43124313     * The following strings have a special meaning and will get replaced dynamically:
    43134314     *
    4314      * ###SITENAME###    The name of the site.
    4315      * ###USER_EMAIL###  The user email for the request.
    4316      * ###DESCRIPTION### Description of the action being performed so the user knows what the email is for.
    4317      * ###MANAGE_URL###  The URL to manage requests.
    4318      * ###SITEURL###     The URL to the site.
     4315     *  - `###SITENAME###`    The name of the site.
     4316     *  - `###USER_EMAIL###`  The user email for the request.
     4317     *  - `###DESCRIPTION###` Description of the action being performed so the user knows what the email is for.
     4318     *  - `###MANAGE_URL###`  The URL to manage requests.
     4319     *  - `###SITEURL###`     The URL to the site.
    43194320     *
    43204321     * @since 5.8.0
    … …  
    45124513     * The following strings have a special meaning and will get replaced dynamically:
    45134514     *
    4514      * ###SITENAME###           The name of the site.
    4515      * ###PRIVACY_POLICY_URL### Privacy policy page URL.
    4516      * ###SITEURL###            The URL to the site.
     4515     *  - `###SITENAME###`           The name of the site.
     4516     *  - `###PRIVACY_POLICY_URL###` Privacy policy page URL.
     4517     *  - `###SITEURL###`            The URL to the site.
    45174518     *
    45184519     * @since 4.9.6
    … …  
    45544555     * The following strings have a special meaning and will get replaced dynamically:
    45554556     *
    4556      * ###SITENAME###           The name of the site.
    4557      * ###PRIVACY_POLICY_URL### Privacy policy page URL.
    4558      * ###SITEURL###            The URL to the site.
     4557     *  - `###SITENAME###`           The name of the site.
     4558     *  - `###PRIVACY_POLICY_URL###` Privacy policy page URL.
     4559     *  - `###SITEURL###`            The URL to the site.
    45594560     *
    45604561     * @since 5.8.0
    … …  
    48744875     * The following strings have a special meaning and will get replaced dynamically:
    48754876     *
    4876      * ###DESCRIPTION### Description of the action being performed so the user knows what the email is for.
    4877      * ###CONFIRM_URL### The link to click on to confirm the account action.
    4878      * ###SITENAME###    The name of the site.
    4879      * ###SITEURL###     The URL to the site.
     4877     *  - `###DESCRIPTION###` Description of the action being performed so the user knows what the email is for.
     4878     *  - `###CONFIRM_URL###` The link to click on to confirm the account action.
     4879     *  - `###SITENAME###`    The name of the site.
     4880     *  - `###SITEURL###`     The URL to the site.
    48804881     *
    48814882     * @since 4.9.6
Note: See TracChangeset for help on using the changeset viewer.