Network Tools

Looking for end-user support?
This area is for Super Administrators and others interested in the overall management of WordPress sites and networks that we host.

>> Search our end-user support documentation here.

We have built many tools on top of WordPress that are available to our users.

Below is our documentation on how to use the tools that are intended for Super Admin users.

Batch Create

Batch Create is the advanced option designed to allow Super admin users to quickly create a large number of sites or users.

For best results, use Google Spreadsheets to create your spreadsheet and then download as a .csv file.  The .csv file is uploaded to Sites > Batch Create or Users > Batch Create in the network admin dashboard.

Below are examples of how batch create can be used and what the batch create file needs to look like:

1.  Create new users and sites.
Create sites

  • site URL is myschool.com/sitename e.g myschool.com/samb18
  • If password field is left blank the user is sent an email with their username password info that includes a link to set their own password.
  • The user role on a new site must be administrator.  You can only assign a different user role when adding a user to an existing site.

2.  Create new users with preset password or auto-generated password.
Create username

  • If password field is left blank the user is sent an email with their username password info that includes a link to set their own password.
  • When site name and site title is left blank you’ll see messages after uploading the batch create file that say Empty blog name, blog title not valid and blog will not be created.  Ignore these messages and click Process Items if you only want to create usernames.

3.  Add new users to existing blogs with preset password or auto-generated password and set role.
Existing site with new users

  • The two new users are added to existing site URL myschool.com/stevep18 assigned the role of contributor or subscriber.
  • If password field is left blank the new user is sent an email with their username password info that includes a link to set their own password.

4.  Add existing users to existing sites with set role.
Existing user to a site

  • The user is added to existing site URL myschool.com/stevep18 assigned the role of contributor.

5.  Add display name when create user account.

Add Display name
  • You can set the display name when processing a batch create file for new users by adding their display name to a column after the user role.
  • You need to network activate the Display Name enhancement plugin in Plugin > Plugin Management in network admin to list the display name in Users > All Users in the dashboard of the site.  This is helpful on networks that use alphanumeric usernames as it allows an admin user to search by display name in Users > All Users in the dashboard of the site.

Using Batch Create

1.  Set up your batch create file using a Google Spreadsheet with the following header row and format:
Batch create header row

  • Needs to be written in this order –Site Name,Site Title, username, password, user email and user role (display name optional after User role column).
  • Each new user must be on a separate row and each of a users details in a new column.  Refer to the examples above to see how to add the information for each user.
  • Each user must have their own unique email address; you can’t use the same email address for more than one user or the site will be created against the first username that has been attached to that email address.

2.  Once you’ve added the sites and usernames download as a .csv file onto your computer.
CSV file

3.  Go to Sites >  Batch Create in the network admin dashboard.

Batch create

4.  Select Yes if your file has a header row.
Select Yes

5.  Select ‘No‘ for local users.

  • You only see the local user option on CampusPress networks that are set to authenticate against their single-sign on system, like Google Apps, LDAP, shibboleth, CAS.  On these networks No needs to be selected otherwise the user accounts will be created as local users and the users won’t be able to log in with their school username and password.
Local Users

6.  Select the template blog you want to use if you are using New Blog Templates.

  • The New Blog Templates tool allows Super Admins to set up blog templates that can be used for creating other blogs that are almost an exact copy of the template blog. Using blog templates, you can ensure all newly created sites have the same appearance, header image, categories, widgets, plugins and your own customized content in posts, pages and comments.
Select Template

7.  Select ‘Yes‘ if you want to add new blogs and users to a class blog.

  • You only see the class blog option on CampusPress networks that have the Classes plugin network activated.
  • This automatically connects a student blog to the class blog when their new blog is created.

Add the class blog ID by searching using the blog path.  When you type in the blog path into the ‘search by blog path’ field it automatically searches for the blog URL.

Select Class blog

8.  Upload your Batch Create file as a .csv file.
Upload batch create file

9.  Click Run Batch Create.

10.  The batch create queue will load after the batch create file has been uploaded.

11.  Check all items to confirm all details are correct.
Queue

12.  Click Process Items if all details are correct or click Clean Items if the details aren’t correct to upload a new batch create file.

Important tips:

  • Create a maximum of 100 sites or users per batch create file.  This reduces the risks of you making a mistake when creating the batch create file.
  • Start by testing batch create using 10 sites or users in your batch create file and send your batch create file to contact@campuspress.com so we can check the file has been set up properly before it is uploaded to batch create.

