WiscWeb - WordPress UW Theme - Migrating a Site from WiscWeb to Web Hosting
This document will walk you through the steps required to migrate your WiscWeb site over to DoIT Web Hosting. It includes instructions for creating an export of your site, importing that into the new environment, and basic setup tips for things like Shibboleth.
- Important Considerations
- Requesting a New WordPress Site from Web Hosting
- Installing WordPress on Your New Site
- Adding the UW Theme to Your New Site
- Updating Your Version of the UW Theme
- Adding New Users to Your New Site
- Creating an XML Export of Your WiscWeb Site
- Importing the XML File into Your New Site
- Re-Creating Customizer and Menu Content in Your Site
- Requesting Custom Development
We ask that you please consider the following before migrating your site into the DoIT Web Hosting environment:
- This is a provided platform for hosting applications. You will have tools to publish and manage the site via an administrative control panel and Secure FTP access to a filesystem. Unlike in WiscWeb, updates to things like plugins, WordPress Core, and the UW Theme will all need to be maintained/performed by you/your team. More information can be found here:
- While you do have the flexibility to add more plugins and themes to this environment (as well as hosting other applications), we would caution against taking on too many. Plugins can easily become unwieldy and cause conflicts on your site if not well-maintained or developed by untrustworthy sources.
- There is a fee associated with hosting a WordPress site in Web Hosting. Most groups go with the Nickel account, which is outlined on their it.wisc.edu services page.
- The plugins that came standard with WiscWeb will not be available in your Web Hosting account. If you decide to use any plugins, they will have to be purchased by your department.
- By default, DoIT Web Hosting provides NetID login integration services and your site will already be NetID Login capable: Web Hosting - Using NetID or Wisconsin Federated login
- We recommend downloading and installing the WordFence plugin, to offer more security for your Web Hosting site.
- Using a Shibboleth plugin for NetID login is optional. Configuration information can be found at: Web Hosting - WordPress NetID Login via Shibboleth
Make sure to do the following before you request your account:
- Decide on a Domain Name(You may already have one and that is ok. You can use the same domain on your Web Hosting site).
- Obtain a DoIT Billing Number from your department’s billing/accounting office (For covering the monthly fee).
Wordpress is a PHP web application built on a MySQL database. Each Web Hosting customer is provided tools to upload files via Secure FTP and to create their own MySQL database. You can perform one-click installs of WordPress and manage other functions of the account through the Administrative Control Panel (known as Plesk).
For more information, please reference the following KnowledgeBase articles:
- Web Hosting - Wordpress Development
- Web Hosting - Managing MySQL Databases
- Web Hosting - Guide for Using Open Source Packages
- Web Hosting - Wordpress Security with WordFence
The UW Theme will need to be downloaded and added to your new Web Hosting site. You will also be responsible for ongoing maintenance of this theme, which primarily involves keeping it updated with the latest version.
- Navigate to the UW Theme website
- Click the Download UW Theme button
- Review the guidelines for using the UW Theme
- Fill out the form (Name, Email, URLs this theme will be used for) and press Submit
- A .zip download of the UW Theme should begin shortly
- In your new project, navigate to Appearance > Themes > Add New
- Upload your UW Theme .zip file Navigate to Appearance > Themes and hover over the newly installed UW Theme.
- Click Activate
The UW Theme is updated roughly every other month. It is important that you keep your new site up-to-date with the latest version to avoid potential bugs/conflicts and to ensure you have the most recent styles and functionality.
Keeping your version of the UW Theme up-to-date is as simple as fetching the most recent version from the UW Theme website and following the instructions above to re-upload it to your project. WordPress will automatically recognize that this file is meant to replace the existing version and therefore, no deactivation of the old version is required.
To learn about when the theme has been updated and what the releases include (in terms of fixes, additions, etc.), we highly recommend joining the campus WordPress user list. To join, send a blank email to email@example.com.
Adding users to your new Web Hosting site is similar to how it worked in WiscWeb. We recommend completing this step before importing the contents of your site so that you can attribute posts and pages to specific content creators/users.
- Navigate to Users
- Select Add New
- If the user that you wish to add already exists within a multisite, you can add them to this site by entering their email address or current username and selecting what role you wish to apply, and click Add Existing User.
- If the user does not exist within the system yet, you can create their account for them by entering a username (which cannot be changed), an email address, and selecting what role you want to apply, and then click Add New User.
When you are ready to migrate your site into your new WordPress environment, you can easily create an export using the native XML exporter function.
- Navigate to Tools > Export
- Keep the All Content radio button selected (unless you only want to export certain pages, posts, etc.)
- Choose the Download Export File button
- Save the file somewhere locally for easy access
To import your XML file into your new Web Hosting site, follow these steps:
Installing the WordPress Importer Plugin
- Navigate to Tools > Import in your new site
- Click on the WordPress link in the list of importers
- Click Install Now
- Click Activate Plugin & Run Importer
Running the Importer
- Select the Choose File button
- Select your XML export file from where you saved it
- Choose Upload File and Import button
- You will be asked to re-attribute existing content to users on your site. Make sure you’ve already added your users using the steps above. Choose the existing user from the dropdown that you’d like to assign the content to (do this for each Import Author listed)
- Select Download and Import File Attachments(this ensures that your post/page images come over with the import)
- Click Submit
It is important to note that there is a good chance that some content will not make it over to your new Web Hosting project and will need to be rebuilt. This could include full pages/posts, but primarily, these are the items that you will have to recreate:
In the UW Theme, your home page is set in the Customizer. This data does not carry over and will need to be reset after import. For this, navigate to Appearance > Customize and choose the Homepage Settings option. Under the Homepage dropdown, choose the page you'd like to set as the homepage and click the Publish button.
Any information set in the Customizer section of the UW Theme will not carry over. This content will need to be recreated by navigating to Appearance > Customize and retyping the info. This includes things like footer content, Google IDs for analytics and search, menus, homepage settings, and site-wide color settings.
Most images/docs will likely carry over, but some may need to be re-saved to your Media Library. If you notice something is missing, you will need to save them from your old site (by downloading directly from the page and saving locally) and bulk upload them to your new site.
You will also need to update the media on all pages as it is likely referencing an old URL. To do so, navigate to the page and remove the link or image. Go into the Media Library, find that file, and re-add it to your page.
Your navigation menus will need to be recreated in your new Web Hosting site. Most pages should still exist but you will need to create a new Main Menu, the Utility Menu (if applicable), and any Group of Links or other menus.
If you require custom development for your project, please reach out to the WPS Client Engagement team to start a discussion of your needs.
I want my new Web Hosting site locked to NetIDs/a Manifest Group. How do I request this?
If you would like standard NetID protection added to your site, please send Web Hosting an email and include your site URL.
If you would like to add Manifest Group to your site, please follow the steps detailed in Web Hosting - Manifest Group Protections.
How do I integrate NetID login via Shibboleth?
Instructions can be found in Web Hosting - WordPress NetID Login via Shibboleth. (Note: WiscWeb uses the CALS Shibboleth plugin)
I’m interested in a multi-site instance of WordPress. How do I request that?
This can be accomplished by requesting to have additional domains added to your account and specifying that you would like them resolved to the WordPress multi-site location.
How do I secure my WordPress site?
We ask that you please make use of the WordFence plugin for adding security/protection to your WordPress site in Web Hosting: KB link doc