Boilerplate Extension

The MainWP Boilerplate Extension gives you the ability to easily create repetitive pages or posts on your child sites.

Using the available placeholders (Tokens), these pages can be customized for each site without needing to be rewritten. The Boilerplate extension is the perfect solution for commonly repeated pages such as:

• Privacy Policy
• About Us
• Terms of Use
• Support Policy

or any other page with standard text that needs to be distributed across multiple websites.

How does the Boilerplate Extension Work?

After installing the extension, you can create custom placeholders (Tokens) that you will need in your commonly used pages and posts. For each of your child sites, add values for the tokens. When you are done with the setup, you can create one page with these placeholders and post it to all wanted sites. On each child site, the placeholders will be replaced with the custom values for the site.

All your Boilerplate Pages and Posts will be saved and fully editable. With just a few clicks, you will be able to tweak a page on all your sites at once.

Boilerplate Tokens

Boilerplate pages use tokens to be customized for each site without needing to be rewritten. Basically, in the source post, instead of using actual data, you can place tokens. After publishing, tokens will be replaced by actual values on each child site.

The MainWP Boilerplate extension comes with a set of default tokens and the ability to create custom tokens.

For both default and custom tokens, it is required to set values for each child site individually, which will replace the token on child sites after publishing a boilerplate post or page.

Default Boilerplate Tokens

After installing the MainWP Boilerplate Extension, on the MainWP > Extensions > Boilerplate > Custom Tokens page, you will be able to see the section with available tokens.

Along with a token, on the right-hand side, you can see the token description so you can get an idea of what to use it for.

Set Values for Default Tokens

1. Login in to your MainWP Dashboard
2. Go to the MainWP > Sites > Manage page
3. Locate one site and click the Edit action
4. Locate the Boilerplate Settings section
5. Enter values for tokens that you intend to use
6. Click the Update Site button
7. Repeat steps 3 – 6 for the rest of your child sites

Custom Boilerplate Tokens

Along with the set of default tokens, the MainWP Boilerplate Extension allows you to create your custom tokens.

Create Custom Tokens

1. Login in to your MainWP Dashboard
2. Go to the MainWP > Extensions > Boilerplate > Custom Tokens page
3. Click the Create Custom Token button
4. Modal will show
   1. Add Token Name
   2. Add Token Description
   3. Click the Save button

After saving the new token, the token will appear in the Tokens table. From here, you can Edit or Delete it.

Also, from this moment, the token will be added to the Boilerplate Settings option box on the child site edit page, where you can set values for the token.

Set Values for Custom Tokens

1. Login in to your MainWP Dashboard
2. Go to the MainWP > Sites > Manage page
3. Locate one site and click the Edit action
4. Locate the Boilerplate Settings option box
5. Enter values for tokens that you intend to use
6. Click the Update Site button
7. Repeat steps 3 – 6 for the rest of your child sites

Boilerplate Posts

After publishing a boilerplate post on your child sites, the post looks normal, just like any other WordPress post. After it’s created, the post will be visible normally in the WP > Posts > All Posts page on child sites.

However, on the MainWP Dashboard side, the list of created Boilerplate posts is available in the MainWP > Extensions > Boilerplate page, in the Boilerplate Posts tab.

From here, you can Edit and Delete Boilerplate posts.

Create Boilerplate Post

1. Login in to your MainWP Dashboard
2. Go to the MainWP > Posts > Add Boilerplate page
3. Compose the post as any other WordPress post, but in the post body, you can use tokens where needed.
   Tokens are allowed in Post Title and in the Post Boddy.
4. Select your Child Sites where you want to publish this post
5. Click the Publish button

How to insert Tokens

Tokens can be inserted manually by typing the token where it’s needed or by clicking on a token in the Tokens meta box. After clicking on a token, the token will be inserted in the post automatically.

Edit Existing Boilerplate Post

