WooCommerce 实时产品查看器文档

概述

这 WooCommerce 实时产品查看器 插件显示当前实时查看特定产品的用户数量。它使用 AJAX 请求提供实时更新，并将视图计数存储在 JSON 文件中。

特征：

• 显示当前在单个产品页面和产品列表（商店）页面上查看产品的用户数。
• 支持字体颜色、对齐方式和字体系列的自定义 CSS 设置。
• 提供短代码支持，用于动态显示视图计数。
• 包括用于管理插件配置的管理设置页面。

安装指南

第 1 步：下载插件

1. 将插件文件下载或克隆到您的 WooCommerce 网站中，位于 /wp-content/plugins/ 目录。

第 2 步：上传插件

1. 上传 product-viewer 目录到/wp-content/plugins/ 目录，通过 FTP 或使用 WordPress 管理员的插件上传功能。

第 3 步：激活插件

1. 登录您的 WordPress 管理仪表板。
2. 导航到 插件>已安装的插件.
3. 找到 WooCommerce 实时产品查看器 ，然后单击激活.

第 4 步：配置插件

1. 转到 设置>产品查看器设置 以调整显示设置，例如启用/禁用单个产品和商店页面上的查看计数，以及自定义 CSS 属性。

使用说明

在产品页面上显示浏览次数

• 如果在设置中启用，该插件会自动在产品详细信息页面上显示当前查看产品的用户数量。
• 对于产品循环（例如商店页面），浏览次数也可以以紧凑的格式显示在每个产品下方。

简码：

要在自定义页面或模板上显示实时浏览量，请使用以下短代码：

[rt_product_viewer id=<span class="hljs-string">"PRODUCT_ID"</span>]

如果没有 id 属性，则短代码将尝试检测当前产品 ID。

WooCommerce 管理中的自定义列：

• 该插件在 WooCommerce 产品列表中添加了一个标有“正在查看”的自定义列，显示当前有多少用户正在查看每个产品。

开发者指南

该插件在设计时考虑到了易用性和定制性。它使用标准的 WordPress 挂钩、AJAX 请求和 JSON 数据存储。以下是开发人员需要注意的一些重要方面：

JavaScript （rt-product-viewer.js）

1. JavaScript 文件在页面加载时初始化并尝试检测产品 ID。
2. 它每 5 秒发送一次定期 AJAX 请求，以更新产品页面上显示的查看次数。
3. 它还发送一个 beforeunload 当用户离开页面以更新服务器时，用户不再查看产品。

主要功能：

• 更新产品视图计数：发送 AJAX 请求以检索产品的当前查看者数。
• 卸载前：检测用户何时离开页面并相应地更新查看计数。

PHP （woocommerce-real-time-viewer.php）

1. 该插件注册自定义 AJAX作 （rt_update_product_view_count 和rt_leave_product_view） 以更新和管理产品浏览次数。
2. 产品浏览次数存储在 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 文件中提取当前视图计数的帮助程序函数。

管理员设置：

• 该插件在 设置>产品查看器设置 管理员可以在其中启用/禁用单个产品页面或产品循环的视图计数显示，并自定义 CSS。

设置选项：

• 在单个产品页面上启用：启用/禁用单个产品页面的查看次数。
• 在产品列表（商店）页面上启用：启用/禁用产品存档页面上的查看计数。
• CSS 设置：自定义单个产品和产品循环视图的文本对齐方式、字体颜色和字体系列。

CSS定制：

开发人员可以使用设置面板中的可用选项或直接在主题中覆盖样式来轻松修改 CSS 以显示视图计数。

JSON 文件 （view_counts.json)

• JSON 文件存储包含每个产品的会话信息的实时视图数据。
• 每个产品的观看次数都与一个会话相关联，确保每个用户在会话期间只统计一次。

常见问题

1. 浏览量多久更新一次？
通过 AJAX 请求，每 5 秒更新一次视图计数。

2. 浏览量数据存储在哪里？
视图计数存储在 view_counts.json 文件位于插件目录中。

3. 我可以自定义观看次数显示的文本或外观吗？
是的，您可以从下面的设置页面自定义文本对齐方式、字体颜色和字体系列 产品查看器设置.

4. 插件是否与缓存插件兼容？
该插件可能无法按预期工作，使用激进缓存。确保缓存插件将产品视图计数功能或 AJAX 调用排除在缓存之外。

更改日志

• 版本 1.0
  • 具有 WooCommerce 产品实时浏览计数功能的初始版本。
  • 基于 AJAX 的视图计数更新。
  • WooCommerce 产品列表中的自定义列。
  • 对动态视图计数显示的短代码支持。