X

How To Create a Page When the Theme Is Activated

Snippets by IsItWP

Ever wanted to make a theme that creates a page when the theme is activated? This snippet will allow a theme you are making to create a custom page or pages when the theme is activated.

Instructions

All you have to do is add this code to your theme’s functions.php file or in a site-specific plugin:

if (isset($_GET['activated']) && is_admin()){

	$new_page_title = 'This is the page title';
	$new_page_content = 'This is the page content';
	$new_page_template = ''; //ex. template-custom.php. Leave blank if you don't want a custom page template.

	//don't change the code bellow, unless you know what you're doing

	$page_check = get_page_by_title($new_page_title);
	$new_page = array(
		'post_type' => 'page',
		'post_title' => $new_page_title,
		'post_content' => $new_page_content,
		'post_status' => 'publish',
		'post_author' => 1,
	);
	if(!isset($page_check->ID)){
		$new_page_id = wp_insert_post($new_page);
		if(!empty($new_page_template)){
			update_post_meta($new_page_id, '_wp_page_template', $new_page_template);
		}
	}

}

Note: If this is your first time adding code snippets in WordPress, then please refer to our guide on how to properly copy / paste code snippets in WordPress, so you don’t accidentally break your site.

If you liked this code snippet, please consider checking out our CSS Hero Review.

Comments  Leave a Reply

  1. Thanks. I exactly need this. Let me know with which hook, This code should be hooked?

  2. Thanks man! U have solution for insert auto taxonomies?

  3. Hi in my plugin automatic page generated and short code also automatic generated. i want in detail page no need to display header footer and sidebar.. any idea please ?

  4. Hi Kevin. How to create multiple pages with this method?Thankss..

  5. I don’t suppose there’s a way of directing users to the page after activation is there no matter what permalnk they have set is?

    I wanted to use this to create a theme FAQ page and direct the user to it after activation.

    1. I’m don’t think that is the best way to do things what you could do is create an admin page much like people do when they create a plugin and add your FAQ or other details in that. This tutorial on net.tuts has details about creating the admin panel for a plugin but the idea is the same.

      http://net.tutsplus.com/tutorials/wordpress/creating-a-custom-wordpress-plugin-from-scratch/

      1. Yeah You’re probably right. I’m using a child theme for Twenty Eleven and haven’t figure out how to hook into the current theme options yet. I’ll probably just create a html page with the info I need on it and link it but will check that link out, thanks

        1. Hi Zeaks,

          The tutorial I posted should work fine! Should not matter the theme
          you are using, the code in the tutorial will just have you add code to
          your functions.php to create the admin panel then it is just html to
          style and display your faq or other information.

    2. I’m don’t think that is the best way to do things what you could do is create an admin page much like people do when they create a plugin and add your FAQ or other details in that. This tutorial on net.tuts has details about creating the admin panel for a plugin but the idea is the same.

      http://net.tutsplus.com/tutorials/wordpress/creating-a-custom-wordpress-plugin-from-scratch/

  6. Nice! Big thanks!
    Just used your code to add menu items as well.
    (‘post_type’ => ‘nav-menu-item’)

    1. Hi Tyson, Cool glad I could help. Don’t forget to follow on twitter, facebook or RSS I post new snippets regularly.

  7. Cliff Paulick July 19, 2011 at 6:56 pm

    Sorry if a dumb question, but why would you want to do this?
    I have a test WP installation where I manually create a new post (or sometimes a page) whenever I activate a new plugin – to test out what it can do. I can see the benefit of a page/post generator for that action, but I’m not sure why a new page for activating a theme. Please help me understand. Thanks!

    1. No such thing as a dumb question on wpsnipp, this is a good question. Lets say that I have a new theme that will function more like a CMS with a default static front page. You could use this in your theme to create the needed pages for the person rather then asking them to do it by hand. This way I could create any number of pages needed for a theme I was creating then all the person would need to do is link pages to templates required. But this is just one example could be reasons we can’t even think of.

      1. How I add this new page created by your code in main menu. (‘post_type’ => ‘nav-menu-item’) not working for me

    2. This is kind of old, but for me I am making a theme and setting up a custom page that will make a site map, and I want to link to that sitemap in the footer.

      This is a great bit of code, it lets me know for sure that this sitemap page will be there all the site.

  8. Tweets that mention Wordpress Create page on theme activation – wpsnipp.com Wordpress code snippets for your blog -- Topsy.com November 24, 2010 at 4:32 pm

    […] This post was mentioned on Twitter by wp_freak, WPSNIPP. WPSNIPP said: #wordpress Create page on theme activation http://bit.ly/gTZHVl #blog please RT 🙂 […]

Add a Comment

We're glad you have chosen to leave a comment. Please keep in mind that all comments are moderated according to our privacy policy, and all links are nofollow. Do NOT use keywords in the name field. Let's have a personal and meaningful conversation.

WordPress Launch Checklist

The Ultimate WordPress Launch Checklist

We've compiled all the essential checklist items for your next WordPress website launch into one handy ebook.
Yes, Send Me the Free eBook!