community-cordova-plugin-native-settings 1.0.0

package/.idea/community-cordova-plugin-native-settings.iml

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <excludeFolder url="file://$MODULE_DIR$/.tmp" />
+      <excludeFolder url="file://$MODULE_DIR$/temp" />
+      <excludeFolder url="file://$MODULE_DIR$/tmp" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/community-cordova-plugin-native-settings.iml" filepath="$PROJECT_DIR$/.idea/community-cordova-plugin-native-settings.iml" />
+    </modules>
+  </component>
+</project>

package/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$/../.." vcs="Git" />
+  </component>
+</project>

package/README.md

@@ -0,0 +1,191 @@
+[![NPM version](https://img.shields.io/npm/v/community-cordova-plugin-native-settings)](https://www.npmjs.com/package/community-cordova-plugin-native-settings)
+
+# community-cordova-plugin-native-settings 
+
+I dedicate a considerable amount of my free time to developing and maintaining many cordova plugins for the community ([See the list with all my maintained plugins][community_plugins]).
+To help ensure this plugin is kept updated,
+new features are added and bugfixes are implemented quickly,
+please donate a couple of dollars (or a little more if you can stretch) as this will help me to afford to dedicate time to its maintenance.
+Please consider donating if you're using this plugin in an app that makes you money,
+or if you're asking for new features or priority bug fixes. Thank you!
+
+[![](https://img.shields.io/static/v1?label=Sponsor%20Me&style=for-the-badge&message=%E2%9D%A4&logo=GitHub&color=%23fe8e86)](https://github.com/sponsors/eyalin)
+
+---
+
+# Community Cordova Plugin Native Settings
+
+## Overview
+This Cordova plugin provides a simple way to open native device settings screens on Android and iOS platforms. It allows your app to deep-link into specific system settings pages (Wi‑Fi, Bluetooth, Location, etc.) with a clean Promise-based API.
+
+## Installation
+To install the plugin in your Cordova project, use the following command:
+```bash
+cordova plugin add community-cordova-plugin-native-settings
+```
+
+## Usage
+The plugin provides a Promise-based API (also compatible with callbacks) to open various system settings screens.
+
+### Basic JavaScript Usage
+```javascript
+document.addEventListener('deviceready', onDeviceReady, false);
+
+function onDeviceReady() {
+    // Open Wi‑Fi settings
+    cordova.plugins.settings.open('wifi')
+        .then(() => console.log('Wi‑Fi settings opened'))
+        .catch(err => console.error('Failed to open settings:', err));
+
+    // Open settings in a new task (Android only)
+    cordova.plugins.settings.open({ setting: 'wifi', newTask: true })
+        .then(() => console.log('Settings opened in new task'))
+        .catch(err => console.error('Error:', err));
+}
+```
+
+### TypeScript/Angular Usage
+```typescript
+import { INativeSettings } from 'community-cordova-plugin-native-settings';
+
+declare const cordova: any;
+
+@Injectable({
+    providedIn: 'root'
+})
+export class SettingsService {
+    private settings: INativeSettings;
+
+    constructor() {
+        this.settings = cordova.plugins.settings;
+    }
+
+    async openWifiSettings(newTask: boolean = false): Promise<void> {
+        try {
+            await this.settings.open({ setting: 'wifi', newTask });
+            console.log('Wi‑Fi settings opened');
+        } catch (err) {
+            console.error('Failed to open settings:', err);
+            throw err;
+        }
+    }
+
+    async isWifiSettingsAvailable(): Promise<boolean> {
+        return await this.settings.isAvailable('wifi');
+    }
+}
+```
+
+## API Reference
+
+### Methods
+
+#### open(options: string | INativeSettingsOptions): Promise<void>
+Opens the requested settings page.
+
+Parameters:
+- `options`: Either a string (setting name) or an object with:
+  - `setting`: The settings page to open
+  - `newTask`: (Android only) Whether to open in a new task
+
+#### isAvailable(setting: string): Promise<boolean>
+Checks if a specific settings page is available on the current device.
+
+Parameters:
+- `setting`: The settings page to check
+
+### Supported Settings
+
+#### Android
+- 'wifi' - Wi‑Fi settings
+- 'location' - Location settings
+- 'bluetooth' - Bluetooth settings
+- 'accessibility' - Accessibility settings
+- 'add_account' - Add account settings
+- 'airplane_mode' - Airplane mode settings
+- 'apn' - APN settings
+- 'application_details' - App details
+- 'application_development' - Development settings
+- 'application' - Application settings
+- 'battery_optimization' - Battery optimization
+- 'device_info' - Device info
+- 'display' - Display settings
+- 'keyboard' - Keyboard settings
+- 'manage_all_applications' - All apps
+- 'manage_applications' - App management
+- 'memory_card' - Memory card
+- 'network' - Network settings
+- 'nfc' - NFC settings
+- 'notification' - Notification settings
+- 'security' - Security settings
+- 'sound' - Sound settings
+- 'sync' - Sync settings
+- 'usage' - Usage settings
+- 'user_dictionary' - User dictionary
+- 'voice_input' - Voice input settings
+- 'vpn' - VPN settings
+
+#### iOS
+- 'wifi' - Wi‑Fi settings
+- 'bluetooth' - Bluetooth settings
+- 'location' - Location settings
+- 'settings' - App settings
+- 'about' - About settings
+- 'accessibility' - Accessibility settings
+- 'account' - Account settings
+- 'airplane_mode' - Airplane mode
+- 'battery' - Battery settings
+- 'browser' - Browser settings
+- 'date' - Date settings
+- 'facetime' - FaceTime settings
+- 'keyboard' - Keyboard settings
+- 'locale' - Language settings
+- 'music' - Music settings
+- 'notification' - Notification settings
+- 'photos' - Photos settings
+- 'profile' - Profile settings
+- 'sounds' - Sound settings
+- 'storage' - Storage settings
+- 'wallpaper' - Wallpaper settings
+
+**Note**: Some iOS URL schemes are unofficial and may not work on all iOS versions. The plugin will fall back to opening the app's settings page in such cases.
+
+## Platform Specifics
+- **Android**: Provides comprehensive access to system settings through Android's Settings API
+- **iOS**: Uses URL schemes to deep-link into settings; some settings may fall back to the app settings page due to iOS restrictions
+
+## Contributing
+Contributions to the plugin are welcome! Please follow the standard fork and pull request workflow.
+
+## License
+This project is licensed under the MIT License.
+
+---
+[community_plugins]: https://github.com/EYALIN?tab=repositories&q=community&type=&language=&sort=
+
+Android (uses android.provider.Settings actions):
+
+- accessibility, account, airplane_mode, apn, application_details, application_development, application
+- battery_optimization, bluetooth, captioning, cast, data_roaming, date, display, dream
+- keyboard, keyboard_subtype, storage, locale, location, manage_all_applications, manage_applications
+- memory_card, network, nfcsharing, nfc_payment, nfc_settings, print, privacy, quick_launch
+- search, security, settings, show_regulatory_info, sound, sync, usage, user_dictionary
+- voice_input, wifi_ip, wifi, wireless
+
+iOS (deep-links; availability varies by iOS version):
+
+- about, accessibility, account, airplane_mode, autolock, battery, bluetooth, cellular, date
+- facetime, keyboard, language, location, music, notifications (falls back to app settings), photos
+- privacy, reset, ringtone, safari, sound, software_update, storage, vpn, wallpaper, wifi
+
+Note: iOS deep-linking uses App-Prefs / UIApplicationOpenSettingsURLString fallbacks. Apple may restrict or change these schemes in new iOS releases.
+
+## Contributing
+
+Contributions are welcome. Please open issues or PRs against the repository.
+
+## License
+
+MIT
+
+[community_plugins]: https://github.com/search?q=topic%3Acordova-plugin+org%3Aeyalin&type=Repositories

package/RELEASENOTES.md

@@ -0,0 +1,13 @@
+# Release Notes
+
+### 1.0.0 (Nov 07, 2025)
+* Initial release as a community plugin
+* Added Promise-based API
+* Added TypeScript support
+* Added isAvailable method
+* Improved error handling
+* Added comprehensive documentation
+* Added support for opening settings in new task (Android)
+* Modernized codebase and API design
+* Added full type definitions
+* Improved iOS compatibility

package/package.json

@@ -0,0 +1,22 @@
+
+{
+  "name": "community-cordova-plugin-native-settings",
+  "version": "1.0.0",
+  "description": "A Cordova plugin to open native device settings screens",
+  "types": "./types/index.d.ts",
+  "cordova": {
+    "id": "community-cordova-plugin-native-settings",
+    "platforms": ["android", "ios"]
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eyalin/community-cordova-plugin-native-settings.git"
+  },
+  "keywords": ["ecosystem:cordova","cordova-android","cordova-ios","settings","native-settings","preferences"],
+  "author": "EYALIN",
+  "license": "MIT",
+  "bugs": { "url": "https://github.com/eyalin/community-cordova-plugin-native-settings/issues" },
+  "homepage": "https://github.com/eyalin/community-cordova-plugin-native-settings#readme",
+  "funding": { "type": "github", "url": "https://github.com/sponsors/eyalin" }
+}
+

package/plugin.xml

@@ -0,0 +1,48 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+        xmlns:android="http://schemas.android.com/apk/res/android"
+        id="community-cordova-plugin-native-settings"
+        version="1.0.0">
+    <name>Cordova Plugin Native Settings</name>
+    <description>A Cordova plugin to open native device settings screens</description>
+    <license>MIT</license>
+    <keywords>cordova,settings,native,preferences,options,android,ios</keywords>
+    <repo>https://github.com/eyalin/community-cordova-plugin-native-settings.git</repo>
+    <issue>https://github.com/eyalin/community-cordova-plugin-native-settings/issues</issue>
+
+    <engines>
+        <engine name="cordova" version=">=4.0.0" />
+    </engines>
+
+    <js-module src="www/settings.js" name="SettingsPlugin">
+        <clobbers target="SettingsPlugin" />
+    </js-module>
+
+    <!-- android -->
+    <platform name="android">
+        <config-file target="res/xml/config.xml" parent="/*">
+            <feature name="NativeSettings">
+                <param name="android-package" value="com.ionicframework.plugins.nativesettings.NativeSettings" />
+            </feature>
+        </config-file>
+        <source-file src="src/android/NativeSettings.java" target-dir="src/com/ionicframework/plugins/nativesettings" />
+    </platform>
+
+    <!-- ios -->
+    <platform name="ios">
+        <config-file target="config.xml" parent="/*">
+            <feature name="NativeSettings">
+                <param name="ios-package" value="NativeSettings" />
+            </feature>
+        </config-file>
+        
+        <!-- Add App-Prefs to LSApplicationQueriesSchemes -->
+        <config-file target="*-Info.plist" parent="LSApplicationQueriesSchemes">
+            <array>
+                <string>App-Prefs</string>
+            </array>
+        </config-file>
+        <header-file src="src/ios/NativeSettings.h" />
+        <source-file src="src/ios/NativeSettings.m" />
+    </platform>
+</plugin>

package/plugin.xml.backup

@@ -0,0 +1,42 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<plugin xmlns="http://apache.org/cordova/ns/plugins/1.0"
+        xmlns:android="http://schemas.android.com/apk/res/android"
+        id="community-cordova-plugin-native-settings"
+        version="1.0.0">
+    <name>Cordova Plugin Native Settings</name>
+    <description>A Cordova plugin to open native device settings screens</description>
+    <license>MIT</license>
+    <keywords>cordova,settings,native,preferences,options,android,ios</keywords>
+    <repo>https://github.com/eyalin/community-cordova-plugin-native-settings.git</repo>
+    <issue>https://github.com/eyalin/community-cordova-plugin-native-settings/issues</issue>
+
+    <engines>
+        <engine name="cordova" version=">=4.0.0" />
+    </engines>
+
+    <js-module src="www/settings.js" name="SettingsPlugin">
+        <clobbers target="cordova.plugins.settings" />
+        <clobbers target="NativeSettings" />
+    </js-module>
+
+    <!-- android -->
+    <platform name="android">
+        <config-file target="res/xml/config.xml" parent="/*">
+            <feature name="NativeSettings">
+                <param name="android-package" value="com.ionicframework.plugins.nativesettings.NativeSettings" />
+            </feature>
+        </config-file>
+        <source-file src="src/android/NativeSettings.java" target-dir="src/com/ionicframework/plugins/nativesettings" />
+    </platform>
+
+    <!-- ios -->
+    <platform name="ios">
+        <config-file target="config.xml" parent="/*">
+            <feature name="NativeSettings">
+                <param name="ios-package" value="NativeSettings" />
+            </feature>
+        </config-file>
+        <header-file src="src/ios/NativeSettings.h" />
+        <source-file src="src/ios/NativeSettings.m" />
+    </platform>
+</plugin>

package/src/android/NativeSettings.java

@@ -0,0 +1,161 @@
+package com.ionicframework.plugins.nativesettings;
+
+import org.apache.cordova.CallbackContext;
+import org.apache.cordova.CordovaPlugin;
+import org.apache.cordova.PluginResult;
+import org.json.JSONArray;
+import org.json.JSONException;
+
+import android.content.Intent;
+import android.content.Context;
+import android.net.Uri;
+import android.os.Build;
+import android.provider.Settings;
+import java.util.HashMap;
+import java.util.Map;
+
+public class NativeSettings extends CordovaPlugin {
+    private static final Map<String, String> settingsMap = new HashMap<>();
+    
+    static {
+        // Initialize settings map
+        settingsMap.put("accessibility", Settings.ACTION_ACCESSIBILITY_SETTINGS);
+        settingsMap.put("account", Settings.ACTION_ADD_ACCOUNT);
+        settingsMap.put("airplane_mode", Settings.ACTION_AIRPLANE_MODE_SETTINGS);
+        settingsMap.put("apn", Settings.ACTION_APN_SETTINGS);
+        settingsMap.put("application_details", Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
+        settingsMap.put("application_development", Settings.ACTION_APPLICATION_DEVELOPMENT_SETTINGS);
+        settingsMap.put("application", Settings.ACTION_APPLICATION_SETTINGS);
+        settingsMap.put("bluetooth", Settings.ACTION_BLUETOOTH_SETTINGS);
+        // Android settings map - expanded
+        settingsMap.put("battery_optimization", Settings.ACTION_IGNORE_BATTERY_OPTIMIZATION_SETTINGS);
+        settingsMap.put("captioning", Settings.ACTION_CAPTIONING_SETTINGS);
+        settingsMap.put("cast", Settings.ACTION_CAST_SETTINGS);
+        settingsMap.put("data_roaming", Settings.ACTION_DATA_ROAMING_SETTINGS);
+        settingsMap.put("date", Settings.ACTION_DATE_SETTINGS);
+        settingsMap.put("about", Settings.ACTION_DEVICE_INFO_SETTINGS);
+        settingsMap.put("display", Settings.ACTION_DISPLAY_SETTINGS);
+        settingsMap.put("dream", Settings.ACTION_DREAM_SETTINGS);
+        settingsMap.put("home", Settings.ACTION_HOME_SETTINGS);
+        settingsMap.put("keyboard", Settings.ACTION_INPUT_METHOD_SETTINGS);
+        settingsMap.put("keyboard_subtype", Settings.ACTION_INPUT_METHOD_SUBTYPE_SETTINGS);
+        settingsMap.put("storage", Settings.ACTION_INTERNAL_STORAGE_SETTINGS);
+        settingsMap.put("locale", Settings.ACTION_LOCALE_SETTINGS);
+        settingsMap.put("location", Settings.ACTION_LOCATION_SOURCE_SETTINGS);
+        settingsMap.put("manage_all_applications", Settings.ACTION_MANAGE_ALL_APPLICATIONS_SETTINGS);
+        settingsMap.put("manage_applications", Settings.ACTION_MANAGE_APPLICATIONS_SETTINGS);
+        settingsMap.put("memory_card", Settings.ACTION_MEMORY_CARD_SETTINGS);
+        settingsMap.put("network", Settings.ACTION_NETWORK_OPERATOR_SETTINGS);
+        settingsMap.put("nfcsharing", Settings.ACTION_NFCSHARING_SETTINGS);
+        settingsMap.put("nfc_payment", Settings.ACTION_NFC_PAYMENT_SETTINGS);
+        settingsMap.put("nfc_settings", Settings.ACTION_NFC_SETTINGS);
+        settingsMap.put("print", Settings.ACTION_PRINT_SETTINGS);
+        settingsMap.put("privacy", Settings.ACTION_PRIVACY_SETTINGS);
+        settingsMap.put("quick_launch", Settings.ACTION_QUICK_LAUNCH_SETTINGS);
+        settingsMap.put("search", Settings.ACTION_SEARCH_SETTINGS);
+        settingsMap.put("security", Settings.ACTION_SECURITY_SETTINGS);
+        settingsMap.put("settings", Settings.ACTION_SETTINGS);
+        settingsMap.put("show_regulatory_info", Settings.ACTION_SHOW_REGULATORY_INFO);
+        settingsMap.put("sound", Settings.ACTION_SOUND_SETTINGS);
+        settingsMap.put("sync", Settings.ACTION_SYNC_SETTINGS);
+        settingsMap.put("usage", Settings.ACTION_USAGE_ACCESS_SETTINGS);
+        settingsMap.put("user_dictionary", Settings.ACTION_USER_DICTIONARY_SETTINGS);
+        settingsMap.put("voice_input", Settings.ACTION_VOICE_INPUT_SETTINGS);
+        settingsMap.put("wifi_ip", Settings.ACTION_WIFI_IP_SETTINGS);
+        settingsMap.put("wifi", Settings.ACTION_WIFI_SETTINGS);
+        settingsMap.put("wireless", Settings.ACTION_WIRELESS_SETTINGS);
+    }
+
+    @Override
+    public boolean execute(String action, JSONArray args, CallbackContext callbackContext) throws JSONException {
+        if (action.equals("open")) {
+            return openSettings(args, callbackContext);
+        } else if (action.equals("isAvailable")) {
+            return checkAvailability(args, callbackContext);
+        }
+        return false;
+    }
+
+    private boolean openSettings(JSONArray args, CallbackContext callbackContext) throws JSONException {
+        if (args == null || args.length() == 0) {
+            callbackContext.error("Setting name is required");
+            return false;
+        }
+
+        String settingName = args.getString(0);
+        boolean newTask = args.length() > 1 && args.getBoolean(1);
+        
+        Intent intent = getSettingsIntent(settingName);
+        if (intent == null) {
+            callbackContext.error("Invalid setting: " + settingName);
+            return false;
+        }
+
+        try {
+            if (newTask) {
+                intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+            }
+            this.cordova.getActivity().startActivity(intent);
+            callbackContext.success();
+            return true;
+        } catch (Exception e) {
+            callbackContext.error("Failed to open settings: " + e.getMessage());
+            return false;
+        }
+    }
+
+    private boolean checkAvailability(JSONArray args, CallbackContext callbackContext) throws JSONException {
+        if (args == null || args.length() == 0) {
+            callbackContext.error("Setting name is required");
+            return false;
+        }
+
+        String settingName = args.getString(0);
+        Intent intent = getSettingsIntent(settingName);
+        
+        callbackContext.success(intent != null ? 1 : 0);
+        return true;
+    }
+
+    private Intent getSettingsIntent(String setting) {
+        Context context = this.cordova.getActivity().getApplicationContext();
+        Uri packageUri = Uri.parse("package:" + context.getPackageName());
+        
+        String action = settingsMap.get(setting);
+        if (action != null) {
+            if (action.equals(Settings.ACTION_APPLICATION_DETAILS_SETTINGS)) {
+                return new Intent(action, packageUri);
+            }
+            return new Intent(action);
+        }
+
+        // Special cases
+        switch (setting) {
+            case "notification_id":
+                return getNotificationSettingsIntent(context);
+            case "store":
+                return new Intent(Intent.ACTION_VIEW,
+                        Uri.parse("market://details?id=" + context.getPackageName()));
+            // Add more special cases...
+        }
+
+        return null;
+    }
+
+    private Intent getNotificationSettingsIntent(Context context) {
+        Intent intent = new Intent();
+        if (Build.VERSION.SDK_INT > Build.VERSION_CODES.N_MR1) {
+            intent.setAction(Settings.ACTION_APP_NOTIFICATION_SETTINGS);
+            intent.putExtra(Settings.EXTRA_APP_PACKAGE, context.getPackageName());
+        } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
+            intent.setAction("android.settings.APP_NOTIFICATION_SETTINGS");
+            intent.putExtra("app_package", context.getPackageName());
+            intent.putExtra("app_uid", context.getApplicationInfo().uid);
+        } else {
+            intent.setAction(Settings.ACTION_APPLICATION_DETAILS_SETTINGS);
+            intent.addCategory(Intent.CATEGORY_DEFAULT);
+            intent.setData(Uri.parse("package:" + context.getPackageName()));
+        }
+        return intent;
+    }
+}

package/src/ios/NativeSettings.h

@@ -0,0 +1,8 @@
+#import <Cordova/CDV.h>
+
+@interface NativeSettings : CDVPlugin
+
+- (void)open:(CDVInvokedUrlCommand*)command;
+- (void)isAvailable:(CDVInvokedUrlCommand*)command;
+
+@end

package/src/ios/NativeSettings.m

@@ -0,0 +1,199 @@
+#import "NativeSettings.h"
+#import <UIKit/UIKit.h>
+
+@implementation NativeSettings
+
+- (void)open:(CDVInvokedUrlCommand*)command {
+    CDVPluginResult* pluginResult = nil;
+    NSString* setting = [command.arguments objectAtIndex:0];
+    
+    if (!setting) {
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Setting name is required"];
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+        return;
+    }
+    
+    NSURL* url = [self getSettingsURL:setting];
+    if (!url) {
+        pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:@"Invalid setting"];
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+        return;
+    }
+    NSString* urlString = [url absoluteString];
+    NSLog(@"NativeSettings: attempting to open settings URL: %@", urlString);
+    
+    if (@available(iOS 10.0, *)) {
+        [[UIApplication sharedApplication] openURL:url options:@{} completionHandler:^(BOOL success) {
+            CDVPluginResult* result = nil;
+            if (success) {
+                // Return the actual URL that was opened for debugging
+                result = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:urlString];
+            } else {
+                NSString* msg = [NSString stringWithFormat:@"Failed to open settings: %@", urlString];
+                result = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:msg];
+            }
+            [self.commandDelegate sendPluginResult:result callbackId:command.callbackId];
+        }];
+    } else {
+        BOOL success = [[UIApplication sharedApplication] openURL:url];
+        if (success) {
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsString:urlString];
+        } else {
+            NSString* msg = [NSString stringWithFormat:@"Failed to open settings: %@", urlString];
+            pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_ERROR messageAsString:msg];
+        }
+        [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+    }
+}
+
+- (void)isAvailable:(CDVInvokedUrlCommand*)command {
+    NSString* setting = [command.arguments objectAtIndex:0];
+    BOOL isAvailable = NO;
+    
+    if (setting) {
+        NSURL* url = [self getSettingsURL:setting];
+        if (url) {
+            if (@available(iOS 10.0, *)) {
+                isAvailable = [[UIApplication sharedApplication] canOpenURL:url];
+            } else {
+                isAvailable = YES; // Assume available on older iOS versions
+            }
+        }
+    }
+    
+    CDVPluginResult* pluginResult = [CDVPluginResult resultWithStatus:CDVCommandStatus_OK messageAsBool:isAvailable];
+    [self.commandDelegate sendPluginResult:pluginResult callbackId:command.callbackId];
+}
+
+- (NSURL*)getSettingsURL:(NSString*)setting {
+    // iOS settings mappings (App-Prefs:root=...) - many of these URL schemes are unofficial
+    // and may not work on all iOS versions. We fall back to UIApplicationOpenSettingsURLString
+    // (app-specific settings) where appropriate.
+    // Helper to prefer App-Prefs URLs when the system allows them, otherwise fallback
+    // to the official UIApplicationOpenSettingsURLString which opens the app's settings.
+    NSURL* (^prefURLIfAvailable)(NSString*) = ^NSURL*(NSString* urlString) {
+        // On iOS 13+, try to use the official Settings URLs first
+        if (@available(iOS 13.0, *)) {
+                // There's no public UIApplication method `settingsURLString:` — construct the URL
+                // from the provided App-Prefs string and verify it can be opened when possible.
+                NSURL* url = [NSURL URLWithString:urlString];
+                if (@available(iOS 10.0, *)) {
+                    if (![[UIApplication sharedApplication] canOpenURL:url]) {
+                        return nil;
+                    }
+                }
+                return url;
+        }
+        
+        // On older iOS, try App-Prefs scheme
+        NSURL* url = [NSURL URLWithString:urlString];
+        if (@available(iOS 10.0, *)) {
+            // If we can't open App-Prefs URL, return nil to show "not available"
+            // instead of falling back to app settings
+            if (![[UIApplication sharedApplication] canOpenURL:url]) {
+                return nil;
+            }
+        }
+        return url;
+    };
+    if ([setting isEqualToString:@"about"]) {
+        return [NSURL URLWithString:UIApplicationOpenSettingsURLString];
+    }
+    else if ([setting isEqualToString:@"accessibility"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=General&path=ACCESSIBILITY");
+    }
+    else if ([setting isEqualToString:@"account"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=ACCOUNT_SETTINGS");
+    }
+    else if ([setting isEqualToString:@"airplane_mode"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=AIRPLANE_MODE");
+    }
+    else if ([setting isEqualToString:@"autolock"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=General&path=AUTOLOCK");
+    }
+    else if ([setting isEqualToString:@"battery"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=BATTERY_USAGE");
+    }
+    else if ([setting isEqualToString:@"bluetooth"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=Bluetooth");
+    }
+    else if ([setting isEqualToString:@"browser"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=Safari");
+    }
+    else if ([setting isEqualToString:@"cellular"] || [setting isEqualToString:@"cellular_usage"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=MOBILE_DATA_SETTINGS_ID");
+    }
+    else if ([setting isEqualToString:@"date"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=General&path=DATE_AND_TIME");
+    }
+    else if ([setting isEqualToString:@"facetime"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=FACETIME");
+    }
+    else if ([setting isEqualToString:@"keyboard"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=General&path=Keyboard");
+    }
+    else if ([setting isEqualToString:@"language"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=General&path=LANGUAGE_AND_REGION");
+    }
+    else if ([setting isEqualToString:@"location"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=Privacy&path=LOCATION");
+    }
+    else if ([setting isEqualToString:@"music"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=Music");
+    }
+    else if ([setting isEqualToString:@"network"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=General&path=Network");
+    }
+    else if ([setting isEqualToString:@"notification_id"] || [setting isEqualToString:@"notifications"]) {
+        // iOS provides app-specific notification settings via the app settings page
+        return [NSURL URLWithString:UIApplicationOpenSettingsURLString];
+    }
+    else if ([setting isEqualToString:@"phone"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=Phone");
+    }
+    else if ([setting isEqualToString:@"photos"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=Photos");
+    }
+    else if ([setting isEqualToString:@"privacy"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=Privacy");
+    }
+    else if ([setting isEqualToString:@"reset"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=General&path=Reset");
+    }
+    else if ([setting isEqualToString:@"ringtone"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=Sounds&path=Ringtone");
+    }
+    else if ([setting isEqualToString:@"root"]) {
+        return prefURLIfAvailable(@"App-Prefs:root");
+    }
+    else if ([setting isEqualToString:@"safari"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=Safari");
+    }
+    else if ([setting isEqualToString:@"sound"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=Sounds");
+    }
+    else if ([setting isEqualToString:@"software_update"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=General&path=SOFTWARE_UPDATE_LINK");
+    }
+    else if ([setting isEqualToString:@"storage"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=General&path=STORAGE");
+    }
+    else if ([setting isEqualToString:@"vpn"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=General&path=VPN");
+    }
+    else if ([setting isEqualToString:@"wallpaper"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=Wallpaper");
+    }
+    else if ([setting isEqualToString:@"wifi"]) {
+        return prefURLIfAvailable(@"App-Prefs:root=WIFI");
+    }
+    else if ([setting isEqualToString:@"store"]) {
+        // App Store cannot be opened to app-specific settings via App-Prefs; open app settings instead
+        return [NSURL URLWithString:UIApplicationOpenSettingsURLString];
+    }
+    // If nothing matches, return nil to indicate not supported
+    
+    return nil;
+}
+
+@end

package/types/index.d.ts

@@ -0,0 +1,32 @@
+export interface INativeSettingsOptions {
+  setting: string;
+  /**
+   * On Android, open the settings screen in a new task (so it appears as a separate app in Recents)
+   */
+  newTask?: boolean;
+}
+
+export class SettingsManager {
+  /**
+   * Open device settings screen
+   * @param options Settings options or setting string
+   */
+  open(options: INativeSettingsOptions | string): Promise<void>;
+
+  /**
+   * Check if specific settings page is available
+   * @param setting The settings page to check
+   */
+  isAvailable(setting: string): Promise<boolean>;
+}
+
+// For global access
+declare global {
+  const SettingsPlugin: SettingsManager;
+}
+
+// For TypeScript/Angular imports
+declare module 'community-cordova-plugin-native-settings' {
+  export { SettingsManager, INativeSettingsOptions };
+  export default SettingsPlugin;
+}

package/www/settings.js

@@ -0,0 +1,29 @@
+var exec = require('cordova/exec');
+
+class SettingsManager {
+    open(options) {
+        return new Promise((resolve, reject) => {
+            const setting = typeof options === 'string' ? options : options.setting;
+            const newTask = typeof options === 'object' ? !!options.newTask : false;
+            
+            exec(function() {
+                resolve();
+            }, function(error) {
+                reject(error);
+            }, "NativeSettings", "open", [setting, newTask]);
+        });
+    }
+
+    isAvailable(setting) {
+        return new Promise((resolve, reject) => {
+            exec(function(result) {
+                resolve(!!result);
+            }, function(error) {
+                reject(error);
+            }, "NativeSettings", "isAvailable", [setting]);
+        });
+    }
+}
+
+// Create and export a singleton instance as SettingsPlugin
+module.exports = new SettingsManager();