← All posts

Pusher Setup for the Collaboration Plugin in Oxygen Builder

Many people find the Pusher documentation hard to follow, so the Collaboration setup can look harder than it is. This short video covers the whole Pusher setup for the Collaboration plugin in Oxygen Builder, from activating the plugin to saving your keys. It takes a few minutes, and after that multi-user and multi-tab editing works in the Oxygen editor.

Plugin installation

Collaboration needs our Aether framework, and you don't have to install it yourself.

  1. Upload dPlugins Collaboration under Plugins and click Activate.
  2. Wait a few seconds. The plugin downloads, installs and activates the Aether framework for you.
  3. Open Aether → Collaboration in the WordPress admin menu.

The settings page shows a notice that the Pusher API credentials have not been configured yet. The next step fixes that.

Collaboration setup

Collaboration uses Pusher to sync changes in real time, so you need a Pusher app. Creating one is free.

  1. Go to Pusher.com and sign in or sign up. In the video we sign in with a GitHub account.
  2. Open Channels and click Create app.
  3. Give the app a name. We used "tutorial collaboration setup".
  4. Under cluster, pick the region closest to you. We chose eu (EU (Ireland)).
  5. Click Create app. The keys for the app are on the App Keys page.
  6. Before you copy anything, open App Settings and turn on Enable client events. This is the setting people most often miss. Save it.

Next, go back to WordPress and fill in the Settings tab under Aether → Collaboration:

  • Pusher APP ID
  • Pusher APP Key
  • Pusher APP Secret
  • Pusher APP Cluster

Copy each value from the Pusher App Keys page and click Save Changes. Then open the License tab, paste your license key and save again. That finishes the setup.

Get Collaboration → dplugins.com