You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by sh...@apache.org on 2012/11/28 22:46:06 UTC

docs commit: [CB-1939] Update iOS Project Settings for new config.xml

Updated Branches:
  refs/heads/master 01200c642 -> df1820bfb


[CB-1939] Update iOS Project Settings for new config.xml


Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/df1820bf
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/df1820bf
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/df1820bf

Branch: refs/heads/master
Commit: df1820bfb32d7e3c51f018121d28e933c92149f9
Parents: 01200c6
Author: Shazron Abdullah <sh...@apache.org>
Authored: Wed Nov 28 13:45:48 2012 -0800
Committer: Shazron Abdullah <sh...@apache.org>
Committed: Wed Nov 28 13:45:48 2012 -0800

----------------------------------------------------------------------
 docs/en/edge/guide/project-settings/ios/index.md |   36 ++++++++++------
 1 files changed, 22 insertions(+), 14 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/df1820bf/docs/en/edge/guide/project-settings/ios/index.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/guide/project-settings/ios/index.md b/docs/en/edge/guide/project-settings/ios/index.md
index 77a6303..c374f2f 100644
--- a/docs/en/edge/guide/project-settings/ios/index.md
+++ b/docs/en/edge/guide/project-settings/ios/index.md
@@ -22,32 +22,40 @@
 Project Settings for iOS
 ========================
 
-The **Cordova.plist settings file** controls various settings of Cordova. This is application wide, and not set per CDVViewController instance.
+The **config.xml settings file** controls various settings of Cordova. This is application wide, and not set per CDVViewController instance. An example:
 
-1. A list of **Plugins** allowed to be used in a CDVViewController (set in the Plugins dictionary - key is the servicename used in JavaScript, and the value is the Objective-C class for the plugin that is a CDVPlugin sub-class)
-2. A **white-list** of hosts (with no scheme nor path, hostnames or IP addresses only) that Cordova is allowed to connect to (set in the ExternalHosts array - wildcards allowed)
-3. Various **other** settings (defaults err on not breaking existing apps)
+        <cordova>
+            <preference name="MySetting" value="true" />
+            <plugins>
+                <plugin name="MyPlugin" value="MyPluginClass" />
+            </plugins>
+            <access origin="*" />
+        </cordova>
 
-	a. **UIWebViewBounce (boolean, defaults to YES)** - set to NO if you don't want the WebView to rubber-band
+1. A list of **plugins** (plugin tags under **&lt;cordova&gt;/&lt;plugins&gt;**) allowed to be used in a CDVViewController (set in the Plugins dictionary - name is the servicename used in JavaScript, and the value is the Objective-C class for the plugin that is a CDVPlugin sub-class)
+2. A **white-list** of hosts that Cordova is allowed to connect to (add an **&lt;access&gt;** tag, and set the origin attribute - wildcards allowed)
+3. Various **other** preferences (as **&lt;preference&gt;** tags) defaults err on not breaking existing apps)
+
+	a. **UIWebViewBounce (boolean, defaults to true)** - set to false if you don't want the WebView to rubber-band
 
 	b. **TopActivityIndicator (string, defaults to 'gray')** - this is the top spinning throbber in the status/battery bar, valid values are "whiteLarge", "white" and "gray"
 
-	c. **EnableLocation (boolean, defaults to NO)** - set to YES, to initialize the Geolocation plugin at start-up (so the fix on your location can be more accurate)
+	c. **EnableLocation (boolean, defaults to false)** - set to true, to initialize the Geolocation plugin at start-up (so the fix on your location can be more accurate)
 
-	d. **EnableViewportScale (boolean, defaults to NO)** - set to YES to prevent viewport scaling through a meta tag
+	d. **EnableViewportScale (boolean, defaults to false)** - set to true to prevent viewport scaling through a meta tag
 
-	e. **AutoHideSplashScreen (boolean, defaults to YES)** - set to NO to control when the splashscreen is hidden through a JavaScript API
+	e. **AutoHideSplashScreen (boolean, defaults to true)** - set to false to control when the splashscreen is hidden through a JavaScript API
 
-	f. **ShowSplashScreenSpinner (boolean, defaults to YES)** - set to NO to hide the splash-screen spinner
+	f. **ShowSplashScreenSpinner (boolean, defaults to true)** - set to false to hide the splash-screen spinner
 
-	g. **MediaPlaybackRequiresUserAction (boolean, defaults to NO)** - set to YES to not allow autoplayed HTML5 video
+	g. **MediaPlaybackRequiresUserAction (boolean, defaults to false)** - set to true to not allow autoplayed HTML5 video
 
-	h. **AllowInlineMediaPlayback (boolean, defaults to NO)** - set to YES to allow inline HTML5 media playback, also, the video element in the HTML document must also include the webkit-playsinline attribute
+	h. **AllowInlineMediaPlayback (boolean, defaults to false)** - set to true to allow inline HTML5 media playback, also, the video element in the HTML document must also include the webkit-playsinline attribute
 
-	i. **OpenAllWhitelistURLsInWebView (boolean, defaults to NO)** - set to YES to open all white-listed URLs in the main WebView
+	i. **OpenAllWhitelistURLsInWebView (boolean, defaults to false)** - set to true to open all white-listed URLs in the main WebView
 
 	j. **BackupWebStorage (string, defaults to 'cloud')** - valid values are 'none', 'cloud' and 'local'. Set to 'cloud' to allow the web storage data to be backed up to iCloud, and set to 'local' to only allow local backups (iTunes sync). Set to 'none' to not allow any backups of web storage.
 	
-	k. **KeyboardDisplayRequiresUserAction (boolean, defaults to YES)** - set to NO to open the keyboard when form elements get focus via the JavaScript focus() call.
+	k. **KeyboardDisplayRequiresUserAction (boolean, defaults to true)** - set to false to open the keyboard when form elements get focus via the JavaScript focus() call.
 
-	l. **SuppressesIncrementalRendering (boolean, defaults to NO)** - set to YES to wait until all new view content has been received before it is rendered.
+	l. **SuppressesIncrementalRendering (boolean, defaults to false)** - set to true to wait until all new view content has been received before it is rendered.