![(please configure the [header_logo] section in trac.ini)](/chrome/site/your_project_logo.png){kind=logo}
Changeset 33198 for trunk/src/wp-admin/includes/class-wp-site-icon.php
- Timestamp:
- 07/13/2015 05:50:41 PM (11 years ago)
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
trunk/src/wp-admin/includes/class-wp-site-icon.php
r33180 r33198 1 1 <?php 2 3 2 /** 4 * Class WP_Site_Icon.3 * Class for implementing site icon functionality. 5 4 * 6 5 * @since 4.3.0 … … 12 11 * 13 12 * @since 4.3.0 14 * 13 * @access public 15 14 * @var int 16 15 */ … … 21 20 * 22 21 * @since 4.3.0 23 * 22 * @access public 24 23 * @var int 25 24 */ … … 27 26 28 27 /** 29 * 30 * @since 4.3.0 31 * 28 * List of site icon sizes. 29 * 30 * @since 4.3.0 31 * @access public 32 32 * @var array 33 33 */ 34 34 public $site_icon_sizes = array( 35 /* *35 /* 36 36 * Square, medium sized tiles for IE11+. 37 37 * 38 * @linkhttps://msdn.microsoft.com/library/dn455106(v=vs.85).aspx38 * See https://msdn.microsoft.com/library/dn455106(v=vs.85).aspx 39 39 */ 40 40 270, 41 41 42 /* *42 /* 43 43 * App icons up to iPhone 6 Plus. 44 44 * 45 * @linkhttps://developer.apple.com/library/prerelease/ios/documentation/UserExperience/Conceptual/MobileHIG/IconMatrix.html45 * See https://developer.apple.com/library/prerelease/ios/documentation/UserExperience/Conceptual/MobileHIG/IconMatrix.html 46 46 */ 47 47 180, … … 52 52 53 53 /** 54 * Register our actions and filters. 55 * 56 * @since 4.3.0 54 * Registers actions and filters. 55 * 56 * @since 4.3.0 57 * @access public 57 58 */ 58 59 public function __construct() { … … 69 70 70 71 /** 71 * Add a hidden upload page.72 * Adds a hidden upload page. 72 73 * 73 74 * There is no need to access it directly. 74 75 * 75 76 * @since 4.3.0 77 * @access public 76 78 */ 77 79 public function admin_menu_upload_site_icon() { … … 84 86 85 87 /** 86 * Add scripts to admin settings pages. 87 * 88 * @since 4.3.0 88 * Adds scripts to admin settings pages. 89 * 90 * @since 4.3.0 91 * @access public 89 92 */ 90 93 public function enqueue_scripts() { … … 94 97 95 98 /** 96 * Load on when the admin is initialized. 97 * 98 * @since 4.3.0 99 * Loads the settings when the admin is initialized. 100 * 101 * @since 4.3.0 102 * @access public 99 103 */ 100 104 public function add_upload_settings() { … … 106 110 107 111 /** 108 * Removes site icon. 109 * 110 * @since 4.3.0 112 * Removes the site icon. 113 * 114 * @since 4.3.0 115 * @access public 111 116 */ 112 117 public function remove_site_icon() { … … 119 124 120 125 /** 126 * Handle uploading a site icon. 127 * 121 128 * Uploading a site_icon is a 3 step process 122 129 * … … 126 133 * 127 134 * @since 4.3.0 135 * @access public 128 136 */ 129 137 public function upload_site_icon_page() { … … 149 157 * 150 158 * @since 4.3.0 159 * @access public 151 160 */ 152 161 public function select_page() { … … 161 170 162 171 /** 163 * Settings field for file upload. 164 * 165 * @since 4.3.0 172 * Handles settings field for file upload. 173 * 174 * @since 4.3.0 175 * @access public 166 176 */ 167 177 public function upload_field() { … … 192 202 193 203 /** 194 * Check if the image needs cropping.204 * Checks if the image needs cropping. 195 205 * 196 206 * If it doesn't need cropping, proceed to set the icon. 197 207 * 198 208 * @since 4.3.0 209 * @access public 199 210 */ 200 211 public function maybe_skip_cropping() { … … 223 234 224 235 /** 225 * Crop a the image admin view. 226 * 227 * @since 4.3.0 236 * Handles the image crop admin view. 237 * 238 * @since 4.3.0 239 * @access public 228 240 */ 229 241 public function crop_page() { … … 315 327 316 328 /** 317 * Saves a new Site Icon. 318 * 319 * @since 4.3.0 329 * Handles saving a new Site Icon. 330 * 331 * @since 4.3.0 332 * @access public 320 333 */ 321 334 public function set_site_icon() { … … 325 338 $create_new_attachement = ! empty( $_REQUEST['create-new-attachment'] ); 326 339 327 /* 328 * If the current attachment as been set as site icon don't delete it. 329 */ 340 // If the current attachment as been set as site icon don't delete it. 330 341 if ( get_option( 'site_icon' ) == $attachment_id ) { 331 342 // Get the file path. … … 374 385 375 386 /** 376 * Upload the file to be cropped in the second step. 377 * 378 * @since 4.3.0 387 * Handles uploading the file to be cropped in the second step. 388 * 389 * @since 4.3.0 390 * @access public 379 391 */ 380 392 public function handle_upload() { … … 412 424 413 425 /** 414 * Create an attachment 'object'.426 * Creates an attachment 'object'. 415 427 * 416 428 * @since 4.3.0 … … 441 453 442 454 /** 443 * Insert an attachment. 444 * 445 * @since 4.3.0 455 * Inserts an attachment. 456 * 457 * @since 4.3.0 458 * @access public 446 459 * 447 460 * @param array $object Attachment object. … … 457 470 458 471 /** 459 * Updatethe metadata of an attachment.472 * Handles updating the metadata of an attachment. 460 473 * 461 474 * @since 4.3.0 … … 481 494 482 495 /** 483 * Add additional sizes to be made when creating the site_icon images. 484 * 485 * @since 4.3.0 486 * 487 * @param array $sizes 488 * @return array 496 * Adds additional sizes to be made when creating the site_icon images. 497 * 498 * @since 4.3.0 499 * @access public 500 * 501 * @param array $sizes List of additional sizes. 502 * @return array Additional image sizes. 489 503 */ 490 504 public function additional_sizes( $sizes = array() ) { … … 525 539 526 540 /** 527 * Add Site Icon sizes to the array of image sizes on demand. 528 * 529 * @since 4.3.0 530 * 531 * @param array $sizes 532 * @return array 541 * Adds Site Icon sizes to the array of image sizes on demand. 542 * 543 * @since 4.3.0 544 * @access public 545 * 546 * @param array $sizes List of image sizes. 547 * @return array List of intermediate image sizes. 533 548 */ 534 549 public function intermediate_image_sizes( $sizes = array() ) { … … 546 561 * 547 562 * @since 4.3.0 548 * 549 * @return bool 563 * @access public 564 * 565 * @return bool Whether the site icon was successfully deleted. 550 566 */ 551 567 public function delete_site_icon() { … … 562 578 * 563 579 * @since 4.3.0 580 * @access public 564 581 * 565 582 * @param int $post_id Attachment ID. … … 577 594 * 578 595 * @since 4.3.0 579 * 580 * @param null|array|string $value The value get_metadata() should581 * return - a single metadata value,582 * or anarray of values.596 * @access public 597 * 598 * @param null|array|string $value The value get_metadata() should return a single metadata value, or an 599 * array of values. 583 600 * @param int $post_id Post ID. 584 601 * @param string $meta_key Meta key. 585 602 * @param string|array $single Meta value, or an array of values. 586 * @return array|null|string 603 * @return array|null|string The attachment metadata value, array of values, or null. 587 604 */ 588 605 public function get_post_metadata( $value, $post_id, $meta_key, $single ) { … … 597 614 598 615 /** 599 * Get the data required to work with the uploaded image 600 * 601 * @since 4.3.0 616 * Gets the data required to work with the uploaded image 617 * 618 * @since 4.3.0 619 * @access private 602 620 * 603 621 * @return array containing the collected data
Note:
See TracChangeset
for help on using the changeset viewer.
