After completing this, you will understand:
What steps should you take before migrating your content into UW Theme 2.0
How to initiate the process of acquiring a Gutenberg / UW Theme 2.0 site
How to migrate your content from the classic theme into UW Theme 2.0
What happens after migrating your content in the UW Theme 2.0
How to check your migration status along the way
Most content will migrate 1-to-1 to the new theme. However, some content will require some manual effort and consideration. Please peruse the Element conversion and Service changes documentation prior to starting your migration.
Important
This process is not yet available. This documentation is being provided early so that users can understand the process that will be expected of them. Once the new process is in place, a link to request a new UW Theme 2.0 site will be added to this documentation.
The process of migrating content from the classic UW Theme into the new UW Theme 2.0 requires several steps. The WiscWeb service will require the website's Primary Contact to initiate this process. If you have any questions about setting a primary contact for a site, please reach out to our team for assistance .
The process for migrating an existing WiscWeb site is as follows:
Step 1: Watch pre-recorded training sessions We are strongly recommending that users review the pre-recorded training videos (coming soon!) prior to requesting their new site.
Step 2: Request a new UW Theme 2.0 website When we receive your request, we will take a copy of your existing WiscWeb site and place it in our new infrastructure that will host our UW Theme 2.0 websites.
Step 3: Migrating your Customizer settings In the UW Theme 2.0, the Customizer has been redesigned as "UW Theme Settings."
In the migration, you will need to follow a few simple steps to ensure this content comes over as expected:
In your new UW Theme 2.0 project, navigate to Appearance > Theme Settings
Click into every tab (Sitewide, Color, etc.) and ensure that the content listed is correct. Fill in anything that did not migrate over.
Click Save Changes on each tab to ensure the content gets updated in your new site.
Review the changes on your migrated site to confirm that everything appears as expected on the front-end.
Step 4: Migrating your users In your new project site, only users who have authored a post or page will be added during the migration (Note: They'll be added as Subscribers). Users who had access to the site but never created any content won't be added automatically. Please review the users on your site and their permissions and make adjustments as needed.
Navigate to Users
Review each user in the list
Hover over their name and click Edit to adjust their role
Find the Role dropdown and choose the role you wish for them to have (Editor, Administrator, etc.)
Scroll down to the bottom of the page and select Update User
Repeat these steps for each user on your site
If needing to add new users, follow the steps outlined in WiscWeb - Editing users
Note: Primary contact information will not be migrated. The user who requests a site will automatically be added as a primary contact, but other primary contacts need to re-apply that setting. Instructions for setting a primary contact can be found in WiscWeb - Designating a primary contact .
Step 5: Migrating page elements to UW Theme 2.0 blocks With your new UW Theme 2.0 project space, you’ll be able to work through transitioning your pages over to Gutenberg blocks.
Note: At this time, users must migrate on a page-by-page basis. This is a manual process that must be completed by site administrators and/or editors.
Open the page you want to migrate. Ensure that you are in the editing view.
There will be no content visible, but do not worry - the content hasn’t yet been migrated into UW Theme 2.0.
Locate the Settings sidebar on the right and make sure the Page tab is selected.
Scroll down to the Migration Station , expand the section, and click the Migrate button.
Your editing screen will refresh and the content will appear in various block types, including Group , Columns , and Classic .
Click Publish/Save so you do not lose your progress.
Open the Document Overview sidebar (top left corner). This should default to the List View panel, which shows the blocks that each feature has mapped to.
For each feature that maps to the Classic block, you will need to perform an additional step by selecting the content and clicking “Convert to blocks .”
Scroll down your page and look for the pink highlighted boxes that say "Classic."
Click on the box and choose "Convert to blocks."
Make sure to click into every accordion pane and tab for UW Accordion and Tab blocks.
Click Publish/Save along the way so you do not lose your progress.
Some features have a very specific migration path or will not migrate automatically. Review the Element conversion content for information about individual features.
Once you have migrated all content for a given page, make sure to update the page to denote the page as migrated .
Re-save/publish your page.
Step 4: Site re-launch in UW Theme 2.0 Once you have transitioned all of your content and everything is working as expected, the Primary Contact will need to request a new site launch (coming soon) .
Your group will be able to keep the same domain, but DNS records will need to be pointed at the new location. This process will work the same as launch requests have in the past.
Once your Gutenberg site has launched, the WiscWeb team will “unmap” your old site and publish it to a *.wiscweb.wisc.edu project domain. We’ll also archive it. In the archived state, it will no longer be editable/accessible.
After you have migrated an individual page, we encourage you to update the migration status to show this work has been completed.
Locate the Settings sidebar on the right and make sure the Page tab is selected.
Open the Migration Station panel.
Toggle the slider for “Content is reviewed after migration?”
This will update the status to: “Content is reviewed and ready”
If you are denoting your pages as migrated along the way, you’ll be able to track overall progress within the Page list.
Navigate to Pages in your dashboard menu.
In the filtering options at the top of the page, locate the All Migration Statuses dropdown.
Update the dropdown to “In Progress” and click Filter to view the pages that have yet to be migrated.
Update the dropdown to “Completed” and click Filter to view the pages that have already been migrated.
Repeat these steps for post type content like faculty/staff (known as the UW People plugin in UW Theme 2.0).
