Official Add To Homescreen plugin displays a callout to mobile users inviting them to add the website to the home screen.
Official Add To Homescreen is a WordPress wrapper for the Add To Homescreen javascript plugin. This WordPress plugin guides you through the rather complicated javascript widget configuration.
This is the only WordPress plugin developed by the same author of the javascript widget (hence “official”). If you wish to be always up to date and receive the latest bug fixes, this plugin is probably your best bet.
The plugin opens a message inviting the mobile user to add the application to the home screen. This is currently supported on iOS and Mobile Chrome. While other devices have the ability to bookmark any website to the home screen, only iOS and Mobile Chrome have a straightforward way to do it. Windows Phone support is planned for a future release.
To enhance performance and reduce complexity I’m supporting the latest two OS version for each device only.
Add To Homescreen development started when Apple introduced the apple-mobile-web-app-capable
meta tag and standalone
mode with it. It was a great news for web developers who had the opportunity to release full screen web applications (and not just websites). The script evolved over time and extended to a more general purpose use case.
It is important to note that there’s no native event we could hook to to know when a user actually added the page to the homescreen. That’s also the reason why this script has become so complicated despite the apparent simple task it has to accomplish.
Unless you explicitly developed your application to be mobile-web-app-capable
, this script can’t do miracles and all the alternative solutions have to be considered hacks.
The Basic configuration gives you four presets, the only 100% fail-safe solution is to select the Anonymous option. This disables user tracking but it doesn’t interfere with other plugins you may have.
Considering the complexity of the script, before filing a negative feedback, please drop a support request or a bug report. It’s the only way for me to enhance this software. Thanks!
This WordPress plugin is released under the GPL license. You can use it free of charge for personal and commercial use, but further modifications and derivatives have to be released under the same GPL license.
The Add To Homescreen javascript component is released under MIT license, which basically means you can do whatever you want with it.
This section describes how to install the plugin and get it working.
wp-content/plugins
directoryBy default the call out is set to show up only from the second time you access the website. Once displayed it doesn’t bother your users for another 24h. These are all parameters you can vary in the Advanced settings.
Also, remember that this works only on iOS and Chrome for Android. No other mobile device or desktop browser will show the message.
Yes. This plugin detects previous versions of the javascript component and knows if users have already added the website to the home screen.
Just remember to deactivate the other plugins before installing this one.