Cloning & Staging

Super Administrators can easily clone sites.

This can be useful for:

  • moving a site to a new URL
  • setting up a staging/testing environment
  • creating multiple sites from one template
  • keeping backup copies of important sites

How to Clone

1.  Go to the Network Admin dashboard.
Network admin dashboard

2.  Locate the site you want to clone by searching the site URL using ‘Search Sites‘ on the Right Now module.

Right now module

3. Hover the mouse over the blog URL to reveal the action menus and click on Clone.
Clone

4. Select Create a new Site and add your new site name.
Create new site

5. Add your new blog title or leave as Clone blog title.
Change blog title

6.  Click Clone Site.

Using Cloner for Staging

It is important to know that the clone tool can also overwrite any existing site.

This means that you can make a clone of an existing site, make changes on the cloned version, and then clone again back over the original.

This can be a great tool for testing theme changes or updates to sites without having to make these changes on the live site.

When making changes on the ‘staging’ site, you can temporarily change the privacy setting so that it isn’t public on the web until you are ready to push it live.

You replace an existing site as follows:
1.  Select Replace existing site.

2.  Type in the site name and it should automatically search for the site URL.
Select Replace existing site

3.  Click Clone Site.

4.  You’ll see the following message and click on Continue if you agree to permanently overwrite the contents of the existing blog.
Click Continue

New Blog Templates

The New Blog Templates tool allows Super Admins to set up blog templates that can be used for creating other blogs that are almost an exact copy of the template blog.

This tool is perfect for CampusPress networks that want to provide a standard site template for class blogs, student blogs, portfolios or course blogs.  Using blog templates, you can ensure all newly created sites have the same appearance, header image, categories, widgets, plugins and your own customized content in posts, pages and comments.

Set Up Template Blog/Site 

The first step is to create a new blog that sole purpose will be to use as the template blog.  For example, give it a URL like classtemplate, studenttemplate or portfoliotemplate.

Now log into the dashboard of the new template blog and set up the theme, header image, posts, pages, widgets and any content you want to added to all newly created blog.

Here are examples of template blogs:

  1. Mulgrave efolio template
  2. MS Digital Portfolio template
  3. Year Level Portfolio Template (class blog)
  4. Student Portfolio
  5. Staff Portfolio
  6. Honors & Scholars e-Porffolio
  7. College of Medicine Showcase Portfolio

Important tips:

  1. Template blogs must be set to “Allow search engines” or “Discourage search engines” in Settings > Reading otherwise images and media files won’t be copied to the new blogs.
  2. Changes to a template blog are only applied to new blogs created after the change is made.
  3. You can set up as many template blogs as you want and easily switch between the templates based on the type of blogs you are creating.  For example, you could have separate templates for class blogs and student blogs; or set up a series of templates for different courses.

Create Template Blog/Site

You activate your template blog as follows:

1.  Go to Blog Templates >  Blog templates in the network admin dashboard.
Blog Template

2.  Add your template name, add the blog ID by searching using the blog path, and add the template description.

  • When you type in the blog path into the ‘search by blog path’ field it automatically searches for the blog URL.
  • Once it has found the blog URL click on URL to add the blog ID.
  • For example if the blog you are searching for has a URL like http://mydomain.com/studenttemplate you would type studenttemplate.

Blog template information
You should see a number added to the blog ID when you click on the blog URL.  Each blog has its own unique blog ID.
Blog ID

4.  Select your template privacy.

  • This is the privacy that will be set on the newly created blog when it is created using the template blog.
  • If your template blog is set to “Block search engines” and you select “Keep default option’ the privacy on the new blog will be set to “Block Search engine”.
Privacy

5.  Click Create Blog template

6.  On the next screen you choose what elements of the template blog are included in all newly created blogs.  
In most situations you would select all options except for users as shown below.
Blog template options

7.  If you want to update the dates of posts and pages to the date when the new blog is created make sure you select “Update Dates”.
Update Dates

8.  You can also upload your own screenshot that users will see when choosing to a blog template on your sign up page.

9.   Click Save Template.

10.  Create a test blog by selecting the template in Sites > Add New to confirm the template blog is being applied as you wanted.  
Create a test blog

Set default template

To use a blog template as the template for all newly created blogs you need to make it the default template as follows:

1.  Go to Blog Templates >  Blog templates in the network admin dashboard.
Blog Template

2.  Hover your mouse over the title of the template that you want to use for all new blogs.

