=== Favicon Manager by MakeFav ===
Contributors: makefav
Tags: favicon, site icon, apple touch icon, pwa, manifest
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Upload one image or a favicon ZIP and get favicon.ico, Apple touch, Android/PWA icons and Windows tiles with clean head code.

== Description ==

**Favicon Manager by MakeFav** sets up a complete, modern favicon set in one step – no FTP, no copying HTML code, no editing theme files.

Upload a single image (PNG, JPG, WebP, AVIF, GIF, BMP or ICO) and the plugin creates every size that browsers, phones and operating systems need. Or upload a favicon ZIP package created on [MakeFav.com](https://makefav.com/) (or another favicon generator) and the plugin installs it exactly as it is.

= What you get =

* **favicon.ico** with 16, 32 and 48 px frames
* **PNG favicons** 16 × 16, 32 × 32 and 96 × 96 px
* **Apple touch icons** for iPhone and iPad (57 – 180 px), optionally on a solid background so iOS does not show black corners
* **Android and PWA icons** 36 – 512 px, including a **maskable icon** with a safe zone
* **site.webmanifest** with app name, theme colour, background colour and display mode
* **Windows tiles** and browserconfig.xml
* Correct `<link>` and `<meta>` tags in the `<head>` of every page, with automatic cache busting when you change the icon

= Clean output – only one favicon =

Themes and plugins often add their own favicon tags, which leads to the wrong icon being shown. Favicon Manager by MakeFav:

* replaces the WordPress Site Icon (Customizer) while your favicon is active,
* removes favicon, Apple touch icon, manifest and tile tags printed by the theme or other plugins (can be switched off),
* answers requests for `/favicon.ico` handled by WordPress with your new icon,
* loads after all other plugins, so its code always wins.

= ZIP packages from MakeFav.com =

[MakeFav.com](https://makefav.com/) is a free favicon generator with cropping, padding, rounded corners, background colours, a pixel editor and a favicon checker. Download your package there and upload the ZIP to the plugin – all files are used as they are and missing sizes are created automatically. ZIP packages from other favicon generators work too.

= Privacy =

The plugin does not connect to any external service, does not track anything and does not add any visible credit or link to your site. Images are processed on your own server with the PHP GD extension and stored in `wp-content/uploads/makefav-favicon/`.

More information: [Favicon Manager by MakeFav for WordPress](https://makefav.com/wordpress-favicon-plugin)

== Installation ==

1. Install the plugin from **Plugins → Add New** (search for "Favicon Manager by MakeFav"), or upload the plugin ZIP via **Plugins → Add New → Upload Plugin**.
2. Activate the plugin.
3. Go to **Settings → Favicon**.
4. Upload a square image (at least 512 × 512 px recommended) or a favicon ZIP package.
5. Optionally set the app name and colours and save.

== Frequently Asked Questions ==

= Which image works best? =

A square PNG with a transparent background, at least 512 × 512 px. Simple shapes and strong colours stay recognisable even at 16 × 16 px. Non-square images are centred automatically.

= Can I upload an SVG? =

SVG files are not accepted directly, because WordPress does not allow SVG uploads for security reasons and servers cannot reliably convert them. Convert your SVG on [MakeFav.com](https://makefav.com/) and upload the ZIP package.

= Which ZIP packages are supported? =

Packages from MakeFav.com and from most other favicon generators. The plugin uses PNG files with known names (for example `apple-icon-180x180.png` or `android-icon-192x192.png`) and `favicon.ico` as they are, reads the name and colours from `manifest.json` / `site.webmanifest` and `browserconfig.xml`, and creates any missing size from the largest PNG in the package.

= My browser still shows the old icon. =

Browsers cache favicons very aggressively. The plugin adds a version parameter to every icon URL, but some browsers keep the old icon until you clear the cache or restart the browser. Also check whether an old `favicon.ico` file exists in the root folder of your site – the plugin shows a warning if it finds one.

= Does it work with caching and optimisation plugins? =

Yes. After uploading a new icon, clear the page cache of your caching plugin or CDN so visitors receive the new HTML code.

= Will it remove favicons added by my theme? =

Yes, when "Remove favicon tags added by the theme or other plugins" is enabled (default). Only favicon-related `<link>` and `<meta>` tags in the `<head>` are removed; nothing else on the page is changed.

= Does it work on multisite? =

Yes. Every site of the network has its own favicon and settings.

= What happens when I delete the plugin? =

All settings and generated files are deleted. If you only deactivate the plugin, your files are kept and WordPress falls back to its own Site Icon.

== Screenshots ==

1. Upload an image or a favicon ZIP and see the preview for browser tabs, iOS and Android.
2. App name, colours, padding and clean-up options.

== Changelog ==

= 1.0.0 =
* First release.

== Upgrade Notice ==

= 1.0.0 =
First release.
