drupal/vote

此包的最新版本（1.0.0-beta1）没有可用的许可证信息。

多功能投票小部件。

维护者

详细信息

git.drupalcode.org/project/vote.git

主页

源代码

问题

安装: 435

依赖: 1

建议: 0

安全: 0

类型：drupal-module

1.0.0-beta1 2024-01-28 15:49 UTC

Requires

  • drupal/votingapi: ^3.0

Unknown License 22af0a48c77bac836d657c70e0ad8c44a8588fae

This package is auto-updated.

Last update: 2024-09-02 08:13:59 UTC

README

目录

  • 简介
  • 需求
  • 安装与配置
  • 故障排除
  • 常见问题解答
  • 维护者

简介

VOTE! 模块是一个基于JS的用户投票插件。任何内容实体，如节点、分类术语、段落、媒体实体、自定义实体等，都可以接收可定制的投票小部件。可以为每个实体类型和捆绑包附加一个或多个单独的投票类型并进行评估。

该模块支持最优的页面和数据缓存，甚至与静态页面缓存（例如Tome）兼容。

使用投票API作为后端，因此从其他投票插件迁移现有投票数据相对容易。还可以根据用户投票对视图中的实体进行排序。

需求

  1. 请检查`/admin/modules`页面以确认以下模块已正确安装并更新到最新版本
    1. VOTE!
    2. 投票API
  2. 检查状态报告`/admin/reports/status`以查找错误消息。
  3. 在“首页 > 管理 > 人员 > 权限”下设置应参与投票的所有用户角色的权限`/admin/people/permissions#module-vote`

安装与配置

  1. 在管理菜单中，转到页面：首页 > 管理 > 配置 > 网络服务 > VOTE! 配置：`/admin/config/services/vote`
  2. 使用字段说明作为指南，通过“添加投票类型”添加新的投票类型。特别注意以下要点
    1. 选择一个投票小部件（例如五星级或是与否）。此设置以后不能更改，特别是如果已经输入了投票数据。
    2. 某些投票小部件提供弃权功能（弃权，空值）（例如是/否/弃权）。如果您已更改“投票小部件”或“允许弃权”字段，请在保存后再次检查您的输入，特别是“选项/标签”字段。可能已进行更改。
    3. 图标家族：在此模块中，图标作为SVG精灵提供。如果您想使用默认的SVG精灵，请留空该字段，但请检查以下图标ID是否包含在默认SVG精灵中。
    4. 保存后，请检查是否在投票API中创建了相应的投票类型：`/admin/structure/vote-types`
  3. 如果您已创建至少一个投票类型，请切换到“设置”选项卡。在此您可以为哪些实体应获取投票字段以及应使用哪些投票类型进行设置。
    1. 例如，为了激活节点类型文章的投票，在“实体到投票类型映射”下的“内容”选项卡中首先激活“内容”复选框。
    2. 然后，在每个节点捆绑包的同一选项卡上会出现一个新字段，您可以输入要用于此节点捆绑包的投票类型。
    3. 可以为每个实体捆绑包输入多个投票类型。
    4. 保存设置。
  4. 现在切换到已分配投票类型的实体捆绑包的视图设置。例如，首页 > 管理 > 结构 > 内容类型 > 文章 > 管理显示
    1. Now a new field "Vote" appears in the field list (as in all view modes of
  the same bundle). Here you can configure for each view mode of the entity
  bundle whether and how the voting widget should be displayed for the
  website users.
2. First check whether the correct formatter is displayed for the "Vote"
   field
  in the "Format" column: "Vote plugin formatter".
3. Open the settings dialog for the bot field by clicking on the settings
   icon
  and choose your display options.
4. If you don't want the vote field to be displayed at all in a view mode,
  move it down the list below Disabled.
  5. 清除缓存一次，查看前端中的投票小部件。- 完成

故障排除

  1. 投票小部件在前端不可见。
    • 检查当前用户的权限。
    • 检查实体捆绑包和每个视图模式的显示配置。
    • 在浏览器开发者工具中检查JavaScript错误。

常见问题解答

  1. 模块会因为用户特定的内容而破坏网站缓存吗？
    • 不，模块通过单独的API调用加载所有单独的投票数据。
  2. 我能否将多个投票类型应用到同一实体上？
    • 是的，您可以。
  3. 我可以自定义布局和样式吗？
    • 您可以通过CSS自定义小部件，但您不能修改小部件内的标记。标记是JSX。

浏览器兼容性

  • Firefox 51+
  • Chrome 54+
  • Safari 14+
  • Opera 38+
  • Edge 78+

链接

维护者

Joachim Feltkamp，德国汉堡