oveleon/contao-recommendation-bundle

Contao开源CMS的推荐集成

资助包维护!
oveleon

安装次数: 4,258

依赖项: 2

建议者: 0

安全性: 0

星星: 10

关注者: 4

分支: 2

公开问题: 0

类型:contao-bundle

1.6.0 2024-08-02 11:44 UTC

README

contao推荐包为Contao 4添加了推荐功能。

Oveleon

支持

如果您喜欢这个扩展,我们希望您支持我们保持开源精神。

如果您认为这个插件很有用,请考虑赞助我们,以帮助我们贡献时间和进一步开发此和其他开源项目。

您的贡献,无论是通过编码测试提供反馈,甚至捐赠,都有助于确保我们可以继续提供免费的开源软件。加入我们,共同创造不同,感谢您的支持! - Oveleon

Contao 4.13Contao 5.3+(PHP ^8.1)兼容

描述

此插件添加了一个新的子菜单推荐,包含推荐存档和推荐

功能

  • 与Contao 4.13及更高版本兼容(PHP 8支持)
  • 创建多个推荐存档的可能性
  • 创建推荐项目的可能性
  • 存档和项目的前端和后端权限
  • 模块的访问保护
  • 用于显示推荐项目的推荐列表
    • 从多个存档中选择要显示的存档
    • 按评分筛选
    • 分页
    • 特色推荐(用于排序)
    • 等等
  • 用于推荐的推荐阅读器
  • 用于让用户将推荐提交到特定存档的推荐表单
    • 选择用户可以提交的内容
    • 当人们提交推荐时获取电子邮件通知
    • 审核设置
    • 添加隐私复选框的可能性
    • 激活电子邮件验证(opt-in)以验证推荐的可能性
  • 不记录IP
  • 网站地图集成
    • 推荐将被添加到sitemap.xml中
  • 自动清除未验证的推荐
  • 缓存失效

安装

通过composer

composer require oveleon/contao-recommendation-bundle

通过contao-manager

Search for contao recommendation bundle and add it to your extensions.

在安装contao-recommendation-bundle后,您需要运行一个contao install

初始设置

推荐包接近contao cms的核心包。如果您熟悉使用新闻或事件包,您应该能够在不进一步了解的情况下设置它。

  1. 推荐中创建一个新的存档

    Admin View: Recommendation Archive

  2. 在您的存档中创建一个新的推荐并填写

    • 作者
    • 日期和时间自动设置,但可以更改
    • 推荐文本
    • 选择一个评分(1到5)
    • 发布推荐

    Admin View: Recommendation

  3. 要显示您的推荐,您需要一个推荐列表。

    1. 创建前端模块recommendation-list
    2. 选择您的推荐存档/
    3. 选择您想在前端显示的元字段
    4. 在页面中嵌入模块

    Admin View: Recommendation List

  4. 设置推荐评分的颜色

    • 您可以在“推荐”中的“设置”内(存档位置)选择活动星星的颜色

    Admin View: Recommendation Archive Settings

  5. 设置推荐别名

    • 在推荐设置中,您可以在没有给定标题时更新别名的默认前缀

    Admin View: Recommendation Reader

  6. 为重定向页面设置推荐阅读器

    1. 创建前端模块 推荐阅读器
    2. 选择您的推荐存档/
    3. 选择您想在前端显示的元字段
    4. 将模块嵌入页面或为您的推荐列表设置
    5. 在您的推荐存档中设置重定向页面

    Admin View: Recommendation Reader

您网站上的推荐列表 管理视图:推荐前端

前端模块

推荐列表

推荐列表可以显示选定存档中发布的(和验证过的)推荐。

设置

推荐阅读器

推荐列表可以显示选定存档中发布的(和验证过的)推荐。

设置

推荐表单

推荐表单可以用来让您的访客在您的网站上提交推荐。这些推荐将被保存在预配置的存档中。

设置

网站地图

未受保护且有跳转页面的推荐存档将它们发布的推荐添加到您的 sitemap.xml。建议为您的推荐设置标题,因为它们将被用来创建别名。如果您不希望某些推荐显示在您的网站地图中,您可以取消发布它们。

验证推荐/GDPR

当在推荐表单中添加隐私文本时,它将创建一个必须接受的复选框,访客必须接受才能提交表单。

在后台创建的推荐默认是经过验证的。您有在推荐表单中设置激活邮件的可能性,这将发送给访客。提交的推荐将不会在任何列表中显示,也不能由管理员验证。cronjob将在24小时后清除未经验证的推荐。

Admin View: Unverified Recommendations

推荐表单不会保存用户的IP。然而,如果用户使用opt-in令牌验证了他们的推荐,它将保存用户的电子邮件地址。

错误和功能请求

我们感谢您在打开问题或请求功能时的贡献。为了帮助保持我们的问题列表整洁,如果问题没有回答,我们可能需要关闭问题。

错误

如果您认为您发现了一个错误,请遵循以下指南

  1. 搜索现有的问题,并检查您的问题是否已经被报告
  2. 检查您是否使用的是最新版本,并且问题是否已经得到修复
  3. 提供使用仅此包和contao管理版在隔离环境中逐步重现问题的教程

功能请求

欢迎功能请求。但请花点时间了解您的想法是否符合项目的范围和目标。您需要说服项目的开发者这个功能的优点。请尽可能提供详细和背景信息。

示例

如何为您的网站上的评论设置样式的示例

Admin View: Recommendation Exammple