WordPress/WooCommerce自定义字段后台显示PHP代码问题求助

常见问题1：后台字段渲染时PHP代码未解析 #

• 核心原因是输出input的value属性时，将PHP函数直接写在了字符串内部，没有正确拼接，函数不会被执行只会被当成纯文本输出：
  • 错误示例：echo '<input type="text" name="custom_field" value="get_user_meta($user->ID, "custom_field", true)">';
  • 正确拼接写法：echo '<input type="text" name="custom_field" value="' . esc_attr( get_user_meta( $user->ID, 'custom_field', true ) ) . '">';
  • 正确混写写法：

    <input type="text" name="custom_field" value="<?php echo esc_attr( get_user_meta( $user->ID, 'custom_field', true ) ); ?>">
    

• 注意必须添加esc_attr()做属性转义，符合WordPress安全规范，避免XSS漏洞。

常见问题2：字段键名前后端/读写逻辑不匹配 #

• 确认三处逻辑的字段键名完全一致，大小写严格对应：
  1. 前端form-edit-account.php里自定义字段的name属性值
  2. functions.php中保存字段时update_user_meta用的第二个参数（键名）
  3. 后台渲染字段时get_user_meta用的第二个参数（键名）
• 参考正确的字段保存代码：

  // 同时兼容前端账户页、后台用户页的字段保存
  add_action( 'woocommerce_save_account_details', 'save_custom_account_fields' );
  add_action( 'personal_options_update', 'save_custom_account_fields' );
  add_action( 'edit_user_profile_update', 'save_custom_account_fields' );
  function save_custom_account_fields( $user_id ) {
      if ( isset( $_POST['custom_field_key'] ) ) {
          update_user_meta( $user_id, 'custom_field_key', sanitize_text_field( $_POST['custom_field_key'] ) );
      }
  }
  

常见问题3：后台字段输出钩子配置错误 #

• 必须使用show_user_profile（查看用户资料）和edit_user_profile（编辑用户资料）两个钩子挂载字段输出函数，函数必须接收$user参数才能获取当前编辑用户的ID，参考正确实现：

  add_action( 'show_user_profile', 'render_custom_user_admin_fields' );
  add_action( 'edit_user_profile', 'render_custom_user_admin_fields' );
  function render_custom_user_admin_fields( $user ) {
  ?>
  <h3>自定义用户信息</h3>
  <table class="form-table">
      <tr>
          <th><label for="custom_field_key">自定义字段名称</label></th>
          <td>
              <input type="text" name="custom_field_key" id="custom_field_key" value="<?php echo esc_attr( get_user_meta( $user->ID, 'custom_field_key', true ) ); ?>" class="regular-text">
          </td>
      </tr>
  </table>
  <?php
  }
  

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