symboiote/silverstripe-interactives

实现跟踪交互元素的简单机制

安装: 4,517

依赖项: 0

建议者: 0

安全性: 0

星标: 3

关注者: 1

分支: 7

开放问题: 2

类型:silverstripe-vendormodule

5.7.0 2021-08-22 01:19 UTC

README

一个简单的模块,用于管理页面上的动态交互元素(包括广告)。

维护者联系方式

Marcus Nyeholt

<marcus (at) symbiote (dot) com (dot) au>

要求

SilverStripe 4.x

查看1.x分支以获取与SilverStripe 3兼容的代码

文档

添加

PageController:
  extensions:
    - Symbiote\Interactives\Extension\InteractiveControllerExtension

到您的项目配置yml文件中。

注意,交互式元素是按层次继承的,因此如果设置网站配置中的广告,除非为特定内容树指定,否则这些广告将用于所有页面。

  • 导航到“交互式”部分
  • 创建一个交互式活动
  • 配置活动 - “使用项目作为”指的是基于以下内容显示项目的方式
    • 总是随机 - 每次显示活动时,都会随机选择一个项目
    • 粘性随机 - 第一次显示活动时,会随机选择一个项目,并在随后的加载中始终向该用户显示
    • 全部 - 返回并显示所有项目(例如,多项目广告列表)
  • 对于活动网站选项,您可以选择在网站的全部范围内显示、在特定页面上显示或选择整个网站并排除特定URL
  • 在顶层配置完成后,添加交互式项目本身。

交互式

单个交互式有一些显示选项。

  • 自动生成的链接(不要在“HTML内容”文本区域中输入任何内容)。如果交互式附加了图像,则此图像将被链接,否则将链接标题字段中的文本
  • 自定义输入的HTML(在HTML内容字段中提供)
  • 绑定到现有DOM节点(仅当“在/靠近元素位置”设置为“现有内容”时适用)

交互式的目标URL可以是完全限定的链接,或内部页面对象

  • 相对元素是用于插入交互的jQuery选择器;“在”选项提供了相对于该元素的相对定位
  • 显示频率允许仅向用户子集显示(例如,要向20%的人显示,将此值设置为5)
  • “完成元素”是另一个jQuery选择器,指示目标页面上的元素,如果单击该元素,将触发给定交互的“完成”事件。这里的用例是一个指向用户定义的表单页面的交互式,通过将其设置为表单提交按钮(例如 #UserForm_Form_action_process),将跟踪表单的提交
  • 如果填写了HTML内容,则用作交互式的内容。

元素

要使用元素作为内容源,请将以下内容添加到您的项目配置中

Symbiote\Interactives\Model\Interactive:
  extensions:
    - Symbiote\Interactives\Extension\InteractiveElementalExtension