Tiny Cloud 是集成 TinyMCE 并升级至高级插件的最简单方式。

Tiny Cloud 无需 API 密钥即可使用。注册一个 API 密钥并更新脚本标签以使用高级插件,或避免编辑器中的开发者警告。

所有 Tiny Cloud 账户均包含免费且预配置的 Tiny Cloud 图像代理服务。此设置使用 图像编辑 插件。

首次集成 TinyMCE

步骤 1:将 Tiny Cloud 脚本标签插入网页

将 TinyMCE 编辑器代码插入应用程序以首次加载 TinyMCE。插入代码的操作是通过在您的应用中添加以下脚本标签完成,对于网页而言,则添加到页面的 <head> 中:

以下示例向应用中添加了一个脚本标签以插入代码。在网页上请使用页面的 <head>。务必将 'no-api-key' 替换为您的 API 密钥。

<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/8/tinymce.min.js" referrerpolicy="origin" crossorigin="anonymous"></script>
值描述

1

no-api-key

替换为您的 API 密钥

2

origin

referrerpolicy 指定当浏览器获取页面资源(例如 TinyMCE 编辑器)时,当前页面的 URL 有多少会被发送到 Referer 头中。使用 Referer 头可确保 API 密钥仅用于其所有者注册的域名。不过我们只关心域名部分(类似于 Origin 头的操作),因此为了提升性能和隐私,在请求 Tiny Cloud 资源时始终将 referrerpolicy 设置为 origin。

3

anonymous

crossorigin="anonymous" 属性必须存在于所有从 Tiny Cloud 加载 TinyMCE 的脚本标签上。此属性可确保跨域脚本加载时许可证密钥验证的 Origin 头行为一致,并提升安全性。

脚本标签说明

Tiny Cloud 通过网络请求中的 Referer 头来验证 TinyMCE 加载的域名。有时 Referer 头中的域名与浏览器地址栏中的 URL 不匹配。

要检查 Referer 头,请打开浏览器的 开发者工具 并进入 网络 选项卡。在那里,找到使用您的 API 密钥加载 TinyMCE 的请求,然后点击 标头 选项卡。在名为 请求标头 的部分中,应该有一个 Referer 字段。如果该处的值与您注册的 URL 之一不同,您可能需要调整已注册的 URL 或应用的 Refer 头设置。

步骤 2:加载、自定义并与 TinyMCE 交互

除了 Tiny Cloud 上的高级内容创建解决方案外,还有 29 个开源插件可增强编辑体验。您可以参考一系列 简单示例。有关更多信息,请参阅 快速入门 部分。

步骤 3:指定购买的 TinyMCE 插件和工具栏/菜单项

购买的插件可能需要最多 30 分钟才能在 TinyMCE 中可用。请清除浏览器缓存。

扩展 TinyMCE 配置 以包含任何额外的购买插件及相关工具栏和菜单项。有关每个插件的启用指南,请参阅 高级插件。

使用 Tiny Cloud 时,以下选项的配置会自动进行:

  • editimage_cors_hosts

  • editimage_proxy_service_url

  • export_image_cors_hosts

  • export_image_proxy_service_url

  • linkchecker_service_url

  • mediaembed_service_url

  • spellchecker_rpc_url

  • autocorrect_service_url

步骤 4:转发代理和防火墙配置

如果网络具有控制互联网访问的防火墙或转发代理,请确保可以访问以下 URL:

  • 部署编辑器的所有 URL。

  • 部署插件的所有 URL。

  • *.tiny.cloud — 涵盖所有 Tiny Cloud 服务,包括图像代理、链接检查器、拼写检查器、AI API 和文档转换器。

在请求上述 URL 时,请确保保留 tiny-api-key 和 tinymce-api-key 标头。

有关完整的 Tiny Cloud 服务域名和所需标头列表,请参阅 防火墙和代理白名单。

步骤 5:指定翻译

要使用语言包更改用户界面语言,请使用 语言配置选项。

或者,使用 language_url 配置选项 指定其位置。

从自托管环境迁移到 Tiny Cloud

步骤 1:替换对 tinymce.min.js 的现有引用

从自托管环境迁移到 Tiny Cloud 很简单。删除加载 TinyMCE JavaScript 的现有脚本标签。

脚本标签通常引用托管在应用内或可通过旧版 CDN 获取的 tinymce.min.js。

用以下内容替换脚本标签,并确保包含两个必需属性(referrerpolicy 和 crossorigin):

<script src="https://cdn.tiny.cloud/1/no-api-key/tinymce/8/tinymce.min.js" referrerpolicy="origin" crossorigin="anonymous"></script>
迁移到 Tiny Cloud 时,为了实现最佳性能和跨浏览器功能,必须同时使用 referrerpolicy="origin" 和 crossorigin="anonymous" 属性。

步骤 2:更新自定义插件路径

引用 external_plugins 以确保自定义插件或修改后的插件继续在 Tiny Cloud 部署中运行。

请勿使用常规的 plugins 配置元素。

步骤 3:指定购买的 TinyMCE 插件和工具栏按钮

扩展 TinyMCE 配置 以包含任何额外的购买插件及相关工具栏和菜单项。有关每个插件的启用指南,请参阅 高级插件。

使用 Tiny Cloud 时,以下选项的配置会自动进行:

  • editimage_cors_hosts

  • editimage_proxy_service_url

  • export_image_cors_hosts

  • export_image_proxy_service_url

  • linkchecker_service_url

  • mediaembed_service_url

  • spellchecker_rpc_url

  • autocorrect_service_url