Hacklog Package：WordPress 功能模块化管理插件指南

Hacklog Package：WordPress 插件增强功能包

Hacklog Package 是一个用于集中管理常用 WordPress 功能代码的“半插件”。它本身不提供后台配置界面，而是作为一个代码容器，让你可以将经常需要用到的功能代码（如评论回复邮件通知、中文摘要截取、评论者网站 URL 重定向等）模块化地集成进来。

核心优势

相比于直接将代码添加到当前主题的 functions.php 文件中，使用此插件的主要优势在于：

• 主题无关性：当你更换 WordPress 主题时，无需再次复制粘贴这些功能代码到新主题的 functions.php 中，真正做到“一次添加，永久使用”。
• 模块化管理：所有功能代码以独立文件的形式存放在插件目录下，便于启用、禁用和维护。

你可以通过 FTP 或 WordPress 后台的文件编辑器来管理插件文件。

如何添加新功能模块

要为 Hacklog Package 添加一个新功能，请按以下步骤操作：

1. 创建功能文件：将实现功能的 PHP 代码写入一个新文件，例如 demo.php，并将该文件放置在插件目录下的 includes/ 文件夹内。
2. 注册功能模块：编辑插件根目录下的 packages.php 文件，按照已有条目的格式，新增一行注册信息。例如：

   'demo.php' => array('name' => '演示如何添加代码', 'enable' => 1),

参数说明：

• demo.php：文件名（在 Linux/BSD 主机上区分大小写）。
• name：该功能的描述性名称。
• enable：是否启用此功能。设置为 1 表示启用，0 表示禁用。

代码编写规范

为确保兼容性并避免命名冲突，请遵守以下规范：

• 命名空间前缀：所有放置在 includes/ 目录下的文件中的全局变量、函数名、类名，都必须以 ihacklog_pkg_ 作为前缀。例如：function ihacklog_pkg_my_function() {}。
• 资源文件存放：JavaScript 文件应放入公共的 js/ 目录，CSS 文件应放入公共的 css/ 目录。
• 配置支持：如果某个功能模块需要配置项，可以在其 PHP 文件的开头按以下格式定义：

  //========= START CONFIGURE ========
  $GLOBALS['ihacklog_pkg_foo'] = array(
      'key' => 'value',
  );
  //========= END CONFIGURE ========

  随后，在函数内部通过 global $ihacklog_pkg_foo; 声明后即可引用这些配置。

在主题中手动引用 CSS 或 JS 文件

如果你的功能模块包含了需要在前端加载的 CSS 或 JavaScript 文件，可以在主题模板中使用以下方式手动引用（以 CSS 文件为例）：

<link rel="stylesheet" type="text/css" media="screen" href="<?php echo plugins_url('hacklog-package'); ?>/css/foo.css" />

请将 foo.css 替换为你的实际文件名，并确保文件已按规范存放在 css/ 目录下。