如果你制作了一个主题，需要新建很多页面才能够完美工作，那么在使用者激活主题的时候自动新建页面将会给主题的使用省略很多设置步骤。

创建文章使用的函数为 wp_insert_post(); 使用方法如下

  1. <?php   
  2. $post = array(   
  3.   'ID'             => [ <post id> ] //Are you updating an existing post?   
  4.   'menu_order'     => [ <order> ] //If new post is a page, it sets the order in which it should appear in the tabs.   
  5.   'comment_status' => [ 'closed' | 'open' ] // 'closed' means no comments.   
  6.   'ping_status'    => [ 'closed' | 'open' ] // 'closed' means pingbacks or trackbacks turned off   
  7.   'pinged'         => [ ? ] //?   
  8.   'post_author'    => [ <user ID> ] //The user ID number of the author.   
  9.   'post_category'  => [ array(<category id>, <...>) ] //post_category no longer exists, try wp_set_post_terms() for setting a post's categories   
  10.   'post_content'   => [ <the text of the post> ] //The full text of the post.   
  11.   'post_date'      => [ Y-m-d H:i:s ] //The time post was made.   
  12.   'post_date_gmt'  => [ Y-m-d H:i:s ] //The time post was made, in GMT.   
  13.   'post_excerpt'   => [ <an excerpt> ] //For all your post excerpt needs.   
  14.   'post_name'      => [ <the name> ] // The name (slug) for your post   
  15.   'post_parent'    => [ <post ID> ] //Sets the parent of the new post.   
  16.   'post_password'  => [ ? ] //password for post?   
  17.   'post_status'    => [ 'draft' | 'publish' | 'pending'| 'future' | 'private' | 'custom_registered_status' ] //Set the status of the new post.   
  18.   'post_title'     => [ <the title> ] //The title of your post.   
  19.   'post_type'      => [ 'post' | 'page' | 'link' | 'nav_menu_item' | 'custom_post_type' ] //You may want to insert a regular post, page, link, a menu item or some custom post type   
  20.   'tags_input'     => [ '<tag>, <tag>, <...>' ] //For tags.   
  21.   'to_ping'        => [ ? ] //?   
  22.   'tax_input'      => [ array( 'taxonomy_name' => array( 'term', 'term2', 'term3' ) ) ] // support for custom taxonomies.    
  23. );     
  24. wp_insert_post( $post, $wp_error );   
  25. /*
  26. $wp_error 参数 布尔值 如果出错允许返回一个类。  
  27. 如果插入文章成功，函数将会返回插入的文章 ID，如果出错，$wp_error 设置为 true 则返回一个类，否则返回 0  
  28. */  
  29. ?>  

步骤一：添加页面的函数

需要注意，页面的模板信息保存在_postmeta 表中，以字段形式保存，字段名为_wp_page_template，所以要保存页面模板信息，使用 update_post_meta 函数

  1. /**  
  2. *参数 $title 字符串 页面标题  
  3. *参数 $slug  字符串 页面别名  
  4. *参数 $page_template 字符串  模板名  
  5. *无返回值  
  6. **/  
  7. function ashu_add_page($title,$slug,$page_template=''){   
  8.     $allPages = get_pages();//获取所有页面   
  9.     $exists = false;   
  10.     foreach( $allPages as $page ){   
  11.         //通过页面别名来判断页面是否已经存在   
  12.         if( strtolower( $page->post_name ) == strtolower( $slug ) ){   
  13.             $exists = true;   
  14.         }   
  15.     }   
  16.     if( $exists == false ) {   
  17.         $new_page_id = wp_insert_post(   
  18.             array(   
  19.                 'post_title' => $title,   
  20.                 'post_type'     => 'page',   
  21.                 'post_name'  => $slug,   
  22.                 'comment_status' => 'closed',   
  23.                 'ping_status' => 'closed',   
  24.                 'post_content' => '',   
  25.                 'post_status' => 'publish',   
  26.                 'post_author' => 1,   
  27.                 'menu_order' => 0   
  28.             )   
  29.         );   
  30.         //如果插入成功 且设置了模板   
  31.         if($new_page_id && $page_template!=''){   
  32.             //保存页面模板信息   
  33.             update_post_meta($new_page_id, '_wp_page_template',  $page_template);   
  34.         }   
  35.     }   
  36. }  

步骤二：通过 hook 执行创建页面函数。

有了上面的创建页面函数，则只需要通过钩子调用上面的函数即可创建页面。注意，有的人可能使用 init 钩子，个人认为这不是很好，init 钩子是每次 WordPress 初始化时都要执行的，但是我们不需要每次执行程序的时候都来一遍这个函数，我们只需要在主题使用者点击激活主题的那一刻，执行一次，以后再也不需要再执行了。所以使用 load-themes.php 钩子，load-themes.php 钩子是后台在设置主题的页面时启用。

  1. function ashu_add_pages() {   
  2.     global $pagenow;   
  3.     //判断是否为激活主题页面   
  4.     if ( 'themes.php' == $pagenow && isset( $_GET['activated'] ) ){   
  5.         ashu_add_page('ASHU_PAGE','ashu-page','page-ashu.php'); //页面标题 ASHU_PAGE 别名 ashu-page  页面模板 page-ashu.php   
  6.         ashu_add_page('PAGE_ASHU','page-ashu','ashu-page.php');   
  7.     }   
  8. }   
  9. add_action( 'load-themes.php', 'ashu_add_pages' );  
  10. //需要注意的是模板名称是 php 文件的文件名哦

好了，这样就 OK 了，当使用者激活你的主题的时候，可以默认创建一些必要的页面。