1. Login in to your MainWP Dashboard
2. Go to the MainWP > Extensions > Boilerplate > Boilerplate Posts page
3. Click the Edit action in the actions menu
4. Edit the post content or meta values
5. Click the Update button

After clicking the Update button, updates will be applied to all child sites.

Add Existing Boilerplate Post to a New Site

If you have a Boilerplate post that you want to add to a newly connected child site, you can do that by following these steps:

1. Login in to your MainWP Dashboard
2. Go to the MainWP > Extensions > Boilerplate > Boilerplate Posts page
3. Click the Edit action in the actions menu
4. Locate the Select Sites section
5. Select the new Child Site
6. Click the Update button

After clicking the Update button, the boilerplate post will be added to new sites.

Remove a Boilerplate Post from a Child Site

If you have a Boilerplate post that you want to remove from one or multiple child sites, you can do that by following these steps:

1. Login in to your MainWP Dashboard
2. Go to the MainWP > Extensions > Boilerplate > Boilerplate Posts page
3. Click the Edit action in the actions menu
4. Locate the Select Sites section
5. Unselect wanted sites
6. Click the Update button

After clicking the Update button, the boilerplate post will be removed from the unselected child sites.

Delete a Boilerplate Post

1. Login in to your MainWP Dashboard
2. Go to the MainWP > Extensions > Boilerplate > Boilerplate Posts page
3. Click the Delete action in the actions menu

Important Notes

After clicking the Delete action, the boilerplate post will be removed from the extension database, but the actual posts will stay on your child sites.

Boilerplate Pages

After publishing a boilerplate page on your child sites, the page looks normal, just like any other WordPress page. After it’s created, the page will be visible normally in the WP > Pages > All Pages page on child sites.

However, on the MainWP Dashboard side, the list of created Boilerplate pages is available in the MainWP > Extensions > Boilerplate page, in the Boilerplate Pages tab.

From here, you can Edit and Delete Boilerplate pages.

Create a Boilerplate Page

1. Login in to your MainWP Dashboard
2. Go to the MainWP > Pages > Add Boilerplate page
3. Compose the page as any other WordPress page, but in the page body, you can use tokens where needed.
   Tokens are allowed in Page Title and in the Page Boddy.
4. Select your Child Sites where you want to publish this page
5. Click the Publish button

How to insert Tokens

Tokens can be inserted manually by typing the token where it’s needed or by clicking on a token in the Tokens meta box. After clicking on a token, the token will be inserted on the page automatically.

Edit Existing Boilerplate Page

1. Login in to your MainWP Dashboard
2. Go to the MainWP > Extensions > Boilerplate > Boilerplate Pages page
3. Click the Edit action in the actions menu
4. Edit the page content or meta values
5. Click the Update button

After clicking the Update button, updates will be applied to all child sites.

Add Existing Boilerplate Page to a New Site

If you have a Boilerplate page that you want to add to a newly connected child site, you can do that by following these steps:

1. Login in to your MainWP Dashboard
2. Go to the MainWP > Extensions > Boilerplate > Boilerplate Pages page
3. Click the Edit action in the actions menu
4. Locate the Select Sites section
5. Select the new Child Site
6. Click the Update button

After clicking the Update button, the boilerplate post will be added to new sites.

Remove a Boilerplate Page from a Child Site

If you have a Boilerplate page that you want to remove from one or multiple child sites, you can do that by following these steps:

1. Login in to your MainWP Dashboard
2. Go to the MainWP > Extensions > Boilerplate > Boilerplate Pages page
3. Click the Edit action in the actions menu
4. Locate the Select Sites section
5. Unselect wanted sites
6. Click the Update button

After clicking the Update button, the boilerplate page will be removed from the unselected child sites.

Delete a Boilerplate Page

1. Login in to your MainWP Dashboard
2. Go to the MainWP > Extensions > Boilerplate > Boilerplate Pages page
3. Click the Delete action in the actions menu

Important Notes

After clicking the Delete action, the boilerplate page will be removed from the extension database, but the actual pages will stay on your child sites.