点击量计数器 Page Click Counter

=== Page Click Counter ===
Contributors: 梁北棠
Tags: analytics, page counter, statistics
Requires at least: 5.6
Tested up to: 6.5
Stable tag: 1.0.0
License: GPLv2
License URI: http://www.gnu.org/licenses/gpl-2.0.html

== Description ==
专业的页面点击统计解决方案，在文章/页面右下角显示实时计数器，支持深度定制和数据分析。

== Directory Structure ==
? page-click-counter
├── ? page-click-counter.php – 主插件文件
├── ? admin
│ ├── ? settings-page.php – 后台设置界面逻辑
│ └── ? settings-style.css – 管理后台样式表
├── ? assets
│ ├── ? frontend.css – 前端计数器样式
│ └── ? click-counter.js – AJAX点击处理器
├── ? languages
│ └── ? page-click-counter.pot – 翻译模板文件
└── ? readme.txt – 本说明文档

== Installation ==

1. 解压插件包至 /wp-content/plugins/
2. 激活插件后访问：
   [网站后台] → [设置] → [点击计数器]
3. 配置以下参数：

• 显示位置：固定右下角
• 更新间隔：实时AJAX请求
• 数据保留：永久存储

== Configuration ==
通过 [设置] → [点击计数器] 可配置：
✅ 启用/禁用计数器
? 自定义标题（支持HTML）
? 颜色选择器（支持RGBA）
? 字体大小调节（10-32px）
? 数据保留策略（开发中）

== Frequently Asked Questions ==

= 如何验证统计数据准确性？=

1. 使用Chrome开发者工具 → Network
2. 筛选pcc-record-click请求
3. 检查响应状态码应为200

= 能否显示在自定义文章类型？=
修改主题functions.php添加：
add_filter(‘pcc_post_types’, function($types) {
$types[] = ‘your_custom_post_type’;
return $types;
});

= 移动端适配情况如何？=
已实现响应式布局：

• 桌面端：右下20px定位
• 移动端：底部居中显示
• 自动适应深色模式

== Screenshots ==

1. 前端显示效果（桌面/移动端）
2. 后台设置界面
3. 数据库表结构
4. 颜色选择器演示

== Changelog ==
= 1.0.1 – 2024-03-25 =

• 新增：移动端自适应布局
• 修复：缓存插件兼容性问题
• 优化：AJAX请求性能提升40%

= 1.0.0 – 2024-03-20 =

• 首发正式版
• 核心计数功能
• 基础设置面板

== Developer Documentation ==
? 数据库表结构：
CREATE TABLE wp_page_clicks (
id INT AUTO_INCREMENT,
post_id BIGINT NOT NULL,
click_count BIGINT DEFAULT 0,
last_updated TIMESTAMP,
PRIMARY KEY (id)
) ENGINE=InnoDB;

? 可用钩子：

1. pcc_before_counter – 修改输出HTML前
2. pcc_after_click – 点击记录后触发
3. pcc_admin_settings – 扩展设置选项

== Translation ==
支持.po/.mo翻译文件：

1. 复制page-click-counter.pot到languages目录
2. 使用Poedit生成翻译
3. 命名格式：page-click-counter-{locale}.po