教程：开始使用 CranSurvey

[ocoke]

什么是 CranSurvey？

是新坑！！

它也是：

开源表单和调查收集器，无服务器部署的营销工具。使用功能强大的小组件、插件将其添加到您的网站。

它有这些特性：

• 自行部署：CranSurvey 允许您在自己的服务器上托管调查。
• 品牌：您可以通过 CranSurvey 完全自定义调查的品牌，以匹配您的网站或组织。您还可以将其添加到您的网站以与您的用户保持联系。
• 开源：CranSurvey 是开源的，基于 MIT 许可证，允许广泛的定制和修改。
• 自定义分析：借助 CranSurvey，您可以灵活地设计和实施针对您的特定网站目标量身定制的自定义分析。这样可以对访客行为和偏好进行更有针对性和更有意义的分析。
• 集成灵活性：CranSurvey 在与其他系统和服务集成方面提供了更大的灵活性。使用 Webhooks 或其他方式进行连接。

也就是说，这是一个无服务器部署的开源表单工具。还可以直接使用小组件和提示窗的方式加入到网站上（那是以后的事

正巧刚刚 CranSurvey 发布了 v1.0.0-beta 版本，那让我们试试吧。

一键部署！

首先是官方文档：https://csur.proj.sbs/

我这里用最简单的部署方法，就是一键部署。文档中说明 Vercel, Netlify 等平台都可以一键完成部署：

同时，我们还需要配置两个跟数据有关的环境变量：

我这里使用的是，Vercel 最近发布的，基于 Redis 的边缘数据库 Vercel KV。

我们可以前往 Vercel KV 的控制台，将基本的 API 信息复制下来：

随后根据 Unstorage 的文档，我们得到：

db_name=vercel-kv
db_config={"url": ""https://<your-project-slug>.kv.vercel-storage.com", "token": "<your secret token>", "base": "test"}

然后将这些信息复制到 Vercel（或者是其它平台）的环境变量处，然后点击下一步进行部署。

开始使用

打开部署好的网址，我们会看到这样一个欢迎界面，我们点击 Goto Dashboard。

第一次进入我们需要创建一个账号，我们输入用户名和密码进行注册：

注册完毕后就会自动进入仪表盘，我们可以将语言切换为「简体中文」：

然后点击侧边栏中的「设置」进入设置页面：

此处我们可以设置站点的标题和 URL，但我们需要先将站点的注册功能关闭。

修改后不要忘记点击页面底部的「更新」。

创建调查

回到侧边栏点击「调查」，点击页面中的「新调查」创建调查。

首先，我们需要输入表单的标题和简介。然后需要选择类型。根据文档：

• Simple：简单调查仅包含一个问题，如果您想将其添加到您的网站，用户不需要打开另一个提示窗口来回答您的问题。
• Advanced：您可以在此处添加多个问题并通过链接轻松分享。如果您想将其添加到您的网站，用户仍然会停留在页面上，但会有一个提示窗口供用户回答。
• Prompt：没有任何问题，页面仅包含一段文字。

选择好类型后我们需要添加问题。

根据文档，有以下选项：

• 问题：这是问题的标题。
• 提示：这是您问题的描述。
• 类型：有多种题型，根据您的需求选择。（简答题、段落、单项选择、复选框、下拉菜单、文件和日期）。
• 答案验证：不同类型的问题有不同的规则和选项。
• 占位符：文本框的占位符。

如果您使用高级调查，则需要单击「新增」按钮将其添加到问题列表中。

添加完毕后我们可以发现，问题已经被成功添加到了列表中。

适当添加完问题后，我们可以点击最底部的「创建」新建这个调查。随后，我们可以回到刚刚的页面查看。

分享调查

首先，在调查列表中找到你需要分享的调查。你可以通过搜索（标题/ID/简介）的方式进行查找：

然后点击列表中的「视图」（其实应该是 View，机翻），打开操作菜单。

这里你可以编辑/删除/分享/查看调查结果。

进入分享页面，我们可以直接复制表单的页面链接。也可以生成二维码。

页面中还提供了由 Proj.sbs 提供的短网址服务（需要完成一个人机验证。

查看调查结果

同样在调查列表的操作菜单中，点击「结果」。

进入后，可以看到用户 ID（随机生成/存储在 localStorage），日期，答案，国家和城市。

你也可以针对这些项目进行搜索。

另外，答案表格中的问题和答案为了显示会被自动截取，点击内容可以显示详情：

更改密码

前往侧边栏「用户」页，你可以看到站点上的所有用户。你可以更改您自己的密码。

点击「编辑」，输入原密码后即可进行更改。

以上就是一些关于 CranSurvey 的基础教程，更多信息和文档还会更新：）

大佬们欢迎去 GitHub: ocoke/CranSurvey 给个 Star ⭐ （谢谢。