Getting started with RTC

Important: The RTC plugin is currently in Open Beta. To learn about our pre-release commitment, please read our software licence agreement.

Prerequisites

• A Tiny Cloud API key from Tiny Account.
• A JSON Web Token (JWT) key generated at https://apps.tiny.cloud/my-account. Temporarily store the generated keys for use in the following procedure.
• A secure context for your web server. RTC makes use of SubtleCrypto which is only available in secure contexts.

Basic RTC setup

The following example assumes you are familiar with integrating TinyMCE; if you are new TinyMCE user please follow the basic setup guide first.

This example shows how to get the RTC plugin up and running using hardcoded values. For a production setup, the document ID and secret would be retrieved from your server. This example also assumes that a JWT provider endpoint exists at ‘/jwt’. For information on setting up a JWT endpoint, see: JWT authentication.

tinymce.init({
  selector: 'textarea', // change this value according to your HTML
  plugins: 'rtc',
  rtc_document_id: 'unique-document-id',
  rtc_encryption_provider: () => Promise.resolve({ key: 'a secret key' }),
  rtc_token_provider: () =>
    fetch('/jwt', {
      method: 'POST'
    })
    .then(response => response.json()),
  rtc_snapshot: ({version, html}) => console.log(version, html)
})

Additional resources

The following resources provide additional information on setting up the RTC plugin for TinyMCE.

• For information on JSON Web Tokens (JWT) and setting up JWT authentication for the RTC plugin, see: JWT authentication.
• For details on the available configuration options, see: Configuration Options.

Need help?

Tiny is striving to make RTC as useful and simple as possible. For support related issues, such as problems with JWT authentication and implementing RTC, contact Tiny Support.

Can't find what you're looking for? Let us know.

Except as otherwise noted, the content of this page is licensed under the Creative Commons BY-NC-SA 3.0 License, and code samples are licensed under the Apache 2.0 License.