WordPress自定义主题安装时自动生成页面并指定首页、博客页的实现方法
自定义WordPress主题激活自动初始化功能实现代码
实现效果
- 主题激活时自动创建Home、News、Products、Policy、Services共5个页面
- Products/Policy/Services页面自动绑定对应模板文件
- 自动将Home设为站点静态首页、News设为默认博文列表页
- 自动生成主导航菜单,将上述5个页面加入菜单并分配到主题默认菜单位置
- 自带重复执行校验,不会重复创建内容
完整可直接使用代码
直接把以下代码复制到你主题的functions.php文件末尾即可:
// 主题激活时自动初始化内容 add_action('after_switch_theme', 'custom_theme_auto_init'); function custom_theme_auto_init() { // 校验是否已经执行过初始化,避免重复创建 if (get_option('custom_theme_initialized')) return; // 定义要创建的页面配置 $pages = [ [ 'post_title' => 'Home', 'post_name' => 'home', 'post_status' => 'publish', 'post_type' => 'page', 'template' => '' // Home用默认模板,如有自定义模板可填文件名 ], [ 'post_title' => 'News', 'post_name' => 'news', 'post_status' => 'publish', 'post_type' => 'page', 'template' => '' ], [ 'post_title' => 'Products', 'post_name' => 'products', 'post_status' => 'publish', 'post_type' => 'page', 'template' => 'page-products.php' ], [ 'post_title' => 'Policy', 'post_name' => 'policy', 'post_status' => 'publish', 'post_type' => 'page', 'template' => 'page-policy.php' ], [ 'post_title' => 'Services', 'post_name' => 'services', 'post_status' => 'publish', 'post_type' => 'page', 'template' => 'page-services.php' ] ]; $page_ids = []; // 批量创建页面 foreach ($pages as $page) { // 检查页面是否已存在 $existing_page = get_page_by_path($page['post_name']); if ($existing_page) { $page_ids[$page['post_name']] = $existing_page->ID; continue; } // 插入页面 $page_id = wp_insert_post($page); if ($page_id && !is_wp_error($page_id)) { $page_ids[$page['post_name']] = $page_id; // 绑定页面模板 if ($page['template']) { update_post_meta($page_id, '_wp_page_template', $page['template']); } } } // 设置首页和博文页 if (isset($page_ids['home']) && isset($page_ids['news'])) { update_option('show_on_front', 'page'); update_option('page_on_front', $page_ids['home']); update_option('page_for_posts', $page_ids['news']); } // 创建导航菜单 $menu_name = '主导航'; // 检查菜单是否已存在 $menu_exists = wp_get_nav_menu_object($menu_name); if (!$menu_exists) { $menu_id = wp_create_nav_menu($menu_name); // 给菜单添加页面 foreach ($page_ids as $slug => $pid) { wp_update_nav_menu_item($menu_id, 0, [ 'menu-item-title' => get_the_title($pid), 'menu-item-object-id' => $pid, 'menu-item-object' => 'page', 'menu-item-type' => 'post_type', 'menu-item-status' => 'publish' ]); } // 将菜单分配到主题的菜单位置,注意这里的primary要替换为你自己主题注册的菜单位置别名 $locations = get_theme_mod('nav_menu_locations'); $locations['primary'] = $menu_id; set_theme_mod('nav_menu_locations', $locations); } // 标记初始化完成,后续激活主题不会再执行 update_option('custom_theme_initialized', 1); } // 如果你的主题还没注册导航菜单位置,可加下面这段代码 add_action('after_setup_theme', 'custom_theme_register_nav_menu'); function custom_theme_register_nav_menu() { register_nav_menus([ 'primary' => '主导航' // 这里的别名和上面代码里的locations对应即可 ]); }
注意事项
- 如果你主题已经注册过导航菜单,可删除最后一段注册菜单的代码,将前面
$locations['primary']里的primary替换为你自己主题注册的菜单位置别名 - 如需调整页面标题、别名、模板,直接修改
$pages数组里的对应配置即可 - 如需重新触发初始化,可删除数据库
wp_options表中custom_theme_initialized的记录,再次切换主题即可重新执行 - 设置首页和博文页的功能已经包含在上述代码中,无需额外开发,实现逻辑非常简单,直接调用WordPress原生option更新接口即可
内容的提问来源于stack exchange,提问作者ShrockCo
相关产品推荐
相关产品推荐

