| 1 | <?php |
|---|
| 2 | |
|---|
| 3 | class WP_Site_Icon { |
|---|
| 4 | private static $instance = null; |
|---|
| 5 | |
|---|
| 6 | /** |
|---|
| 7 | * The minimum size of the site icon. |
|---|
| 8 | * |
|---|
| 9 | * @since 4.3.0 |
|---|
| 10 | * |
|---|
| 11 | * @var int |
|---|
| 12 | */ |
|---|
| 13 | public $min_size = 512; |
|---|
| 14 | |
|---|
| 15 | /** |
|---|
| 16 | * |
|---|
| 17 | * @since 4.3.0 |
|---|
| 18 | * |
|---|
| 19 | * @var array |
|---|
| 20 | */ |
|---|
| 21 | public $site_icon_sizes = array( |
|---|
| 22 | /** |
|---|
| 23 | * Square, medium sized tiles for IE11+. |
|---|
| 24 | * |
|---|
| 25 | * @link https://msdn.microsoft.com/library/dn455106(v=vs.85).aspx |
|---|
| 26 | */ |
|---|
| 27 | 270, |
|---|
| 28 | |
|---|
| 29 | /** |
|---|
| 30 | * App icons up to iPhone 6 Plus. |
|---|
| 31 | * |
|---|
| 32 | * @link https://developer.apple.com/library/prerelease/ios/documentation/UserExperience/Conceptual/MobileHIG/IconMatrix.html |
|---|
| 33 | */ |
|---|
| 34 | 180, |
|---|
| 35 | |
|---|
| 36 | // Our regular Favicon. |
|---|
| 37 | 32, |
|---|
| 38 | ); |
|---|
| 39 | |
|---|
| 40 | static function get_instance() { |
|---|
| 41 | if ( is_null( self::$instance ) ) { |
|---|
| 42 | self::$instance = new WP_Site_Icon; |
|---|
| 43 | } |
|---|
| 44 | return self::$instance; |
|---|
| 45 | } |
|---|
| 46 | |
|---|
| 47 | /** |
|---|
| 48 | * Add Site Icon sizes to the array of image sizes on demand. |
|---|
| 49 | * |
|---|
| 50 | * @since 4.3.0 |
|---|
| 51 | * |
|---|
| 52 | * @param array $sizes |
|---|
| 53 | * @return array |
|---|
| 54 | */ |
|---|
| 55 | public function intermediate_image_sizes( $sizes = array() ) { |
|---|
| 56 | /** This filter is documented in wp-admin/includes/site-icon.php */ |
|---|
| 57 | $this->site_icon_sizes = apply_filters( 'site_icon_image_sizes', $this->site_icon_sizes ); |
|---|
| 58 | foreach ( $this->site_icon_sizes as $size ) { |
|---|
| 59 | $sizes[] = 'site_icon-' . $size; |
|---|
| 60 | } |
|---|
| 61 | |
|---|
| 62 | return $sizes; |
|---|
| 63 | } |
|---|
| 64 | |
|---|
| 65 | /** |
|---|
| 66 | * Add additional sizes to be made when creating the site_icon images. |
|---|
| 67 | * |
|---|
| 68 | * @since 4.3.0 |
|---|
| 69 | * |
|---|
| 70 | * @param array $sizes |
|---|
| 71 | * @return array |
|---|
| 72 | */ |
|---|
| 73 | public function additional_sizes( $sizes = array() ) { |
|---|
| 74 | $only_crop_sizes = array(); |
|---|
| 75 | |
|---|
| 76 | /** |
|---|
| 77 | * Filter the different dimensions that a site icon is saved in. |
|---|
| 78 | * |
|---|
| 79 | * @since 4.3.0 |
|---|
| 80 | * |
|---|
| 81 | * @param array $site_icon_sizes Sizes available for the Site Icon. |
|---|
| 82 | */ |
|---|
| 83 | $this->site_icon_sizes = apply_filters( 'site_icon_image_sizes', $this->site_icon_sizes ); |
|---|
| 84 | |
|---|
| 85 | // Use a natural sort of numbers. |
|---|
| 86 | natsort( $this->site_icon_sizes ); |
|---|
| 87 | $this->site_icon_sizes = array_reverse( $this->site_icon_sizes ); |
|---|
| 88 | |
|---|
| 89 | // ensure that we only resize the image into |
|---|
| 90 | foreach ( $sizes as $name => $size_array ) { |
|---|
| 91 | if ( $size_array['crop'] ) { |
|---|
| 92 | $only_crop_sizes[ $name ] = $size_array; |
|---|
| 93 | } |
|---|
| 94 | } |
|---|
| 95 | |
|---|
| 96 | foreach ( $this->site_icon_sizes as $size ) { |
|---|
| 97 | if ( $size < $this->min_size ) { |
|---|
| 98 | $only_crop_sizes[ 'site_icon-' . $size ] = array( |
|---|
| 99 | 'width ' => $size, |
|---|
| 100 | 'height' => $size, |
|---|
| 101 | 'crop' => true, |
|---|
| 102 | ); |
|---|
| 103 | } |
|---|
| 104 | } |
|---|
| 105 | |
|---|
| 106 | return $only_crop_sizes; |
|---|
| 107 | } |
|---|
| 108 | |
|---|
| 109 | |
|---|
| 110 | } |
|---|