=== Add to home screen WP === Contributors: tulipwork Donate link: https://tulipemedia.com Tags: iPhone, iOs, homescreen, homescreen, webapp Requires at least: 6.7 Tested up to: 6.7 Stable tag: 2.3 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Add to HomeScreen WordPress plugin invites your readers to add your blog as an icon / web app on home screen of their iPhone, iPad and iPod touch. == Description == This plugin uses [Add to home screen's Cubiq script](https://cubiq.org/add-to-home-screen "Add to home screen") to place a floating balloon inviting the user to add a website to their home screen as a standard iOs application. It's a good way to retain visitors coming to your blog, especially if you don't want to develop an expensive application just to let them read articles of your WordPress blog. The floating balloon is compatible with all recent iPhones and iPads. 2023 UPDATE : The Add to home screen WP Plugin supports the latest versions of WordPress, and its use with the main Progressive Web App (PWA) extensions is highly recommended. You can now use a PWA WordPress plugin, like PWA for WP & AMP for instance, to turn your WordPress blog into a kind of native mobile app, without the constraints of native mobile app (store submission, costs, etc...). With PWA coupled with Add to home screen WP Plugin, you will be able to display the legendary floating balloon that invites your visitors to add your blog to their iOs device, and then your blog will load as a PWA. This combination is the best way to increase visitor loyalty, without being obliged to upload a costly native mobile app into App Store. On Android devices, PWA extensions usually provide a popup to invite users to add your blog to their device. But in iOs devices, this popup are not native. That's why this plugin is very useful in addition of a PWA plugin. = Demo = See nice demo with the video below : https://www.youtube.com/watch?v=Bd4i4k_DhE4 [Check a demo in my blog](https://tulipemedia.com) (load it on an iPhone for instance). [Read more and documentation on my blog](https://tulipemedia.com/en/add-to-home-screen-wordpress-plugin/ "Add to home screen WP Plugin documentation on Tulipe Media") [En savoir plus et lire la documentation sur mon blog](https://tulipemedia.com/plugin-wordpress-pour-ajouter-son-blog-a-lecran-daccueil-iphone-ipad-et-ipod-touch/ "Plugin Add to Home Screen pour WordPress sur Tulipe Media") = Internationalisation = This plugin provides support for language translations. Help me to translate it by [notifying me in comments](https://tulipemedia.com/en/add-to-home-screen-wordpress-plugin/ "notify me in comments") and I'll add your mo/po files to the official plugin. Available languages: English, French and German. Thanks to [Julian](https://profiles.wordpress.org/h3p315t05 "Julian") for the German translation! = Features = *Thanks to the functions of the Cubiq script, there are many features and allowed customizations:* * Message: type the message that you want inside the floating window. If you don't custom the message, the script checks the user's locale and shows a default message in an appropriate language. You can also force a language. * Animation: drop, bubble or fade. * Delays: before showing the message and its duration. * Expire: minutes before displaying the message again. * Touch icon: icon of your app but also image while your app is loading. * Show to returning visitors only: to only target returning visitors and not irritate first time visitors. *Additional features:* * Custom the title of your application. * Show message on homepage only or on the entire blog. = Follow me = Keep in touch with me on: Twitter Facebook == Installation == 1. Upload add-to-home-screen-wp folder to the '/wp-content/plugins/' directory or install it via the WordPress dashboard. 2. Activate the plugin through the 'Plugins' menu in WordPress. The floating balloon is now enabled. 3. Go to Settings > ATHS Options and play with settings. == Frequently Asked Questions == = If a visitor adds my blog to its home screen, will the balloon continue to appear? = Your blog will open on Safari browser when you will tap on your icon, and the balloon will continue to appear (unfortunately, we cannot prevent it from being opened in this mode even if user has alreay added the blog to its homescreen). The solution is to set an important expire timeframe (e.g on year) in the options page. = I made changes on options page but nothing's changed when I load my blog? = Try to: * Clear your cache if you're using a cache plugin * Clear your Safari cache/cookies. * Reboot Safari: on iPhone for instance, you have to double-click on the home button, then press Safari button several seconds and click on the close button. = The blog title on my icon is cut? = Application names on the home screen are limited to a maximum of 12 characters, so anything beyond that will be truncated. Try to keep the title of your application under 13 characters on the iPhone if you want to prevent it from being cut off. Fortunately, there is an option in the plugin to customize your application title, it can be very useful especially if the title of your blog is too long. = Can I custom the text that will appear in the floating balloon? = Of course, and it's highly suggested! You can add link, bold text and also add emojis to gamify your floating ballon and increase conversions. See screeenshots and videos to see examples. = Can I translate the message that appears in the floating ballon? = Yes sir! With WPML, download and install the "String translation" add-on, scroll down, click on "Translate texts in admin screens" and look for "Message" field with the search tool of your browser, you should find the field containing your custom message. Just check the left box and save settings. Now come back to String translation and you will find your custom message, ready to be translated! == Screenshots == 1. Example of a nice custom floating balloon 2. Example of the English floating balloon 3. Example of the French floating balloon 4. Plugin Option page 5. Plugin Option page == Changelog == = 2.3 = Minor fix. = 2.2 = Support for HTML formatting in the custom message balloon for richer styling. = 2.1 = Major fix. = 2 = Major fix. = 1.9 = Minor fix. = 1.8 = Minor fix. = 1.7 = Minor fix, tested up to WordPress 5.4. = 1.6 = Little fix. = 1.5 = Little fix. = 1.4 = New version tested up to WordPress 5.2. = 1.3 = Bugs fixed. = 1.2 = New version tested up to 4.8.1. Some old functionnalities have been removed. = 1.1 = Fix for the iOS 7 web app status bar. German translation added. = 1.0 = Floating balloon updated for iOS 7. = 0.9 = New home screen icons and startup screens for all iOs devices (ipad, iPhone 5, etc...). = 0.8 = Fix bug with "homepage only or all pages" option. Some little performance improvements. = 0.7 = Improvement of the bottom navigation bar on Web App: added forward and reload buttons. Allow using Safari mode in Web App. Fix bug with the "returningVisitor" function. = 0.6 = Improvement CSS of the Web App. Allow opening the balloon on homepage only or all pages. = 0.5 = Touch startup image that is displayed while the web application launches. Prevent links switching to Safari browser. Add navigation bar (back button) in the Web App. = 0.4 = Allow customizing Web App Title. = 0.3 = Ability to use device and icon tags when customizing the message. Allow using apostrophe in custom message. = 0.2 = Display title of the page. = 0.1 = First version of the plugin. == Upgrade Notice == = 2.3 = Minor fix. = 2.2 = Support for HTML formatting in the custom message balloon for richer styling. = 1.2 = New version tested up to 4.8.1. Some old functionalities have been removed. = 1.1 = Fix for the iOS 7 web app status bar. German translation added. = 1.0 = Floating balloon updated for iOS 7. = 0.9 = New home screen icons and startup screens for all iOs devices (ipad, iPhone 5, etc...). = 0.8 = Fix bug with "homepage only or all pages" option. Some little performance improvements. = 0.7 = Improvement of the bottom navigation bar on Web App with forward and reload buttons. Allow using Safari mode in Web App. Fix bug with the "returningVisitor" function. = 0.6 = Improvement CSS of the Web App. Allow opening the balloon on homepage only or all pages. = 0.5 = Touch startup image that is displayed while the web application launches. Prevent links switching to Safari browser. Add navigation bar (back and forward buttons) in the Web App. = 0.4 = Allow customizing Web App Title. = 0.3 = Allow using device and icon tags when customizing the message. Function addslashes added to allow using apostrophe in the custom message field. = 0.2 = Retrieve the wp_title function to display real page title below the home screen icon. = 0.1 = First version of the plugin. == Credits == This plugin has been written by [Ziyad Bachalany](https://tulipemedia.com) and uses the [Add to Home Screen Floating Layer script](https://cubiq.org/add-to-home-screen) by Matteo Spinelli that is released under the MIT License (see below). ## License This software is released under the MIT License. Copyright (c) 2013 Matteo Spinelli, https://cubiq.org/ Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.