Changeset 50505 for trunk/src/wp-admin/media-upload.php

Timestamp:

03/07/2021 12:30:38 PM (4 years ago)

Author:

johnbillion

Message:

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

File:

• trunk/src/wp-admin/media-upload.php (modified) (1 diff)

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

@@ -88 +88 @@
      *
      * The dynamic portion of the hook name, `$type`, refers to the specific
-     * media upload type. Possible values include 'image', 'audio', 'video',
-     * 'file', etc.
+     * media upload type.
      *
      * The hook only fires if the current `$tab` is 'type' (From Computer),
      * 'type_url' (From URL), or, if the tab does not exist (i.e., has not
      * been registered via the {@see 'media_upload_tabs'} filter.
+     *
+     * Possible hook names include:
+     *
+     *  - `media_upload_audio`
+     *  - `media_upload_file`
+     *  - `media_upload_image`
+     *  - `media_upload_video`
      *
      * @since 2.5.0