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.