README

Craft 3.2 发布了 "无头预览"，这实际上取代了此插件。无头预览比此插件更强大，并且也使其不再像草稿条目现在是动态的（例如，使用 JavaScript 更新 UI）那样工作，这意味着我们的纯服务器端渲染按钮将不再链接到正确的位置。我们的建议是禁用此插件并修改您的 API 调用来通过 Craft 预览令牌（它们 Just Work™）传递到您的 API - 这里有一个很好的指南：https://nystudio107.com/blog/headless-preview-in-craft-cms

Craft CMS 3.x 的预览按钮插件

在条目编辑屏幕中添加预览按钮，以便预览草稿/修订条目

要求

此插件需要 Craft CMS 3.0.0-beta.23 或更高版本。

安装

要安装此插件，请按照以下说明操作。

打开您的终端并转到您的 Craft 项目
```
 cd /path/to/project
```

然后告诉 Composer 加载此插件

 composer require biglotteryfund/preview-button

在控制面板中，转到设置 → 插件，并单击“预览按钮”的“安装”按钮。

预览按钮概述

使用 Element API 的网站，如果它们不使用模板，则可能无法从 Craft 的预览功能中受益。此插件将按钮添加到条目编辑屏幕，该按钮链接到一个带有 ?draft=$id 或 ?version=$id 参数的预览 URL，以便您的后端可以从正确的位置查找内容。

您负责编写后端代码以获取这些修订/草稿，但此插件应允许您从编辑屏幕直接预览内容。

配置预览按钮

有三个设置

1. URL 基础

这将替换条目的 URI 中的 siteUrl（例如，您可能希望在主站点的子域或子文件夹上提供预览内容）。

2. 版本 URL 参数（可选）

这将附加到预览 URI，并带有版本的 ID，例如 ?version=$id。

3. 草稿 URL 参数（可选）

这将附加到预览 URI，并带有草稿的 ID，例如 ?draft=$id。

使用预览按钮

安装插件，配置 URL 基础作为最低要求，然后在草稿/修订模式下编辑条目。您应该在条目字段下方看到一个按钮

预览按钮路线图

可能支持更高级的 URL 构造，并配置哪些条目类型或用户角色可以看到预览按钮。

由 Big Lottery Fund 提供

biglotteryfund / preview-button

维护者

详细信息