Changeset 51327

Timestamp:

07/03/2021 09:41:02 PM (5 years ago)

Author:

johnbillion

Message:

Docs: Add and correct examples of common names for various dynamic hooks.

See #53581

Location:

trunk/src

Files:

• wp-admin/admin.php (modified) (1 diff)
• wp-admin/includes/media.php (modified) (1 diff)
• wp-admin/includes/meta-boxes.php (modified) (1 diff)
• wp-includes/category-template.php (modified) (1 diff)
• wp-includes/class-wp-rewrite.php (modified) (1 diff)
• wp-includes/comment-template.php (modified) (1 diff)
• wp-includes/post.php (modified) (2 diffs)
• wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php (modified) (2 diffs)
• wp-includes/revision.php (modified) (1 diff)
• wp-includes/taxonomy.php (modified) (1 diff)

trunk/src/wp-admin/admin.php

@@ -321 +321 @@
          * The dynamic portion of the hook name, `$importer`, refers to the importer slug.
          *
+         * Possible hook names include:
+         *
+         *  - `load-importer-blogger`
+         *  - `load-importer-wpcat2tag`
+         *  - `load-importer-livejournal`
+         *  - `load-importer-mt`
+         *  - `load-importer-rss`
+         *  - `load-importer-tumblr`
+         *  - `load-importer-wordpress`
+         *
          * @since 3.5.0
          */

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

@@ -579 +579 @@
                  *
                  * The dynamic portion of the hook, `$content_func`, refers to the form
-                 * callback for the media upload type. Possible values include
-                 * 'media_upload_type_form', 'media_upload_type_url_form', and
-                 * 'media_upload_library_form'.
+                 * callback for the media upload type.
                  *
                  * @since 2.5.0

trunk/src/wp-admin/includes/meta-boxes.php

@@ -1583 +1583 @@
          * The dynamic portion of the hook, `$post_type`, refers to the post type of the post.
          *
+         * Possible hook names include:
+         *
+         *  - `add_meta_boxes_post`
+         *  - `add_meta_boxes_page`
+         *  - `add_meta_boxes_attachment`
+         *
          * @since 3.0.0
          *

trunk/src/wp-includes/category-template.php

@@ -1347 +1347 @@
          * to the taxonomy slug.
          *
+         * Possible hook names include:
+         *
+         *  - `term_links-category`
+         *  - `term_links-post_tag`
+         *  - `term_links-post_format`
+         *
          * @since 2.5.0
          *

trunk/src/wp-includes/class-wp-rewrite.php

@@ -1412 +1412 @@
                          *
                          * The dynamic portion of the hook name, `$permastructname`, refers
-                         * to the name of the registered permastruct, e.g. 'post_tag' (tags),
-                         * 'category' (categories), etc.
+                         * to the name of the registered permastruct.
+                         *
+                         * Possible hook names include:
+                         *
+                         *  - `category_rewrite_rules`
+                         *  - `post_format_rewrite_rules`
+                         *  - `post_tag_rewrite_rules`
                          *
                          * @since 3.1.0

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

@@ -2648 +2648 @@
                                          *
                                          * The dynamic portion of the filter hook, `$name`, refers to the name
-                                         * of the comment form field. Such as 'author', 'email', or 'url'.
+                                         * of the comment form field.
+                                         *
+                                         * Possible hook names include:
+                                         *
+                                         *  - `comment_form_field_comment`
+                                         *  - `comment_form_field_author`
+                                         *  - `comment_form_field_email`
+                                         *  - `comment_form_field_url`
+                                         *  - `comment_form_field_cookies`
                                          *
                                          * @since 3.0.0

trunk/src/wp-includes/post.php

@@ -4412 +4412 @@
                  * the post type slug.
                  *
+                 * Possible hook names include:
+                 *
+                 *  - `edit_post_post`
+                 *  - `edit_post_page`
+                 *
                  * @since 5.1.0
                  *
@@ -4448 +4453 @@
          * The dynamic portion of the hook name, `$post->post_type`, refers to
          * the post type slug.
+         *
+         * Possible hook names include:
+         *
+         *  - `save_post_post`
+         *  - `save_post_page`
          *
          * @since 3.7.0

trunk/src/wp-includes/rest-api/endpoints/class-wp-rest-posts-controller.php

@@ -1024 +1024 @@
                  *
                  * They dynamic portion of the hook name, `$this->post_type`, refers to the post type slug.
+                 *
+                 * Possible hook names include:
+                 *
+                 *  - `rest_delete_post`
+                 *  - `rest_delete_page`
+                 *  - `rest_delete_attachment`
                  *
                  * @since 4.7.0
@@ -2535 +2541 @@
                  * post type slug for the controller.
                  *
+                 * Possible hook names include:
+                 *
+                 *  - `rest_post_item_schema`
+                 *  - `rest_page_item_schema`
+                 *  - `rest_attachment_item_schema`
+                 *
                  * @since 5.4.0
                  *

trunk/src/wp-includes/revision.php

@@ -575 +575 @@
          * the post type slug.
          *
+         * Possible hook names include:
+         *
+         *  - `wp_post_revisions_to_keep`
+         *  - `wp_page_revisions_to_keep`
+         *
          * @since 5.8.0
          *

trunk/src/wp-includes/taxonomy.php

@@ -949 +949 @@
          * to the slug of the term's taxonomy.
          *
+         * Possible hook names include:
+         *
+         *  - `get_category`
+         *  - `get_post_tag`
+         *
          * @since 2.3.0
          * @since 4.4.0 `$_term` is now a `WP_Term` object.