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.
Important! Please read
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.
This section describes how to install the plugin and get it working.
- Upload the full directory into your
- Activate the plugin at the plugin administration page
- Open the plugin settings page under Settings > Add to homescreen and add an application icon. Optionally customize the options to your liking
- Why doesn’t the call-out show up?
By 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.
- Can I upgrade to this plugin if I’m using an Add To Homescreen wrapper from another developer/vendor?
Just remember to deactivate the other plugins before installing this one.
Contributors and Developers
“Official Add to Homescreen” is open source software. The following people have contributed to this plugin.Contributors
Interested in development?
- Added iOS8 compatibility
- You can now set the active page by full URL
- fixed wrong settings link in plugin page
- Added “Homescreen Title” option
- Added “Destination Page” option
- Added Google Analytics integration
- Fixed custom message not showing up
- [JS] Added French translation
- [JS] Minor bug fixes
- [JS] Added German translation
- [JS] Fixed language detection
- [JS] Added Chinese translation
- [JS] Fixed close button
- Fixed paths
- Initial release