filter_default_metadata

函数
filter_default_metadata ( $value, $object_id, $meta_key, $single, $meta_type )
参数
  • (mixed) $value Current value passed to filter.
    Required:
  • (int) $object_id ID of the object metadata is for.
    Required:
  • (string) $meta_key Metadata key.
    Required:
  • (bool) $single If true, return only the first value of the specified `$meta_key`. This parameter has no effect if `$meta_key` is not specified.
    Required:
  • (string) $meta_type Type of object metadata is for. Accepts 'post', 'comment', 'term', 'user', or any other object type with an associated meta table.
    Required:
返回值
  • (mixed) An array of default values if `$single` is false. The default value of the meta field if `$single` is true.
定义位置
相关方法
filter_default_optionregister_default_headersdelete_metadataunregister_default_headersget_metadata
引入
5.5.0
弃用
-

filter_default_metadata – 这个过滤器用来修改一个文章或页面的默认元数据。它接受元数据数组和文章类型作为其参数。

过滤到default_{$object_type}_metadata并加入默认值。

function filter_default_metadata( $value, $object_id, $meta_key, $single, $meta_type ) {
	global $wp_meta_keys;

	if ( wp_installing() ) {
		return $value;
	}

	if ( ! is_array( $wp_meta_keys ) || ! isset( $wp_meta_keys[ $meta_type ] ) ) {
		return $value;
	}

	$defaults = array();
	foreach ( $wp_meta_keys[ $meta_type ] as $sub_type => $meta_data ) {
		foreach ( $meta_data as $_meta_key => $args ) {
			if ( $_meta_key === $meta_key && array_key_exists( 'default', $args ) ) {
				$defaults[ $sub_type ] = $args;
			}
		}
	}

	if ( ! $defaults ) {
		return $value;
	}

	// If this meta type does not have subtypes, then the default is keyed as an empty string.
	if ( isset( $defaults[''] ) ) {
		$metadata = $defaults[''];
	} else {
		$sub_type = get_object_subtype( $meta_type, $object_id );
		if ( ! isset( $defaults[ $sub_type ] ) ) {
			return $value;
		}
		$metadata = $defaults[ $sub_type ];
	}

	if ( $single ) {
		$value = $metadata['default'];
	} else {
		$value = array( $metadata['default'] );
	}

	return $value;
}

常见问题

FAQs
查看更多 >