3.  Click in Make Default.
Default template

4.  You will now see Default listed next to the template name and can remove it by clicking on Remove Default.

Set Template Blogs for My Class

To display a list of template blogs in My Class > Settings that teachers can select from you need to set up blog template categories as follows:

1. Go to Blog Template > Template Categories in the network admin dashboard.

Template Category

2. Add the template category name, category description and select if you want ‘Allow teachers to choose a template from this category as a default for new student blogs’ or use the template on your sign up page then click Add Category.

Create new template category

3. When you create a new template blog in Blog Templates > Blog Templates you’ll see an option to assign a template to a template category.

Template category on a template blog

With the student template category selected a teacher now sees a default blog template they can select from in My Class > Settings and this template is applied to all student blogs when the blog is created using My Class > Create student blogs or Users > Invite Users.

Template category on a template blog

Set Template Blogs for Invite Users

You can also categorize blog templates to enable users to select from template blogs when a user creates their blog using Invite code as follows:

1. Go to Blog Template > Template Categories in the network admin dashboard.

Template Category

2. Add the template category name, category description and select if you want ‘Allow teachers to choose a template from this category as a default for new student blogs’ or use the template on your sign up page then click Add Category.

Create new template category

3. When you create a new template blog in Blog Templates > Blog Templates you’ll see an option to assign a template to a template category.

Template category on a template blog

4. Go to Settings > Join Multisite

Sign up form

5. Scroll down and select New blog templates.

Select New Blog Template

6. Click Save.

7. With the student template category selected the users now see options to select a blog template when they create a new site using Invite code (created in Users > Invite Users).

Important tips

1.  How the template is applied to the new blog

The template blog isn’t applied to the new blog until the user logs into their new blog the first time or a logged in super admin visits the new blog.  i.e. if you view the new blog as a logged out user, before the template blog has been triggered by the login process, it won’t look like your template blog and will have the default theme (the theme listed in Settings > Network Settings in the network admin).

When user logs into their new blog for the first time, or a logged in super admin visits the new blog, they will see screen that says ‘We’re setting up your new blog’ and will see information as the template blog is copied.   The user will be redirected to their dashboard once it has finished copying the template blog.
Triggering the template

2.  Switching between the templates

The default template is automatically applied to all newly created blogs.

Super admins can choose which template is used to create a new site when using Sites > Add New by selecting the desired template or when creating sites using Batch Create.
Create a test blog

You can let users select which template is applied to their blog when it is created using the sign up page by setting up the “Show template selection on registration” in Blog Templates >  Settings as follows:

1.  Go to Blog Templates > Settings
Blog template Settings

2.  Select the check box next to “Show template selection on registration”.

Show Template Selection on Registration

3.  Select type of selection you want users to see on your sign up page.
Selection option

4.  Click Save Settings.

Super Admin Scripts

Scripts in the network admin dashboard enables a super admin user to:

  1. Generate Usage Reports
  2. Batch Edit

Usage Reports

The following usage reports can be downloaded from Scripts:

  1. Sites List –  sites listed by their URL, site name, admin email address, number of users, number of posts, number of pages, created (date site created), updated (most recent date a post, page or custom post type was published or modified after publication.), privacy and status.
  2. Theme Usage – lists theme usage on all sites by URL, site name, admin email address and theme name. 
  3. Plugin Usage – lists plugin usage on all sites by URL, site name, admin email address and plugin name. 
  4. Admin List – sites listed by their URL, site name, admin email address
  5. Complete Users List – users listed by their username, email address, First name, last name, date username created, number of sites they are attached to and their authentication method.
  6. Index additional data – allows a super admin user to run a script on the options table, theme mods, custom post type, table entries count.

Reports are generated as follows:
1. Go to Dashboard > Scripts in the network admin dashboard.

Go to Dashboard Scripts

2.  Click on Run Index to Generate Reports.

  • On networks with more than 6,000 sites you need to use the Filter sites/users option to index the network in smaller batches.
  • For example, set the date range for a year and then click Run Index to Generate Reports. Click Clear Index to run the next date range once you’ve downloaded the year’s reports.
Choose date range

3.  You’ll see a progress bar while it is indexing the network.

Progress bar

4.  The reports appear once it has finished indexing.

Report options

5.  Click on the report you want to download.

6.  Open the report in your spreadsheet software and use Sort to sort the data.

Here is how to download a list of all class blogs and student blogs using the additional data option:

