WooCommerce Real-Time Product Viewer 文档
概述
这 WooCommerce 实时产品查看器 插件显示当前实时查看特定产品的用户数。它使用 AJAX 请求提供实时更新，并将查看次数存储在 JSON 文件中。
特征：
- 显示当前在单个产品页面和产品列表（商店）页面上查看产品的用户数。
- 支持字体颜色、对齐方式和字体系列的自定义 CSS 设置。
- 为动态显示视图计数提供短代码支持。
- 包括用于管理插件配置的管理员设置页面。
安装指南
第 1 步：下载插件
- 将插件文件下载或克隆到您的 WooCommerce 站点中，位于
/wp-content/plugins/目录。
第 2 步：上传插件
- 上传
product-viewer目录复制到/wp-content/plugins/目录下或通过 WordPress Admin 的插件上传功能。
第 3 步：激活插件
- 登录到您的 WordPress 管理员仪表板。
- 导航到 插件 > 已安装的插件.
- 找到 WooCommerce 实时产品查看器 ，然后单击激活.
第 4 步：配置插件
- 转到 设置 > Product Viewer 设置 调整显示设置，例如启用/禁用单个产品和商店页面上的查看计数，以及自定义 CSS 属性。
使用说明
在产品页面上显示查看次数
- 如果在设置中启用，该插件会自动显示当前在产品详细信息页面上查看产品的用户数。
- 对于产品循环（例如，商店页面），查看次数也可以以紧凑的格式显示在每个产品的下方。
简短代码：
要在自定义页面或模板上显示实时查看计数，请使用以下短代码：
[rt_product_viewer id=<span class="hljs-string">"PRODUCT_ID"</span>]
如果没有 id 属性，则短代码将尝试检测当前产品 ID。
WooCommerce Admin 中的自定义列：
- 该插件在 WooCommerce 产品列表中添加了一个标有“正在查看”的自定义列，显示当前有多少用户正在查看每个产品。
开发人员指南
该插件的设计同时考虑了易用性和定制性。它使用标准的 WordPress 钩子、AJAX 请求和 JSON 数据存储。以下是开发人员需要注意的一些重要方面：
JavaScript （rt-product-viewer.js）
- JavaScript 文件在页面加载时初始化并尝试检测产品 ID。
- 它每 5 秒发送一次定期 AJAX 请求，以更新产品页面上显示的查看次数。
- 它还会发送一个
beforeunload事件，以更新用户不再查看产品的服务器。
主要功能：
- updateProductViewCount：发送 AJAX 请求以检索产品的当前查看者数量。
- beforeunload：检测用户何时离开页面并相应地更新查看计数。
菲律宾语 （woocommerce-real-time-viewer.php）
- 该插件注册自定义 AJAX作 （
rt_update_product_view_count和rt_leave_product_view） 更新和管理产品查看计数。 - 产品查看计数存储在 JSON 文件 （
view_counts.json） 并根据用户会话进行更新。
重要功能：
- rt_update_product_view_count：处理更新产品查看次数的 AJAX 请求。
- rt_leave_product_view：在用户离开产品页面时处理 AJAX 请求，从而减少查看次数。
- display_product_view_count：显示特定产品的查看次数。
- rt_product_viewer_shortcode：提供用于在自定义模板中显示查看次数的短代码。
- rt_get_currently_viewing_count：用于从 JSON 文件中提取当前视图计数的辅助函数。
管理员设置：
- 该插件在 设置 > Product Viewer 设置 管理员可以启用/禁用单个产品页面或产品循环的查看计数显示，并自定义 CSS。
设置选项：
- 在单个产品页面上启用：启用/禁用单个产品页面上的查看计数。
- 在产品列表 （Shop） 页面上启用：启用/禁用产品存档页面上的查看计数。
- CSS 设置：自定义单个产品和产品循环视图的文本对齐方式、字体颜色和字体系列。
CSS 定制：
开发人员可以使用设置面板中的可用选项或通过直接在主题中覆盖样式来轻松修改用于显示视图计数的 CSS。
JSON 文件 （view_counts.json)
- JSON 文件存储实时视图数据以及每个产品的会话信息。
- 每个产品的浏览次数都与一次会话相关联，从而确保每个用户在会话期间只被统计一次。
常见问题
1. 观看次数多久更新一次？
查看计数通过 AJAX 请求每 5 秒更新一次。
2. 查看次数数据存储在哪里？
查看次数存储在 view_counts.json 文件。
3. 是否可以自定义查看计数显示的文本或外观？
是的，您可以从设置页面的 Product Viewer 设置.
4. 插件与缓存插件兼容吗？
使用主动缓存时，该插件可能无法按预期工作。确保您的缓存插件从缓存中排除了产品查看计数功能或 AJAX 调用。
更改日志
-
版本 1.0
- 具有 WooCommerce 产品实时查看计数功能的初始版本。
- 对查看次数进行基于 AJAX 的更新。
- WooCommerce 产品列表中的自定义列。
- 动态视图计数显示的短代码支持。
