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

Timestamp:

03/07/2021 12:30:38 PM (6 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