You can download a report that lists all your class blog URLs as follows:

1. Go to Dashboard > Scripts > Usage Reports in network admin.

2. Select Option from Index additional data and select Is_class

Is Class
  • For networks that host over 10,000 sites, we recommend you index in 1-2 year date ranges and download a series of reports.

3. Click Run Index to Generate Report.

4. Once you’ve finished indexing you click to download the Options Usage list to obtain a list of the class blog.

Download Options Usage list

You run a new report to obtain a list of student blogs attached to the class blogs via My Class as follows:

1. Click on Clear Index.

2. Select Option from Index additional data and select class_blog

Student blog

3. Click Run Index to Generate Report.

4. Once you’ve finished indexing you click to download the Options Usage list to obtain a list of the student blogs.

The student blog ID is listed in Column A under ID and the Class blog ID the student blog is attached to is listed in Column E under Data.

Student blog info

You can cross reference the Student blog data with the Class blog data to identify the class blog URL or search sites using the class blog ID.

Site search in network admin using blog ID 6 returns the following class blog URL.

Class blog info

Batch Edit

Batch edit enable you to:

  1. Bulk archive/unarchive sites.
  2. Change user roles of all sites users are member of.
  3. Remove users from all sites (but not delete them).
  4. Remove one user from a list of sites.
  5. Change user account authentication type.
  6. Change the privacy of a site.
  7. Change site theme.
  8. Activate/deactivate plugin.
  9. Remove student blogs from class.
  10. Attach sites to a class blog.

You use Batch edit as follows:
1. Go to Dashboard > Scripts in the network admin dashboard.

Dashboard Scripts

2.  Click on Batch Edit tab.

Click on Batch Edit

To remove usernames:
1. Add the usernames.

2. Select Remove users from all Sites (but not delete them) from Actions drop down menu.
Remove users

3. Click Submit.

To change themes, plugins, privacy or archive sites:
1. Add the sitenames.

  • If you use URLs it needs to be written in the form of http://myschool.com/mysite

2.  Select Archive sites, Change Privacy of a Site, Change Site theme, Activate or Deactivate plugin from the Actions drop down menu. 

  • You can’t change privacy on a site attached to a class blog via My Class.  The site needs to be removed from the class blog or the privacy needs to be changed in My Class > Settings.
Select Site option

3.  Click Submit.

Batch Add or Remove from Class blog:

You are able to either batch add a list of existing student blogs to a class blog and bulk remove student blogs from a class blog using Batch Edits in network admin.

You add student blogs to a class blog as follows:

1. Go to Dashboard > Scripts > Batch Edits in network admin.

Scripts

2. Add the sitenames, site IDs or the site URLs of the student blogs you want to attach to the class blog via My Class.

Add student blogs

3. Select Attach blogs to class from Actions drop-down menu and add the class blog ID.

Attach blogs to class

4. Add the class blog ID by searching using the blog path. When you type in the blog path into the ‘search by blog path’ field it automatically searches for the blog URL.

Search for class blog ID
  • My Class must be set up on the class blog using My Class > Create Class before it can be used as a Class blog.
  • If the student blogs are already attached to a class blog you need to first remove their blogs from that class blog before you can add their blogs to a new class blog.

Once it has found the class blog URL click on URL to add the site ID.

Confirm class blog

5. Click Submit.

You remove student blogs from a class blog as follows:

1. Go to Dashboard > Scripts > Batch Edits in network admin.

2. Add the sitenames, site IDs or the site URLs of the student blogs you want to remove from a class blog.

Add blog URLs

3. Select Attach blogs to class from Actions drop-down menu.

Remove from blog

Google Analytics

As a Super Admin, you can enable Google Analytics to track visitor data across all sites on your CampusPress network.

Once set up it automatically displays data that your users can refer to for their site in Dashboard > Statistics.

In the Network Admin dashboard, go to Settings > Google Analytics

Google Analytics settings

Google Analytics is powered by the WPMU DEV Beehive Pro plugin.

Refer to the WPMU DEV Beehive Google Analytics support documentation to set up your network wide Google Analytics account using the ‘Set up API Project‘ option.

Set up API Project

It may take 24-48 hours before stats start to appear in Dashboard > Statistics in dashboard of all sites on your network once you’ve set up the account.

Warning:

  • Please do not set up filters for GA property used for WP dashboard statistics as it may corrupt data.

Plugin Manager

