=== Badawy App Launcher ===
Contributors: waelbadawy
Tags: mobile app, deep link, app store, android, ios
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

Add a button that opens your iPhone or Android app, with App Store, Google Play, and web fallbacks.

== Description ==

Badawy App Launcher adds configurable mobile-app launch buttons to WordPress through the `[badawy_app_launcher]` shortcode.

Configure separate iPhone/iPad and Android deep links, store URLs, a web fallback, and the fallback delay under Settings > App Launcher. The plugin does not contact a remote service, collect analytics, or include third-party code.

Whether a mobile app opens depends on the app's own deep-link configuration. For the most reliable experience, configure Apple Universal Links and Android App Links in the mobile applications and on the associated website.

== Installation ==

1. Upload the `badawy-app-launcher` folder to `/wp-content/plugins/` or install its ZIP.
2. Activate Badawy App Launcher.
3. Open Settings > App Launcher.
4. Enter the app deep links and store URLs.
5. Add `[badawy_app_launcher]` to a post, page, or widget that supports shortcodes.

== Frequently Asked Questions ==

= What shortcode should I use? =

Use `[badawy_app_launcher]`.

You can customize the label, CSS class, and app route:

`[badawy_app_launcher label="Open our app" class="my-button" path="article/123"]`

= Can a website determine whether the app is installed? =

Browsers do not provide a fully reliable, privacy-safe installation check. The plugin attempts the configured deep link and then uses the appropriate store or web fallback after a short delay.

= Does this create Universal Links or Android App Links? =

No. Those links also require configuration in the iOS and Android applications and association files on the website. This plugin renders the launch button and handles browser fallback behavior.

== Changelog ==

= 1.0.0 =
* Initial release.
* Added configurable iOS and Android deep links.
* Added App Store, Google Play, and web fallbacks.
* Added shortcode attributes for labels, CSS classes, and app routes.
