> For the complete documentation index, see [llms.txt](https://helps.ptengine.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://helps.ptengine.com/cn/start-guide/othertag/tag-wordpress.md).

# 在 WordPress 中安装基础代码

把 Ptengine 基础代码写进主题的 `header.php`，全站所有页面就都带上了，不用一页页加。

{% hint style="info" %}
**WordPress 后台是什么语言，取决于你站点自己的语言设置**，和 Ptengine 无关。下面截图是日文后台的例子，中文站点的菜单名见[对照表](#label-mapping)。
{% endhint %}

***

## 开始之前 <a href="#before-you-start" id="before-you-start"></a>

* 需要能进 WordPress 后台、且有**编辑主题文件**的权限
* **改主题文件前先备份** —— `header.php` 写错会让整站打不开
* 用的是子主题的话，改**子主题**的 `header.php`；改父主题的会在主题更新时被覆盖

***

## 推荐做法：写进主题的 header.php <a href="#recommended-setup-method" id="recommended-setup-method"></a>

{% stepper %}
{% step %}

### 进入主题文件编辑器

后台左栏 **外观** → **主题文件编辑器**。
{% endstep %}

{% step %}

### 右上角选中要改的主题

{% endstep %}

{% step %}

### 在右侧文件列表里点 `header.php`

{% endstep %}

{% step %}

### 把基础代码粘在 `</head>` 之前

从 Ptengine 复制基础代码（齿轮图标 →“基础设置”→“档案”→“监测代码”），粘进去。

**要放在 `</head>` 之前**，越靠前越好。
{% endstep %}

{% step %}

### 点底部的“更新文件”保存

{% endstep %}
{% endstepper %}

<figure><img src="https://2044586328-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FnucbKsG9WGIoxCpzyoHL%2Fuploads%2Fgit-blob-f20121d48ec00bef8fd655aabe71c51b0a34110a%2Fstart-guide-tag-wordpress-01.png?alt=media" alt="WordPress 主题文件编辑器（日文后台示例）：①主题文件编辑器 ②选择主题 ③header.php ④粘贴位置 ⑤更新文件"><figcaption><p>日文后台的界面示例，编号对应上面五步</p></figcaption></figure>

### 中日菜单对照 <a href="#label-mapping" id="label-mapping"></a>

| 图中（日文）     | 中文后台                |
| ---------- | ------------------- |
| 外観         | 外观                  |
| テーマエディター   | 主题文件编辑器（旧版叫“主题编辑器”） |
| 編集するテーマを選択 | 选择要编辑的主题            |
| テーマファイル    | 主题文件                |
| ファイルを更新    | 更新文件                |

***

## 改不了主题文件时：用插件 <a href="#alternative-setup-method" id="alternative-setup-method"></a>

有些主题禁用了文件编辑器，或者你不想碰主题代码。这种情况用插件更稳：

{% stepper %}
{% step %}

### 安装并启用插件 Insert Headers And Footers

{% endstep %}

{% step %}

### 左栏 **设置** → **Insert Headers And Footers**

{% endstep %}

{% step %}

### 把基础代码粘进 **Scripts in Header** 那一栏，保存

{% endstep %}
{% endstepper %}

{% hint style="success" %}
**插件法比改主题文件更安全**：不动主题代码，主题更新也不会丢，出问题停用插件就能回退。不确定的话优先用这个。
{% endhint %}

***

## 装完之后 <a href="#verify" id="verify"></a>

回 Ptengine 验证一次：齿轮图标 →“基础设置”→“档案”→“监测代码”→**验证安装**，填一个已上线页面的 URL。

看到绿色的“我们成功的接收到了网站数据”就说明通了。详见[确认基础代码是否正常发送](/cn/faq/start-guide/check-tag-firing.md)。

{% hint style="warning" %}
WordPress 常见的两个坑：**装了缓存插件**（改完要清缓存才看得到），和**改错了主题**（站点实际启用的是另一个主题，或者你改了父主题但启用的是子主题）。
{% endhint %}

***

## 相关页面 <a href="#related-pages" id="related-pages"></a>

* [其他安装方法](/cn/start-guide/othertag.md)
* [基础代码的安装方法](/cn/start-guide/quick/tag-setup.md)
* [确认基础代码是否正常发送](/cn/faq/start-guide/check-tag-firing.md)
* [基础代码正确部署但没有数据流入](/cn/faq/tracking-code/no-data-after-deploy.md)