README

WordPress开发插件，添加钩子以将网站数据记录到指定的MySQL数据库中。

使用Composer安装

$1 此软件包使用Composer Installers在必须使用插件目录（/wp-content/mu-plugins）中安装软件包

composer require nyco/wp-stat-collector

未使用Composer？下载代码存档并将其放入mu-plugins目录。

$2 在mu-plugins目录内创建代理PHP加载器文件，或使用插件中包含的示例

mv wp-content/mu-plugins/wp-stat-collector/autoloader-sample.php wp-content/mu-plugins/wp-stat-collector.php

初始化

示例自动加载器包含初始化插件所需的基本代码。它将...

• 添加statc_register的示例以开始创建写入数据库信息的触发器。
• 添加statc_bootstrap的示例查询以在数据库中创建存储数据的表。
• 需要包含类的所有文件。
• 初始化StatCollector\StatCollector。
• 在设置 > Stat Collector下创建管理设置页面进行配置。

配置

• 主机（包括端口）
• 名称
• 用户名
• 密码
• 发送通知 - 是否在出现连接错误时向管理员发送电子邮件。

通知

• 已创建表 - 使用statc_bootstrap钩子创建了数据库表的提示。
• 证书机构 - 发现证书机构的提示。
• 连接 - 使用上述凭证进行连接的提示。

SSL

Stat Collector使用Amazon Web Services RDS证书包通过SSL进行MySQL连接。

操作

statc_register

用于收集信息并写入DB的内部动作的钩子。

...参数

• Class StatCollector - StatCollector的一个实例。

示例

add_action('statc_register', function($statc) {
  add_action('my_action', function($data) use ($statc) {
    if (gettype($data) === 'string') {
      $statc->collect('my_table', [
        'my_data' => $data,
      ]);
    }
  }, $statc->settings->priority, 2);

  return true;
});

statc_init

插件后实例化的钩子。

...参数

• Class StatCollector - StatCollector的一个实例。

statc_bootstrap

用于数据库引导的钩子。

...参数

• Class wpdb - 与您的数据库连接的wpdb的一个实例。

示例

add_action('statc_bootstrap', function($db) {
  $db->query(
    'CREATE TABLE IF NOT EXISTS my_table (
      id INT(11) NOT NULL AUTO_INCREMENT,
      my_data TEXT DEFAULT NULL,
      PRIMARY KEY(id)
    ) ENGINE=InnoDB'
  );

  return true;
});

纽约经济机会办公室（NYC机会）致力于共享我们在产品中使用的开源软件。欢迎提问和分享反馈。 有意参与贡献吗？ 请访问buildwithnyc.github.io了解我们的开放职位。关注我们的团队在Github（如果您是@cityofnewyork组织的一员）或在Github上浏览我们的工作。