codeq / googledocs
Neos CMS的Google Docs内容节点类型
v1.0.0
2018-02-06 20:47 UTC
Requires
- google/apiclient: ~1.1
- neos/neos: ^3.0
This package is auto-updated.
Last update: 2024-09-08 07:49:56 UTC
README
Neos CMS的Google Docs内容节点类型。
这是一个概念验证实现,因此还不适用于普通编辑器。要添加Google Docs内容,编辑器需要手动在后台添加Google Docs文件ID(http://prntscr.com/hjdu82)。该文件将以HTML格式渲染。
重要说明
安装
您可以通过composer安装插件。
composer require codeq/googledocs
设置
将此设置应用于您的站点包的Settings.yaml
CodeQ:
GoogleDocs:
authentication:
# Google OAuth 2.0 client secret file
# Place this JSON file in safe location and provide respective path here.
# Path should be respective to the DOCUMENT_ROOT\Web folder
clientSecretFilePath: ~
# This file will be generate automatically for storing the access token temporary
# Please provide safe location with file name
# Path should be respective to the DOCUMENT_ROOT\Web folder
accessTokenFilePath: ~
# Google OAuth 2.0 App name
appName : ~
# Google OAuth 2.0 Redirect URI
redirectUri: ~
启用Google Drive REST API
- 转到Google API控制台。
- 选择一个项目。
- 在左侧侧边栏中,展开API & Auth并选择API。
- 在显示的可用API列表中,单击Drive API链接并单击启用API。
- 在Drive API页面中,选择Drive UI集成选项卡,开始配置您的应用如何与Drive UI集成。
创建凭据
- 转到凭据部分。
- 单击
创建凭据
按钮,并从下拉列表中选择OAuth客户端ID
。 - 从给定选项中选择
Web应用程序
。 - 添加应用的名称(它也将用于设置中的
appName
)。 - 将
<DOMAIN>/neos/administration/googleDocs
添加到授权重定向URI
中(替换为您的实际域名)。此URL还必须放置在设置中的redirectUri
选项中。 授权JavaScript原始地址
可以是空的,因为它未使用。- 保存所有详细信息。它将带您回到仪表板。
- 从OAuth客户端ID部分选择您的条目(https://prnt.sc/hmvbnv)。
- 您将在顶部看到
下载JSON
按钮(https://prnt.sc/hmvc2q)。单击并下载该文件。 - 下载的JSON文件是我们设置中使用的
clientSecretFile
。将该文件放在安全的地方,并在设置中给出相应的路径。
后端模块
后端模块专门用于授权访问Google Docs文件的Google账户。您将在后端模块中找到Google Drive身份验证
。
- 转到模块并单击
授权
按钮。 - 您将重定向到Google同意屏幕。完成授权过程,然后它将带您回到模块(如果
redirectUri
设置不正确,则在尝试授权账户时可能会出现错误)。 - 完成授权后,您将找到
注销
按钮。如果您想注销账户,请单击它。注销将停止文件在前端显示。
使用Google Docs CE
所有上述设置成功后,您将在您的内容集合
中找到新的CE Google Docs
(如果从yaml
配置的文档节点类型
中允许的话)https://prnt.sc/hmvgd2。
将此CE添加到内容集合中,您将找到Google文件ID属性。https://prnt.sc/hmvgsq 您可以从其URL中找到Google文件ID,以下是关于如何查找ID的参考:https://productforums.google.com/forum/#!category-topic/docs/no/3STOEukh1pU。
将Google文档文件ID添加到字段中。页面将自动重新加载,您将以HTML格式找到Google文档的内容。