云策 WordPress 开发者社区

函数文档

wp_get_additional_image_sizes()

查看官方原文 ↗
💡 云策文档标注

概述

wp_get_additional_image_sizes() 函数用于检索 WordPress 中注册的额外图像尺寸数据。它返回一个数组，包含通过 add_image_size() 添加的自定义尺寸信息。

关键要点

  • 函数返回一个数组，表示额外图像尺寸的数据，如宽度、高度和裁剪设置。
  • 它依赖于全局变量 $_wp_additional_image_sizes，如果未设置则初始化为空数组。
  • 此函数在 WordPress 4.7.0 版本中引入，用于获取非核心图像尺寸。
📄 原文内容

Retrieves additional image sizes.

Return

array Additional images size data.

Source

function wp_get_additional_image_sizes() {
	global $_wp_additional_image_sizes;

	if ( ! $_wp_additional_image_sizes ) {
		$_wp_additional_image_sizes = array();
	}

	return $_wp_additional_image_sizes;
}

View all references View on Trac View on GitHub

Used by Description
wp_get_registered_image_subsizes()wp-includes/media.php

Returns a normalized list of all currently registered image sub-sizes.
wp_save_image()wp-admin/includes/image-edit.php

Saves image to post, along with enqueued changes in $_REQUEST['history'].
_wp_post_thumbnail_html()wp-admin/includes/post.php

Returns HTML for the post thumbnail meta box.
get_intermediate_image_sizes()wp-includes/media.php

Gets the available intermediate image size names.
image_constrain_size_for_editor()wp-includes/media.php

Scales down the default size of an image.
has_image_size()wp-includes/media.php

Checks if an image size exists.

Show 1 moreShow less

Changelog

Version Description
4.7.0 Introduced.