如何在WordPress单页面添加仅在此页面运行的PHP代码

给你一套完全匹配所有需求的标准实现方案，步骤直接走：

1. 先搭子主题（搞定样式继承） #

• 在wp-content/themes/目录下新建文件夹，比如your-theme-child
• 文件夹里建style.css，填以下内容（把父主题名称和文件夹名换成你当前用的）：

/*
Theme Name: 你的父主题名称 Child
Template: 父主题文件夹名（比如twentytwentyfour）
*/

• 再建functions.php，加这段代码确保继承父主题样式：

<?php
add_action( 'wp_enqueue_scripts', 'enqueue_parent_styles' );
function enqueue_parent_styles() {
    wp_enqueue_style( 'parent-style', get_template_directory_uri().'/style.css' );
}

• 后台激活这个子主题就行。

2. 写自定义页面模板（只针对目标页面，不用重写HTML） #

在子主题文件夹里新建page-custom.php，内容如下：

<?php
/*
Template Name: 自定义单页模板
*/

// 这里写你的专属PHP逻辑，只有用这个模板的页面才会跑这段代码
global $post;
// 获取你在GUI编辑器里写的所有HTML内容
$page_content = apply_filters('the_content', $post->post_content);

// 示例：直接操作HTML元素——把所有<h2>标签加个自定义类
$modified_content = str_replace('<h2>', '<h2 class="custom-heading">', $page_content);

// 复用父主题的头部、尾部，保留原有布局和CSS
get_header(); ?>

<div id="primary" class="content-area">
    <main id="main" class="site-main">
        <!-- 输出处理后的页面内容，或者直接输出原内容 -->
        <?php echo $modified_content; ?>

        <!-- 额外示例：根据HTML内容触发动态内容 -->
        <?php if (strpos($modified_content, 'special-trigger') !== false) : ?>
            <div class="dynamic-block">这是检测到特定内容后生成的动态区块</div>
        <?php endif; ?>
    </main>
</div>

<?php get_footer(); ?>

这个模板的核心是不重写整个页面结构，直接复用父主题的header和footer，同时拿到你在编辑器里写的HTML内容，想怎么操作都可以。

3. 给目标页面绑定模板 #

• 后台打开要处理的页面，右侧找“页面属性”面板
• 在“模板”下拉框里选“自定义单页模板”，保存页面
• 之后你依然可以通过编辑器GUI修改HTML，PHP逻辑只会在这个页面生效。

进阶：精准操作HTML元素 #

如果需要更精细地定位、修改HTML元素，用PHP的DOMDocument来解析：

$dom = new DOMDocument();
// 忽略HTML解析时的警告（避免编辑器内容不规范导致报错）
libxml_use_internal_errors(true);
$dom->loadHTML($page_content);
libxml_clear_errors();

// 找到所有class为"target-box"的元素，给它们加自定义属性
$target_elements = $dom->getElementsByClassName('target-box');
foreach ($target_elements as $elem) {
    $elem->setAttribute('data-custom', 'dynamic-value-from-php');
}

// 输出修改后的内容
echo $dom->saveHTML();

这套方案完美覆盖你的所有要求：

• ✅ 可通过WordPress GUI修改HTML（编辑器正常编辑页面内容）
• ✅ PHP代码能够访问、操作HTML元素（通过$post->post_content获取内容，用字符串处理或DOMDocument解析）
• ✅ PHP代码仅在目标单页面运行（只有绑定了该模板的页面才会执行）
• ✅ 继承当前主题/CSS（子主题继承父主题样式，模板复用原有布局结构）

内容的提问来源于stack exchange，提问作者Zasekle