mirror of
https://github.com/WordPress/WordPress.git
synced 2024-08-27 08:09:49 +02:00
While using reserved PHP keywords as parameter name labels is allowed, in the context of function calls using named parameters in PHP 8.0+, this will easily lead to confusion. To avoid that, it is recommended not to use reserved keywords as function parameter names. This commit renames the `$object` variable to `$attachment` in `WP_Site_Icon::insert_attachment()` and updates the documentation accordingly. Follow-up to [52946], [52996], [52997], [52998], [53003], [53014], [53029], [53039], [53116], [53117]. Props jrf, aristath, poena, justinahinon, SergeyBiryukov. See #55327. Built from https://develop.svn.wordpress.org/trunk@53137 git-svn-id: http://core.svn.wordpress.org/trunk@52726 1a063a9b-81f0-0310-95a4-ce76da25c4cd
234 lines
6.1 KiB
PHP
234 lines
6.1 KiB
PHP
<?php
|
|
/**
|
|
* Administration API: WP_Site_Icon class
|
|
*
|
|
* @package WordPress
|
|
* @subpackage Administration
|
|
* @since 4.3.0
|
|
*/
|
|
|
|
/**
|
|
* Core class used to implement site icon functionality.
|
|
*
|
|
* @since 4.3.0
|
|
*/
|
|
class WP_Site_Icon {
|
|
|
|
/**
|
|
* The minimum size of the site icon.
|
|
*
|
|
* @since 4.3.0
|
|
* @var int
|
|
*/
|
|
public $min_size = 512;
|
|
|
|
/**
|
|
* The size to which to crop the image so that we can display it in the UI nicely.
|
|
*
|
|
* @since 4.3.0
|
|
* @var int
|
|
*/
|
|
public $page_crop = 512;
|
|
|
|
/**
|
|
* List of site icon sizes.
|
|
*
|
|
* @since 4.3.0
|
|
* @var int[]
|
|
*/
|
|
public $site_icon_sizes = array(
|
|
/*
|
|
* Square, medium sized tiles for IE11+.
|
|
*
|
|
* See https://msdn.microsoft.com/library/dn455106(v=vs.85).aspx
|
|
*/
|
|
270,
|
|
|
|
/*
|
|
* App icon for Android/Chrome.
|
|
*
|
|
* @link https://developers.google.com/web/updates/2014/11/Support-for-theme-color-in-Chrome-39-for-Android
|
|
* @link https://developer.chrome.com/multidevice/android/installtohomescreen
|
|
*/
|
|
192,
|
|
|
|
/*
|
|
* App icons up to iPhone 6 Plus.
|
|
*
|
|
* See https://developer.apple.com/library/prerelease/ios/documentation/UserExperience/Conceptual/MobileHIG/IconMatrix.html
|
|
*/
|
|
180,
|
|
|
|
// Our regular Favicon.
|
|
32,
|
|
);
|
|
|
|
/**
|
|
* Registers actions and filters.
|
|
*
|
|
* @since 4.3.0
|
|
*/
|
|
public function __construct() {
|
|
add_action( 'delete_attachment', array( $this, 'delete_attachment_data' ) );
|
|
add_filter( 'get_post_metadata', array( $this, 'get_post_metadata' ), 10, 4 );
|
|
}
|
|
|
|
/**
|
|
* Creates an attachment 'object'.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param string $cropped Cropped image URL.
|
|
* @param int $parent_attachment_id Attachment ID of parent image.
|
|
* @return array An array with attachment object data.
|
|
*/
|
|
public function create_attachment_object( $cropped, $parent_attachment_id ) {
|
|
$parent = get_post( $parent_attachment_id );
|
|
$parent_url = wp_get_attachment_url( $parent->ID );
|
|
$url = str_replace( wp_basename( $parent_url ), wp_basename( $cropped ), $parent_url );
|
|
|
|
$size = wp_getimagesize( $cropped );
|
|
$image_type = ( $size ) ? $size['mime'] : 'image/jpeg';
|
|
|
|
$attachment = array(
|
|
'ID' => $parent_attachment_id,
|
|
'post_title' => wp_basename( $cropped ),
|
|
'post_content' => $url,
|
|
'post_mime_type' => $image_type,
|
|
'guid' => $url,
|
|
'context' => 'site-icon',
|
|
);
|
|
|
|
return $attachment;
|
|
}
|
|
|
|
/**
|
|
* Inserts an attachment.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param array $attachment An array with attachment object data.
|
|
* @param string $file File path of the attached image.
|
|
* @return int Attachment ID.
|
|
*/
|
|
public function insert_attachment( $attachment, $file ) {
|
|
$attachment_id = wp_insert_attachment( $attachment, $file );
|
|
$metadata = wp_generate_attachment_metadata( $attachment_id, $file );
|
|
|
|
/**
|
|
* Filters the site icon attachment metadata.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @see wp_generate_attachment_metadata()
|
|
*
|
|
* @param array $metadata Attachment metadata.
|
|
*/
|
|
$metadata = apply_filters( 'site_icon_attachment_metadata', $metadata );
|
|
wp_update_attachment_metadata( $attachment_id, $metadata );
|
|
|
|
return $attachment_id;
|
|
}
|
|
|
|
/**
|
|
* Adds additional sizes to be made when creating the site icon images.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param array[] $sizes Array of arrays containing information for additional sizes.
|
|
* @return array[] Array of arrays containing additional image sizes.
|
|
*/
|
|
public function additional_sizes( $sizes = array() ) {
|
|
$only_crop_sizes = array();
|
|
|
|
/**
|
|
* Filters the different dimensions that a site icon is saved in.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param int[] $site_icon_sizes Array of sizes available for the Site Icon.
|
|
*/
|
|
$this->site_icon_sizes = apply_filters( 'site_icon_image_sizes', $this->site_icon_sizes );
|
|
|
|
// Use a natural sort of numbers.
|
|
natsort( $this->site_icon_sizes );
|
|
$this->site_icon_sizes = array_reverse( $this->site_icon_sizes );
|
|
|
|
// Ensure that we only resize the image into sizes that allow cropping.
|
|
foreach ( $sizes as $name => $size_array ) {
|
|
if ( isset( $size_array['crop'] ) ) {
|
|
$only_crop_sizes[ $name ] = $size_array;
|
|
}
|
|
}
|
|
|
|
foreach ( $this->site_icon_sizes as $size ) {
|
|
if ( $size < $this->min_size ) {
|
|
$only_crop_sizes[ 'site_icon-' . $size ] = array(
|
|
'width ' => $size,
|
|
'height' => $size,
|
|
'crop' => true,
|
|
);
|
|
}
|
|
}
|
|
|
|
return $only_crop_sizes;
|
|
}
|
|
|
|
/**
|
|
* Adds Site Icon sizes to the array of image sizes on demand.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param string[] $sizes Array of image size names.
|
|
* @return string[] Array of image size names.
|
|
*/
|
|
public function intermediate_image_sizes( $sizes = array() ) {
|
|
/** This filter is documented in wp-admin/includes/class-wp-site-icon.php */
|
|
$this->site_icon_sizes = apply_filters( 'site_icon_image_sizes', $this->site_icon_sizes );
|
|
foreach ( $this->site_icon_sizes as $size ) {
|
|
$sizes[] = 'site_icon-' . $size;
|
|
}
|
|
|
|
return $sizes;
|
|
}
|
|
|
|
/**
|
|
* Deletes the Site Icon when the image file is deleted.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param int $post_id Attachment ID.
|
|
*/
|
|
public function delete_attachment_data( $post_id ) {
|
|
$site_icon_id = get_option( 'site_icon' );
|
|
|
|
if ( $site_icon_id && $post_id == $site_icon_id ) {
|
|
delete_option( 'site_icon' );
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Adds custom image sizes when meta data for an image is requested, that happens to be used as Site Icon.
|
|
*
|
|
* @since 4.3.0
|
|
*
|
|
* @param null|array|string $value The value get_metadata() should return a single metadata value, or an
|
|
* array of values.
|
|
* @param int $post_id Post ID.
|
|
* @param string $meta_key Meta key.
|
|
* @param bool $single Whether to return only the first value of the specified `$meta_key`.
|
|
* @return array|null|string The attachment metadata value, array of values, or null.
|
|
*/
|
|
public function get_post_metadata( $value, $post_id, $meta_key, $single ) {
|
|
if ( $single && '_wp_attachment_backup_sizes' === $meta_key ) {
|
|
$site_icon_id = get_option( 'site_icon' );
|
|
|
|
if ( $post_id == $site_icon_id ) {
|
|
add_filter( 'intermediate_image_sizes', array( $this, 'intermediate_image_sizes' ) );
|
|
}
|
|
}
|
|
|
|
return $value;
|
|
}
|
|
}
|