Add LiveObjects setup docs

Author: VeskeR

content/liveobjects/setup.textile

@@ -0,0 +1,97 @@
+---
+title: LiveObjects setup
+meta_description: "Install, authenticate and instantiate the LiveObjects on a channel."
+redirect_from: /docs/liveobjects/setup
+languages:
+  - javascript
+---
+
+blang[javascript].
+  Use these instructions to install the Ably SDK, authenticate, and configure the Objects plugin to start working with LiveObjects.
+
+h2(#authentication). Authentication
+
+An "API key":/docs/auth#api-keys is required to authenticate with Ably. API keys are used either to authenticate directly with Ably using "basic authentication":/docs/auth/basic, or to generate tokens for untrusted clients using "token authentication":/docs/auth/token.
+
+<aside data-type='important'>
+<p>The examples use "basic authentication":/docs/auth/basic to demonstrate features for convenience. In your own applications, basic authentication should never be used on the client-side as it exposes your Ably API key. Instead use "token authentication":/docs/auth/token. </p>
+</aside>
+
+"Sign up":https://ably.com/sign-up to Ably to create an API key in the "dashboard":https://ably.com/dashboard or use the "Control API":/docs/account/control-api to create an API key programmatically.
+
+API keys and tokens have a set of "capabilities":/docs/auth/capabilities assigned to them that specify which operations, such as @subscribe@ or @publish@ can be performed on which resources. To use LiveObjects, the API key requires the following capabilities:
+
+* Publish
+* Subscribe
+
+h2(#install). Install
+
+blang[javascript].
+  LiveObjects is available as part of the Ably Pub/Sub SDK via the dedicated Objects plugin.
+
+blang[javascript].
+  h3(#npm). NPM
+
+  Install the Ably Pub/Sub SDK:
+
+  ```[sh]
+  npm install ably
+  ```
+
+  Import the SDK and the Objects plugin into your project:
+
+  ```[javascript]
+  import * as Ably from 'ably';
+  import Objects from 'ably/objects';
+  ```
+
+blang[javascript].
+  h3(#cdn). CDN
+
+  Reference the Ably Pub/Sub SDK and the Objects plugin within your HTML file:
+
+  ```[html]
+  <script src="https://cdn.ably.com/lib/ably.min-2.js"></script>
+  <script src="https://cdn.ably.com/lib/objects.umd.min-2.js"></script>
+  <script>
+    // Objects plugin is now available on the global object via the `AblyObjectsPlugin` property
+    const Objects = window.AblyObjectsPlugin;
+  </script>
+  ```
+
+h2(#instantiate). Instantiate a client
+
+blang[javascript].
+  Instantiate an Ably Realtime client from Pub/Sub SDK, providing the Objects plugin:
+
+  ```[javascript]
+  const realtimeClient = new Ably.Realtime({ key: '{{API_KEY}}', plugins: { Objects } });
+  ```
+
+blang[javascript].
+  A "@ClientOptions@":/docs/api/realtime-sdk#client-options object may be passed to the Pub/Sub SDK instance to further customize the connection, however at a minimum you must set an API key and provide an Objects plugin so that the client can use LiveObjects functionality.
+
+h2(#create-channel). Create a channel
+
+LiveObjects are managed and persisted on a "realtime channels":/docs/channels, so you need to create a channel first. To use LiveObjects on a channel, you must set the correct "channel mode flags":/docs/channels/options#modes:
+
+* *OBJECT_SUBSCRIBE* - required to retrieve LiveObjects for a channel
+* *OBJECT_PUBLISH* - required to create new and modify existing LiveObjects on a channel
+
+blang[javascript].
+
+  ```[javascript]
+  const channelOptions = { modes: ['OBJECT_SUBSCRIBE', 'OBJECT_PUBLISH'] };
+  const channel = realtimeClient.channels.get('my_objects_channel', channelOptions);
+  ```
+
+h2(#objects). Access Objects on a channel
+
+blang[javascript].
+  LiveObjects can be accessed on realtime channels via the "objects":/docs/api/realtime-sdk/channels#objects property.
+
+blang[javascript].
+
+  ```[javascript]
+  const objects = channel.objects;
+  ```