cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject [04/11] docs commit: Added BlackBerry specific preferences
Date Tue, 02 Feb 2016 21:05:37 GMT
Added BlackBerry specific preferences


Branch: refs/heads/master
Commit: bebc0ef6c91be0a575213cba918a51172b480334
Parents: 72722ff
Author: Omar Mefire <>
Authored: Wed Jan 27 10:52:54 2016 -0800
Committer: Omar Mefire <>
Committed: Tue Feb 2 12:50:33 2016 -0800

 www/docs/en/dev/config_ref/ | 29 +++++++++--------------------
 1 file changed, 9 insertions(+), 20 deletions(-)
diff --git a/www/docs/en/dev/config_ref/ b/www/docs/en/dev/config_ref/
index 9e1fe8e..9604dfc 100644
--- a/www/docs/en/dev/config_ref/
+++ b/www/docs/en/dev/config_ref/
@@ -45,29 +45,10 @@ passively copied into various `platforms/` subdirectories, for example:
-- [BlackBerry 10 Configuration](../guide/platforms/blackberry10/config.html)
 In addition to the various configuration options detailed below, you
 can also configure an application's core set of images for each target
 platform. See [Icons and Splash Screens](images.html) for more information.
-## Core Configuration Elements
-This example shows the default `config.xml` generated by the CLI's
-`create` command, described in [The Command-Line Interface](../guide/cli/index.html):
-        <widget id="com.example.hello" version="0.0.1">
-            <name>HelloWorld</name>
-            <description>
-                A sample Apache Cordova application that responds to the deviceready event.
-            </description>
-            <author email="" href="">
-                Apache Cordova Team
-            </author>
-            <content src="index.html" />
-            <access origin="*" />
-        </widget>
 # widget
    Root element of the config.xml document.
@@ -223,6 +204,10 @@ This example shows the default `config.xml` generated by the CLI's
    DefaultVolumeStream (string) | *Default: default* <br/> **Platforms supported: Android**<br/>
Added in cordova-android 3.7.0, This preference sets which volume the hardware volume buttons
link to. By default this is "call" for phones and "media" for tablets. Set this to "media"
to have your app's volume buttons always change the media volume. Note that when using Cordova's
media plugin, the volume buttons will dynamically change to controlling the media volume when
any Media objects are active.
    OverrideUserAgent (string) | **Platforms supported: Android** <br/> If set, the
value will replace the old UserAgent of webview. It is helpful to identify the request from
app/browser when requesting remote pages. Use with caution, this may causes compitiable issue
with web servers. For most cases, use AppendUserAgent instead.
    AppendUserAgent (string) | **Platforms supported: Android** <br/> If set, the value
will append to the end of old UserAgent of webview. When using with OverrideUserAgent, this
value will be ignored.
+   ChildBrowser (string) | *Default: enable* <br/> **Platforms supported: BlackBerry**
<br/> Disables child browser windows. By default, apps launch a secondary browser window
to display resources accessed via or by specifying a _blank anchor target. Specify
disable to override this default behavior.
+   PopupBlocker (string) | *Default: enable* <br/> **Platforms supported: BlackBerry**
<br/> Enables the popup blocker, which prevents calls to By default,
popups display in a child browser window. Setting the preference to enable prevents it from
displaying at all.
+   WebSecurity (string) | *Default: enable* <br/> **Platforms supported: BlackBerry**
<br/> Set to disable to override web security settings, allowing access to remote content
from unknown sources. This preference is intended as a development convenience only, so remove
it before packaging the app for distribution. For the released app, all URIs should be known
and whitelisted using the <access> element, described in the Domain Whitelist Guide.
@@ -267,7 +252,11 @@ This example shows the default `config.xml` generated by the CLI's
     <preference name="DefaultVolumeStream" value="call" />
     <preference name="OverrideUserAgent" value="Mozilla/5.0 My Browser" />
     <preference name="AppendUserAgent" value="My Browser" />
+    <!-- BlackBerry only preferences -->
+    <preference name="ChildBrowser" value="disable"/>
+    <preference name="PopupBlocker" value="enable"/>
+    <preference name="WebSecurity" value="disable"/>
 ## feature
    If you use the CLI to build applications, you use the plugin command to enable device
APIs. This does not modify the top-level config.xml file, so the <feature> element does
not apply to your workflow. If you work directly in an SDK and using the platform-specific
config.xml file as source, you use the <feature> tag to enable device-level APIs and
external plugins. They often appear with custom values in platform-specific config.xml files.
See the API Reference for details on how to specify each feature. See

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message