Manual:$wgAppleTouchIcon

Details
Apple's iPhone and iPod Touch mobile devices will display an icon when you save a bookmark onto the home screen from Safari. This is somewhat similar to a favicon, but larger (59x60) or (118x120) on retina devices.

Example:

This produces a tag in HTML header output:

Setting $wgAppleTouchIcon is not required to support a custom icon; if left unset, the browser will attempt to load "/apple-touch-icon.png". If this doesn't exist either, a thumbnail of the page is used which is not very attractive.

Using the override option, wikis may set a different icon from other pages on the same host, or may simply choose to set a custom URL.

Guidelines


Clean images with good sharpness and contrast and a bright colored background will fit in reasonably well with other icons. If you don't have one to test with, refer to handy screen shots such as the one here.

Apple documentation recommends a 114x114 pixel PNG image, however 118x120 seems to be the mark for retina displays; a smaller image is scaled up slightly, becoming a bit blurry.

Rounded corners and a "glossy" texture are added by the iPhone UI, so use a flat, square background in your source image:

Transparent backgrounds are rendered as solid black.

Alternatively, use the following to avoid having a "glossy" texture added to your icon (note that the PNG image should use the same name):

See also: $wgFavicon