Plugins > Plugin Management in the network admin dashboard is where a super admin user controls which default user plugins can be activated by admin users in Plugins in their dashboard and where plugins that need to be network activated are activated or deactivated.

Default User Plugins

You manage default user plugins as follows:

1.  Go to Plugins > Plugin Management in the network admin dashboard.
Plugin management
2.  Select All Users under Plugin Availability for any plugin you want your admin users to be able to activate.

  • It is better to set plugins to All Users so your users can activate plugins they want to use rather than use Auto-Activate (All Users).
  • Admin users don’t see plugins set to ‘Super admin user only’ in Plugins in their dashboard and the plugin can only be activated or deactivated on the site by a super admin user.

All Users
3.  Click Update Options at the bottom of the page.

For more information, refer to activating/deactivating plugins.

Network Activate Plugin

There are some plugins that need to be network activated to use. These are the plugins that have the Network Activate option in Plugins > Plugin Management in the network admin dashboard.
Classes plugin

Network Messages

Network messages is used to provide site visitors and users with helpful tips, promotion or news that can be displayed as customizable pop overs or as messages in the header or footer on the front end or inside the dashboard of all sites on your CampusPress network or on specific sites.

It can also be used to add all kinds of codes to different parts of sites.  For example, it can be used to set up Google Tag Manager.

Activate Network Messages

To use you first need to network activate network messages as follows:

1.  Go to Plugins > Plugin Management in the network admin dashboard
Plugin management

2.  Click on Network Activate next to Network Messages.
Network activate

3.  You should now see a new Messages menu item in the network admin dashboard.

Add New Message

You add a new message as follows:

1. Go to Messages > Add New in the network admin dashboard.
Add New Message

2.  Add your message.
Add your message

3.  Select your message style.
Select message style

Options are to display as:

  • Inline text in the Header, Bottom corner, Top bar or Footer bar.
  • Top Bar – Floating or Footer Bar – Floating
  • Pop-over
  • Custom HTML/CSS/JS – used for to add all kinds of codes to different parts of sites such as Google Tag Manager (refer to usage examples below). 

The color is displayed on or under the message.

Example of an inline message on the front end:
Inline Message on front end

Example of an inline message in the dashboard:
Message in dashboard

4.  Choose where you want to show the message.
Show on

Options include:

  • Dashboard
  • Front end
  • Dashboard and Front end.
  • Specific admin areas inside the dashboard.

5.  Select “Block ability to dismiss the message” if you don’t want users and visitors to dismiss it.
Dismiss message

6.  Select which users see the message.
User Type

7.  Select the priority of displaying the message.

  • Used when more than one message is created for the same location.
Priority

8. Optional:  Blog ID, Active Plugin and Active theme are used if you want to display the message on specific blog URLs only or when specific plugins or themes are activated.  Email contact@campuspress.com if you need assistance setting up these options.

9.  Select the icon you want displayed at the front of the message.
Select icon

10.  Select the Start and End date of when you want the message to appear.
Date range

11.  Optional:  CSS Styling is used to add your own styling to the message.  Email contact@campuspress.com if you need assistance with styling.  

12.  Click Save Message.

Manage Messages

Messages are managed in Messages > All Messages in the network admin dashboard.
All Messages

Hovering your mouse over a message brings up two action link menu items.
Manage messages

  • Edit: When you click on Edit it opens up the message in Edit mode where you change the content of a message or change the start/finish date of a message.  Remember to “Select to reset dismiss status. This will make users see the updated version.” if you edit a message to adjust the information displayed before you click Save Message.
  • Delete: used to remove a message.

Usage Examples

Cookie Notice

You set up a cookie notice as follows:

1. Add your message.
Add message

2.  Select Footer Bar – Floating or Footer Bar and Front end.
Footer Bar

Google Tag Manager

You can set up Google Tag Manager as follows:

1. Go to Messages > Add New.

2.  Click on Switch to HTML Editor.
Click on HTML Editor

3.  Paste the Google Tag manager header code into the HTML Editor.
Header Code

4.  Select Custom HTML/CSS/JS and Header Tag for message style then Show on Front end.
Message style

5.  Select your Start/End Date and click Save Message.

6.  Go to Messages > Add New.

7.  Click on Switch to HTML Editor.
Click on HTML Editor

8.  Paste the Google Tag manager snippet into the HTML editor.
Paste code snippet

9.  Select Custom HTML/CSS/JS and Footer for message style then Show on Front end
Footer

10.  Select your Start/End Date and click Save Message