community-cordova-plugin-social-sharing 6.2.3 → 6.3.0

package/README.md

@@ -21,6 +21,14 @@ or if you're asking for new features or priority bug fixes. Thank you!
 
 > Version 6.0.0 is compatible with Android X. See [this issue](https://github.com/EddyVerbruggen/SocialSharing-PhoneGap-Plugin/pull/1039) for details. 5.6.8 is the last version before 6.0.0, so be sure to pick that if you run into Android X-related issues.
 
+### Changelog (Recent)
+
+#### 6.3.0
+- Added `hasEmailClients()` method to check if any email client is available (iOS & Android)
+- iOS: Improved email availability detection using mailto: URL scheme (works with third-party email apps like Gmail, Outlook when native Mail is not configured)
+- Changed global variable export to `SocialSharingPlugin` for consistency with other Cordova plugins
+- TypeScript types updated
+
 ## 0. Index
 
 1. [Description](#1-description)
@@ -292,6 +300,25 @@ Note that on Android, SMS via Hangouts may not behave correctly
 
 #### Email
 Code inspired by the [EmailComposer plugin](https://github.com/katzer/cordova-plugin-email-composer), note that this is not supported on the iOS 8 simulator (an alert will be shown if your try to).
+
+##### Check if email clients are available
+Use `hasEmailClients` to check if any email client is installed. On iOS, this checks for mailto: URL scheme support, which works with third-party email apps (Gmail, Outlook, etc.) even when the native Mail app is not configured.
+```js
+SocialSharingPlugin.hasEmailClients(
+  function(hasClients) {
+    if (hasClients) {
+      console.log('Email clients available');
+    } else {
+      console.log('No email clients found');
+    }
+  },
+  function(error) {
+    console.log('Error: ' + error);
+  }
+);
+```
+
+##### Send email
 ```js
 window.plugins.socialsharing.shareViaEmail(
   'Message', // can contain HTML tags, but support on Android is rather limited:  http://stackoverflow.com/questions/15136480/how-to-send-html-content-with-image-through-android-default-email-client

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "community-cordova-plugin-social-sharing",
-  "version": "6.2.3",
+  "version": "6.3.0",
   "description": "Share text, images (and other files), or a link via the native sharing widget of your device. Android is fully supported, as well as iOS 6 and up. WP8 has somewhat limited support.",
   "cordova": {
     "id": "community-cordova-plugin-social-sharing",

package/plugin.xml

@@ -2,7 +2,7 @@
 <plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
         xmlns:android="http://schemas.android.com/apk/res/android"
         id="community-cordova-plugin-social-sharing"
-        version="6.2.3">
+        version="6.3.0">
 
   <name>SocialSharing</name>
 
@@ -28,7 +28,7 @@
   <dependency id="es6-promise-plugin" version="^4.1.0" />
 
   <js-module src="www/SocialSharing.js" name="SocialSharing">
-    <clobbers target="window.plugins.socialsharing" />
+    <clobbers target="SocialSharingPlugin" />
   </js-module>
 
   <!-- ios -->

package/src/android/nl/xservices/plugins/SocialSharing.java

@@ -48,6 +48,7 @@ public class SocialSharing extends CordovaPlugin {
   private static final String ACTION_SHARE_WITH_OPTIONS_EVENT = "shareWithOptions";
   private static final String ACTION_CAN_SHARE_VIA = "canShareVia";
   private static final String ACTION_CAN_SHARE_VIA_EMAIL = "canShareViaEmail";
+  private static final String ACTION_HAS_EMAIL_CLIENTS = "hasEmailClients";
   private static final String ACTION_SHARE_VIA = "shareVia";
   private static final String ACTION_SHARE_VIA_TWITTER_EVENT = "shareViaTwitter";
   private static final String ACTION_SHARE_VIA_FACEBOOK_EVENT = "shareViaFacebook";
@@ -115,6 +116,10 @@ public class SocialSharing extends CordovaPlugin {
         callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.ERROR, "not available"));
         return false;
       }
+    } else if (ACTION_HAS_EMAIL_CLIENTS.equals(action)) {
+      boolean hasClients = isEmailAvailable();
+      callbackContext.sendPluginResult(new PluginResult(PluginResult.Status.OK, hasClients));
+      return true;
     } else if (ACTION_SHARE_VIA.equals(action)) {
       return doSendIntent(callbackContext, args.getString(0), args.getString(1), args.getJSONArray(2), args.getString(3), args.getString(4), null, false, true);
     } else if (ACTION_SHARE_VIA_SMS_EVENT.equals(action)) {

package/src/ios/SocialSharing.h

@@ -14,6 +14,7 @@
 - (void)shareWithOptions:(CDVInvokedUrlCommand*)command;
 - (void)canShareVia:(CDVInvokedUrlCommand*)command;
 - (void)canShareViaEmail:(CDVInvokedUrlCommand*)command;
+- (void)hasEmailClients:(CDVInvokedUrlCommand*)command;
 - (void)shareVia:(CDVInvokedUrlCommand*)command;
 - (void)shareViaTwitter:(CDVInvokedUrlCommand*)command;
 - (void)shareViaFacebook:(CDVInvokedUrlCommand*)command;

package/src/ios/SocialSharing.m

@@ -269,10 +269,26 @@ static NSString *const kShareOptionIPadCoordinates = @"iPadCoordinates";
 }
 
 - (bool)isEmailAvailable {
+  // First check if any app can handle mailto: URL (works for third-party email apps)
+  NSURL *mailtoURL = [NSURL URLWithString:@"mailto:test@test.com"];
+  if ([[UIApplication sharedApplication] canOpenURL:mailtoURL]) {
+    return true;
+  }
+  // Fallback to native Mail app check
   Class messageClass = (NSClassFromString(@"MFMailComposeViewController"));
   return messageClass != nil && [messageClass canSendMail];
 }
 
+- (void)hasEmailClients:(CDVInvokedUrlCommand*)command {
+  // Check if any email client can handle mailto: URLs
+  NSURL *mailtoURL = [NSURL URLWithString:@"mailto:test@test.com"];
+  BOOL hasClients = [[UIApplication sharedApplication] canOpenURL:mailtoURL];
+  NSLog(@"SocialSharing: hasEmailClients = %@", hasClients ? @"YES" : @"NO");
+
+  CDVPluginResult *pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsBool:hasClients];
+  [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+}
+
 - (bool)isAvailableForSharing:(CDVInvokedUrlCommand*)command
                          type:(NSString *) type {
 
@@ -336,19 +352,74 @@ static NSString *const kShareOptionIPadCoordinates = @"iPadCoordinates";
 }
 
 - (void)shareViaEmail:(CDVInvokedUrlCommand*)command {
-  if ([self isEmailAvailable]) {
+  // Check if MFMailComposeViewController class is available
+  Class messageClass = (NSClassFromString(@"MFMailComposeViewController"));
+  if (messageClass == nil) {
+    CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"not available"];
+    [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+    return;
+  }
 
-    if (TARGET_IPHONE_SIMULATOR && IsAtLeastiOSVersion(@"8.0")) {
-      UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"SocialSharing plugin"
-                                                      message:@"Sharing via email is not supported on the iOS 8 simulator."
-                                                     delegate:nil
-                                            cancelButtonTitle:@"OK"
-                                            otherButtonTitles:nil];
-      [alert show];
-      return;
+  // Try to open mail composer even if canSendMail returns false
+  // On newer iOS, canSendMail may return false even when third-party mail apps are available
+  BOOL canSendMail = [MFMailComposeViewController canSendMail];
+  NSLog(@"SocialSharing: canSendMail = %@", canSendMail ? @"YES" : @"NO");
+
+  if (!canSendMail) {
+    // Try using mailto: URL scheme as fallback
+    NSString *message = [command.arguments objectAtIndex:0];
+    NSString *subject = [command.arguments objectAtIndex:1];
+    NSArray *toRecipients = [command.arguments objectAtIndex:2];
+
+    NSMutableString *mailtoURL = [NSMutableString stringWithString:@"mailto:"];
+
+    if (toRecipients != (id)[NSNull null] && [toRecipients count] > 0) {
+      [mailtoURL appendString:[toRecipients componentsJoinedByString:@","]];
     }
 
-    [self cycleTheGlobalMailComposer];
+    NSMutableArray *params = [[NSMutableArray alloc] init];
+
+    if (subject != (id)[NSNull null] && [subject length] > 0) {
+      [params addObject:[NSString stringWithFormat:@"subject=%@", [subject stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]]]];
+    }
+
+    if (message != (id)[NSNull null] && [message length] > 0) {
+      [params addObject:[NSString stringWithFormat:@"body=%@", [message stringByAddingPercentEncodingWithAllowedCharacters:[NSCharacterSet URLQueryAllowedCharacterSet]]]];
+    }
+
+    if ([params count] > 0) {
+      [mailtoURL appendString:@"?"];
+      [mailtoURL appendString:[params componentsJoinedByString:@"&"]];
+    }
+
+    NSURL *url = [NSURL URLWithString:mailtoURL];
+    NSLog(@"SocialSharing: Trying mailto URL: %@", mailtoURL);
+
+    dispatch_async(dispatch_get_main_queue(), ^{
+      [[UIApplication sharedApplication] openURL:url options:@{} completionHandler:^(BOOL success) {
+        if (success) {
+          CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsBool:YES];
+          [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+        } else {
+          CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"No email app available"];
+          [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+        }
+      }];
+    });
+    return;
+  }
+
+  if (TARGET_IPHONE_SIMULATOR && IsAtLeastiOSVersion(@"8.0")) {
+    UIAlertView *alert = [[UIAlertView alloc] initWithTitle:@"SocialSharing plugin"
+                                                    message:@"Sharing via email is not supported on the iOS 8 simulator."
+                                                   delegate:nil
+                                          cancelButtonTitle:@"OK"
+                                          otherButtonTitles:nil];
+    [alert show];
+    return;
+  }
+
+  [self cycleTheGlobalMailComposer];
 
     self.globalMailComposer.mailComposeDelegate = self;
 
@@ -427,10 +498,6 @@ static NSString *const kShareOptionIPadCoordinates = @"iPadCoordinates";
     dispatch_async(dispatch_get_main_queue(), ^{
       [[self getTopMostViewController] presentViewController:self.globalMailComposer animated:YES completion:nil];
     });
-  } else {
-    CDVPluginResult * pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"not available"];
-    [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
-  }
 }
 
 - (UIViewController*) getTopMostViewController {

package/types/index.d.ts

@@ -1,5 +1,5 @@
 // Type definitions for PhoneGap / Cordova Social Sharing plugin
-// Project: https://github.com/EddyVerbruggen/SocialSharing-PhoneGap-Plugin
+// Project: https://github.com/AhmedRaisi/SocialSharing-PhoneGap-Plugin
 // Licensed under the MIT license.
 
 interface Window {
@@ -7,44 +7,14 @@ interface Window {
 }
 
 interface Plugins {
-	socialsharing: SocialSharing
+	socialsharing: SocialSharingManager
 }
 
 interface Navigator {
 	share: SocialSharingW3C
 }
 
-declare class SocialSharing {
-	iPadPopupCoordinates: () => string
-	setIPadPopupCoordinates: (coords: string) => void
-	available: (callback: (available: boolean) => void) => void
-	shareWithOptions: (options: SocialSharingOptions, successCallback?: SocialSharingSuccessCallback<SocialSharingResult>, errorCallback?: SocialSharingErrorCallback) => void
-	shareW3C: SocialSharingW3C
-	share: (message?: string, subject?: string, fileOrFileArray?: string | ArrayLike<string>, url?: string, successCallback?: SocialSharingSuccessCallback<boolean>, errorCallback?: SocialSharingErrorCallback) => void
-	shareViaTwitter: (message?: string, file?: string, url?: string, successCallback?: SocialSharingSuccessCallback<boolean>, errorCallback?: SocialSharingErrorCallback) => void
-	shareViaFacebook: (message?: string, fileOrFileArray?: string | ArrayLike<string>, url?: string, successCallback?: SocialSharingSuccessCallback<boolean>, errorCallback?: SocialSharingErrorCallback) => void
-	shareViaFacebookWithPasteMessageHint: (message?: string, fileOrFileArray?: string | ArrayLike<string>, url?: string, pasteMessageHint?: string, successCallback?: SocialSharingSuccessCallback<boolean>, errorCallback?: SocialSharingErrorCallback) => void
-	shareViaWhatsApp: (message?: string, fileOrFileArray?: string | ArrayLike<string>, url?: string, successCallback?: SocialSharingSuccessCallback<never>, errorCallback?: SocialSharingErrorCallback) => void
-	shareViaWhatsAppToReceiver: (receiver?: string, message?: string, fileOrFileArray?: string | ArrayLike<string>, url?: string, successCallback?: SocialSharingSuccessCallback<never>, errorCallback?: SocialSharingErrorCallback) => void
-	shareViaWhatsAppToPhone: (phone?: string, message?: string, fileOrFileArray?: string | ArrayLike<string>, url?: string, successCallback?: SocialSharingSuccessCallback<never>, errorCallback?: SocialSharingErrorCallback) => void
-	shareViaSMS: (options?: SocialSharingOptions | string, phoneNumbers?: ArrayLike<string>, successCallback?: SocialSharingSuccessCallback<boolean>, errorCallback?: SocialSharingErrorCallback) => void
-	shareViaEmail: (message?: string, subject?: string, toArray?: ArrayLike<string>, ccArray?: ArrayLike<string>, bccArray?: ArrayLike<string>, fileOrFileArray?: string | ArrayLike<string>, successCallback?: SocialSharingSuccessCallback<boolean>, errorCallback?: SocialSharingErrorCallback) => void
-	canShareVia: (via: string, message?: string, subject?: string, fileOrFileArray?: string | ArrayLike<string>, successCallback?: SocialSharingSuccessCallback<never>, errorCallback?: SocialSharingErrorCallback) => void
-	canShareViaEmail: (successCallback?: SocialSharingSuccessCallback<never>, errorCallback?: SocialSharingErrorCallback) => void
-	shareViaInstagram: (message?: string, fileOrFileArray?: string | ArrayLike<string>, successCallback?: SocialSharingSuccessCallback<never>, errorCallback?: SocialSharingErrorCallback) => void
-	shareVia: (via: string, message?: string, subject?: string, fileOrFileArray?: string | ArrayLike<string>, url?: string, successCallback?: SocialSharingSuccessCallback<boolean>, errorCallback?: SocialSharingErrorCallback) => void
-	saveToPhotoAlbum: (fileOrFileArray?: string | ArrayLike<string>, successCallback?: SocialSharingSuccessCallback<never>, errorCallback?: SocialSharingErrorCallback) => void
-}
-
-type SocialSharingW3C = (shareData: SocialSharingW3CData) => Promise<SocialSharingResult>
-
-interface SocialSharingW3CData {
-	title?: string
-	text?: string
-	url?: string
-}
-
-interface SocialSharingOptions {
+export interface SocialSharingOptions {
 	message?: string
 	subject?: string
 	files?: ArrayLike<string>
@@ -53,10 +23,119 @@ interface SocialSharingOptions {
 	appPackageName?: string
 }
 
-type SocialSharingSuccessCallback<T> = (result: T) => void
-type SocialSharingErrorCallback = (msg?: string) => void
-
-interface SocialSharingResult {
+export interface SocialSharingResult {
 	completed: boolean
 	app?: string
 }
+
+export interface SocialSharingW3CData {
+	title?: string
+	text?: string
+	url?: string
+}
+
+export type SocialSharingW3C = (shareData: SocialSharingW3CData) => Promise<SocialSharingResult>
+export type SocialSharingSuccessCallback<T> = (result: T) => void
+export type SocialSharingErrorCallback = (msg?: string) => void
+
+/**
+ * Social Sharing Plugin Manager
+ * Direct access to the Cordova Social Sharing plugin
+ */
+export default class SocialSharingManager {
+	iPadPopupCoordinates: () => string
+	setIPadPopupCoordinates: (coords: string) => void
+
+	/**
+	 * Check if sharing is available
+	 */
+	available(callback: (available: boolean) => void): void
+
+	/**
+	 * Share with options (recommended)
+	 */
+	shareWithOptions(options: SocialSharingOptions, successCallback?: SocialSharingSuccessCallback<SocialSharingResult>, errorCallback?: SocialSharingErrorCallback): void
+
+	/**
+	 * W3C-compliant share method
+	 */
+	shareW3C: SocialSharingW3C
+
+	/**
+	 * Generic share
+	 */
+	share(message?: string, subject?: string, fileOrFileArray?: string | ArrayLike<string>, url?: string, successCallback?: SocialSharingSuccessCallback<boolean>, errorCallback?: SocialSharingErrorCallback): void
+
+	/**
+	 * Share via Twitter
+	 */
+	shareViaTwitter(message?: string, file?: string, url?: string, successCallback?: SocialSharingSuccessCallback<boolean>, errorCallback?: SocialSharingErrorCallback): void
+
+	/**
+	 * Share via Facebook
+	 */
+	shareViaFacebook(message?: string, fileOrFileArray?: string | ArrayLike<string>, url?: string, successCallback?: SocialSharingSuccessCallback<boolean>, errorCallback?: SocialSharingErrorCallback): void
+
+	/**
+	 * Share via Facebook with paste message hint
+	 */
+	shareViaFacebookWithPasteMessageHint(message?: string, fileOrFileArray?: string | ArrayLike<string>, url?: string, pasteMessageHint?: string, successCallback?: SocialSharingSuccessCallback<boolean>, errorCallback?: SocialSharingErrorCallback): void
+
+	/**
+	 * Share via WhatsApp
+	 */
+	shareViaWhatsApp(message?: string, fileOrFileArray?: string | ArrayLike<string>, url?: string, successCallback?: SocialSharingSuccessCallback<never>, errorCallback?: SocialSharingErrorCallback): void
+
+	/**
+	 * Share via WhatsApp to specific receiver
+	 */
+	shareViaWhatsAppToReceiver(receiver?: string, message?: string, fileOrFileArray?: string | ArrayLike<string>, url?: string, successCallback?: SocialSharingSuccessCallback<never>, errorCallback?: SocialSharingErrorCallback): void
+
+	/**
+	 * Share via WhatsApp to specific phone number
+	 */
+	shareViaWhatsAppToPhone(phone?: string, message?: string, fileOrFileArray?: string | ArrayLike<string>, url?: string, successCallback?: SocialSharingSuccessCallback<never>, errorCallback?: SocialSharingErrorCallback): void
+
+	/**
+	 * Share via SMS
+	 */
+	shareViaSMS(options?: SocialSharingOptions | string, phoneNumbers?: ArrayLike<string>, successCallback?: SocialSharingSuccessCallback<boolean>, errorCallback?: SocialSharingErrorCallback): void
+
+	/**
+	 * Share via Email
+	 */
+	shareViaEmail(message?: string, subject?: string, toArray?: ArrayLike<string>, ccArray?: ArrayLike<string>, bccArray?: ArrayLike<string>, fileOrFileArray?: string | ArrayLike<string>, successCallback?: SocialSharingSuccessCallback<boolean>, errorCallback?: SocialSharingErrorCallback): void
+
+	/**
+	 * Check if can share via specific app
+	 */
+	canShareVia(via: string, message?: string, subject?: string, fileOrFileArray?: string | ArrayLike<string>, successCallback?: SocialSharingSuccessCallback<never>, errorCallback?: SocialSharingErrorCallback): void
+
+	/**
+	 * Check if can share via email (native Mail app)
+	 */
+	canShareViaEmail(successCallback?: SocialSharingSuccessCallback<never>, errorCallback?: SocialSharingErrorCallback): void
+
+	/**
+	 * Check if email clients are available (works with third-party apps like Gmail, Outlook)
+	 */
+	hasEmailClients(successCallback?: SocialSharingSuccessCallback<boolean>, errorCallback?: SocialSharingErrorCallback): void
+
+	/**
+	 * Share via Instagram
+	 */
+	shareViaInstagram(message?: string, fileOrFileArray?: string | ArrayLike<string>, successCallback?: SocialSharingSuccessCallback<never>, errorCallback?: SocialSharingErrorCallback): void
+
+	/**
+	 * Share via specific app
+	 */
+	shareVia(via: string, message?: string, subject?: string, fileOrFileArray?: string | ArrayLike<string>, url?: string, successCallback?: SocialSharingSuccessCallback<boolean>, errorCallback?: SocialSharingErrorCallback): void
+
+	/**
+	 * Save to photo album
+	 */
+	saveToPhotoAlbum(fileOrFileArray?: string | ArrayLike<string>, successCallback?: SocialSharingSuccessCallback<never>, errorCallback?: SocialSharingErrorCallback): void
+}
+
+// Legacy type alias for backward compatibility
+declare class SocialSharing extends SocialSharingManager {}

package/www/SocialSharing.js

@@ -107,6 +107,10 @@ SocialSharing.prototype.canShareViaEmail = function (successCallback, errorCallb
   cordova.exec(successCallback, this._getErrorCallback(errorCallback, "canShareViaEmail"), "SocialSharing", "canShareViaEmail", []);
 };
 
+SocialSharing.prototype.hasEmailClients = function (successCallback, errorCallback) {
+  cordova.exec(successCallback, this._getErrorCallback(errorCallback, "hasEmailClients"), "SocialSharing", "hasEmailClients", []);
+};
+
 SocialSharing.prototype.shareViaInstagram = function (message, fileOrFileArray, successCallback, errorCallback) {
   cordova.exec(successCallback, this._getErrorCallback(errorCallback, "shareViaInstagram"), "SocialSharing", "shareViaInstagram", [message, null, this._asArray(fileOrFileArray), null]);
 };
@@ -138,20 +142,6 @@ SocialSharing.prototype._getErrorCallback = function (ecb, functionName) {
   }
 };
 
-SocialSharing.install = function () {
-  if (!window.plugins) {
-    window.plugins = {};
-  }
-
-  window.plugins.socialsharing = new SocialSharing();
-
-  // Note only polyfill navigator.share if it is not defined, since shareW3C implements L1 of the spec,
-  // and an existing navigator.share method could implement L2.
-  if (!navigator.share) {
-    navigator.share = window.plugins.socialsharing.shareW3C;
-  }
-
-  return window.plugins.socialsharing;
-};
+var SocialSharingPlugin = new SocialSharing();
 
-cordova.addConstructor(SocialSharing.install);
+module.exports = SocialSharingPlugin;