Docs: Add examples of possible names for various hooks whose name contains a dynamic portion.

This provides greater discoverability of such hooks in search results on the Code Reference site as well as increased clarity when reading the source.

See #50734, #52628


git-svn-id: https://develop.svn.wordpress.org/trunk@50505 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
John Blackbourn
2021-03-07 12:30:38 +00:00
parent c3be472657
commit fa05e5e733
26 changed files with 403 additions and 35 deletions

View File

@@ -84,8 +84,16 @@ if ( $tab ) {
* Fires before each of the tabs are rendered on the Install Themes page.
*
* The dynamic portion of the hook name, `$tab`, refers to the current
* theme installation tab. Possible values are 'dashboard', 'search', 'upload',
* 'featured', 'new', or 'updated'.
* theme installation tab.
*
* Possible hook names include:
*
* - `install_themes_pre_dashboard`
* - `install_themes_pre_featured`
* - `install_themes_pre_new`
* - `install_themes_pre_search`
* - `install_themes_pre_updated`
* - `install_themes_pre_upload`
*
* @since 2.8.0
*/
@@ -251,8 +259,16 @@ if ( $tab ) {
* Fires at the top of each of the tabs on the Install Themes page.
*
* The dynamic portion of the hook name, `$tab`, refers to the current
* theme installation tab. Possible values are 'dashboard', 'search', 'upload',
* 'featured', 'new', or 'updated'.
* theme installation tab.
*
* Possible hook names include:
*
* - `install_themes_dashboard`
* - `install_themes_featured`
* - `install_themes_new`
* - `install_themes_search`
* - `install_themes_updated`
* - `install_themes_upload`
*
* @since 2.8.0
*