Ad Code Manager 技术文档

1. 安装指南

Ad Code Manager 插件安装步骤如下：

1. 确保服务器环境满足要求：PHP 7.4 或更高版本，WordPress 5.7 或更高版本。
2. 将 ad-code-manager 文件夹上传到 /wp-content/plugins/ 目录。
3. 在 WordPress 的“插件”菜单中激活 Ad Code Manager 插件。
4. 在主题模板中添加广告标签，使用 do_action('acm_tag', 'slot'); 方法。也可以使用 [acm-tag id="slot"] 短代码或 ACM 小工具。
5. 实现过滤器以使插件与您的广告提供商兼容。
6. 在 WordPress 管理后台（工具 -> Ad Code Manager）配置您的广告代码。

2. 项目使用说明

Ad Code Manager 插件为非开发者提供了一个在 WordPress 管理后台中配置复杂广告代码的界面。通过该插件，用户可以轻松添加新广告代码、修改脚本 URL 参数以及定义广告代码显示的条件。

使用步骤：

1. 在插件配置界面添加新的广告代码。
2. 选择广告提供商，输入广告标签 ID 和发布者 ID。
3. 根据需要设置广告显示的条件。
4. 在主题模板中添加相应的广告标签。

3. 项目 API 使用文档

Ad Code Manager 提供了多个过滤器供开发者自定义插件输出。以下是一些主要过滤器及其用途：

• acm_ad_tag_ids：用于注册和自定义广告标签 ID。
• acm_default_url：定义广告代码的默认 URL。
• acm_whitelisted_script_urls：添加允许的脚本 URL 白名单。
• acm_output_html：自定义广告标签的输出 HTML。
• acm_output_tokens：自定义输出令牌。

开发者可以根据自己的广告网络规格，在主题的 functions.php 文件或其他适当位置添加这些过滤器。

4. 项目安装方式

Ad Code Manager 插件的安装方式如下：

• 手动安装：按照上述安装指南中的步骤进行操作。
• 自动安装：在 WordPress 插件市场中搜索 Ad Code Manager，然后点击安装和激活。

以上是 Ad Code Manager 技术文档的主要内容，希望对您使用该插件有所帮助。