Skip to content

Hooks/Docs: big_image_size_threshold xref points to wp-admin/includes/images.php — file doesn't exist (typo: image vs images) #12

Closed

Description

@apermo

Problem

In the Gutenberg experimental media loader, the cross-reference for big_image_size_threshold points to wp-admin/includes/images.php, which does not exist. The file is named image.php (singular), not images.php.

Referencing file

https://github.com/apermo/wordpress-develop/blob/trunk/src/wp-content/plugins/gutenberg/lib/experimental/media/load.php#L62

Current comment:

/** This filter is documented in wp-admin/includes/images.php */
$image_size_threshold = (int) apply_filters( 'big_image_size_threshold', 2560, array( 0, 0 ), '', 0 );

Primary documentation

The hook is documented with a full PHPDoc block in wp-admin/includes/image.php:

https://github.com/apermo/wordpress-develop/blob/trunk/src/wp-admin/includes/image.php#L264-L285

Fix

- /** This filter is documented in wp-admin/includes/images.php */
+ /** This filter is documented in wp-admin/includes/image.php */

Activity

  1. added this to the Broken cross-references milestone on Mar 8, 2026
  2. added
    documentationImprovements or additions to documentation
    verifiedIssue is manually verified.
    on Mar 8, 2026
  3. apermo commented on Mar 8, 2026

    @apermo
    OwnerAuthor

    The only broken xref for this hook is in src/wp-content/plugins/gutenberg/lib/experimental/media/load.php, which is part of the bundled Gutenberg plugin (gitignored in wordpress-develop). The fix needs to go through the Gutenberg repo instead of core.

  4. apermo commented on Mar 8, 2026

    @apermo
    OwnerAuthor
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationverifiedIssue is manually verified.

    Projects

    No projects

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions