Browse Source

blog: fill in providers section

Renée Kooi 5 years ago
parent
commit
8061f49d9e
1 changed files with 39 additions and 0 deletions
  1. 39 0
      website/src/_posts/2019-10-1.5.md

+ 39 - 0
website/src/_posts/2019-10-1.5.md

@@ -67,6 +67,45 @@ New translations are rolling in every month, but there are plenty more languages
 
 ## Facebook and OneDrive
 
+This release adds two experimental new remote providers: Facebook and OneDrive. For now, they are not available through the `uppy` package. To use them, install `@uppy/facebook` or `@uppy/onedrive`:
+```bash
+npm install @uppy/facebook
+npm install @uppy/onedrive
+```
+
+Configure Companion to access the Facebook and OneDrive APIs, using environment variables or the JS API:
+```bash
+export COMPANION_FACEBOOK_KEY="***"
+export COMPANION_FACEBOOK_SECRET="***"
+export COMPANION_ONEDRIVE_KEY="***"
+export COMPANION_ONEDRIVE_SECRET="***"
+```
+```js
+providerOptions: {
+  facebook: {
+    key: '',
+    secret: ''
+  },
+  // For OneDrive, use the `microsoft` auth key.
+  microsoft: {
+    key: '',
+    secret: ''
+  }
+}
+```
+
+Then use them like the existing providers:
+```js
+const Facebook = require('@uppy/facebook')
+const OneDrive = require('@uppy/onedrive')
+uppy.use(Facebook, { companionUrl: YOUR_COMPANION_URL })
+uppy.use(OneDrive, { companionUrl: YOUR_COMPANION_URL })
+```
+
+We're still waiting for our developer keys to be approved, so we don't have working examples on the website yet! We'll let you know on [Twitter](https://twitter.com/uppy_io) when they're live.
+
+Once these new providers been tested for a while, we'll release them as 1.0 and include them in the main Uppy and Robodog bundles.
+
 ## Misc
 
 * Fill this in