WordPress添加页面元素到菜单报错，如何限制仅接受WP_Post元素？

报错原因分析 #

从堆栈日志可以看出：保存菜单时触发wp_insert_post动作，Elementor的Source_Local::on_save_post()函数被调用，但该函数强制要求第二个参数$post为WP_Post类型，而菜单保存过程中传入了null（非WP_Post类型的菜单项，比如自定义链接，会导致这个情况），触发PHP类型错误。

解决方案 #

方案1：修复Elementor钩子的参数检查（推荐） #

通过替换Elementor的save_post钩子，添加参数校验，避免null传入：
将以下代码添加到主题的functions.php文件或自定义插件中：

add_action( 'init', function() {
    // 移除Elementor原有的save_post钩子
    remove_action( 'save_post', [ Elementor\TemplateLibrary\Source_Local::get_instance(), 'on_save_post' ], 10 );
    
    // 添加带参数校验的钩子
    add_action( 'save_post', function( $post_id, $post, $update ) {
        // 仅当$post为WP_Post实例时执行原方法
        if ( $post instanceof WP_Post ) {
            Elementor\TemplateLibrary\Source_Local::get_instance()->on_save_post( $post_id, $post, $update );
        }
    }, 10, 3 );
} );

此方法无需修改插件核心文件，不会被Elementor更新覆盖。

方案2：临时修改Elementor源文件（不推荐） #

直接修改Elementor的函数参数声明，允许null传入：

1. 打开文件wp-content/plugins/elementor/includes/template-library/sources/local.php
2. 找到第1112行的函数声明：

   public function on_save_post( $post_id, WP_Post $post, $update )
   

   修改为：

   public function on_save_post( $post_id, ?WP_Post $post, $update )
   

3. 在函数开头添加null检查：

   if ( is_null( $post ) ) {
       return;
   }
   

注意：插件更新后修改会丢失，仅作为临时应急方案。

针对你的两个问题的具体解答 #

1. 如何限制WordPress仅接受WP_Post作为菜单项？ #

WordPress默认支持多种菜单项类型（自定义链接、分类等），要限制仅允许添加文章/页面（WP_Post类型），可以通过以下代码实现：

// 移除菜单编辑页面的非WP_Post类型元框
add_filter( 'nav_menu_meta_boxes', function( $meta_boxes ) {
    // 仅保留文章（post）和页面（page）的添加选项
    return array_intersect_key( $meta_boxes, [ 'post' => '', 'page' => '' ] );
} );

// 阻止通过AJAX添加非WP_Post类型的菜单项
add_action( 'wp_update_nav_menu_item', function( $menu_id, $menu_item_db_id, $args ) {
    if ( isset( $args['type'] ) && $args['type'] !== 'post_type' ) {
        wp_delete_post( $menu_item_db_id );
    }
}, 10, 3 );

此方法会限制菜单灵活性，仅在业务必须时使用。

2. 从何处入手取消该限制？ #

这里的"限制"是Elementor函数的严格类型声明导致的，无需修改WordPress核心，入手点为：

• 要么在调用Elementor的on_save_post前添加参数校验（方案1）
• 要么修改Elementor函数的参数类型为可空（方案2）

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