The following UW Theme 2.0 Element Conversion table depicts the completion status of certain website features, as well as migration notes for those that are migrating from UW Theme Classic to UW Theme 2.0.
If there is an existing UW Theme feature you do not see listed below and would like to understand the status or migration path, please reach out via the WiscWeb Support Request Form and we will add it to the list.
Status definitions
This is an accordion element with a series of buttons that open and close related content panels.
Completed
The feature has been reviewed and a replacement has been identified within the block editor and/or the Gutenberg theme.
In progress
The feature has been reviewed and a decision has been made about how the feature will be implemented. The build for this solution is in progress.
In review
The team is currently investigating the feature but no decisions have been made about how the feature will be implemented.
Not yet started
These features are still under consideration and development has not yet begun.
Deprecated
The team has decided not to pursue this feature in the future Gutenberg theme.
UW Theme 2.0 Element Conversion Table
| UW Theme or WiscWeb Feature | Gutenberg Status | Corresponding Gutenberg Feature (if applicable) | Notes |
|---|---|---|---|
| Accordion | Completed | UW Accordion block | Content will migrate over into the UW Accordion block but each accordion panel will contain Classic blocks that will need to be converted. Click through each accordion panel to ensure content is converted correctly. |
| Advanced Custom Fields (ACF) | Deprecated | The Gutenberg theme will not be utilizing ACF and it will not be packaged in. | |
| Alternating Content Boxes | Completed | Media and Text block patterns | Indented sub-links will not work for predefined menus. Also, predefined menu links will come over as static content. |
| Back to Top Shortcode | Completed | UW Back to Top block | |
| Buttons | Completed | Buttons block | Buttons on red, dark red, and dark gray backgrounds will automatically transition to white. If any other backgrounds are chosen and the display is not ideal, you will have to manually change them (e.g., if using a photo as a background). |
| Column layouts | Completed | Column block | One column layouts are migrated to a Columns block even though these aren't in Columns. This was a decision made to simplify how this content was migrated. |
| Custom CSS option in Customizer | Deprecated | The site-wide Theme Settings will not include a Custom CSS option | |
| Customizer Settings | Completed | UW Theme Settings | The Settings UI pulls the old Customizer data from the database, if it exists. Users will need to flip through every tab in the Settings UI to confirm everything came over correctly. |
| Document Listing | Not yet started | This feature will not be available when migrations begin. | |
| Embed Content | Completed | WP Core Embed block and variations for services like YouTube, Vimeo, Spotify. Custom embed block variation for campus-supported services such as Kaltura | These should auto-migrate as Embed blocks. Note that Airtable has been removed as an embed option due to accessibility barriers. |
| External Posts | Completed | External link field in right sidebar | |
| Fac/Staff Listing | Completed | UW People plugin and People Listing block | All images will map to the 400px square option, by default. There is no "custom" image size in UW Theme 2.0. When importing, users will need to go into each person's post type page and confirm content is migrated correctly. |
| Featured Content Block | Completed | Featured Content Cards patterns | Featured posts populated by post or page content will come over as static content. Also, users will need to manually update the content to honor equal heights. |
| Full page light gray background option from Customizer | Deprecated | The theme will not include the Customizer setting to change all pages to a light gray background by default. | |
| Gravity Forms plugin | Completed | Gravity Forms block | Users must “Convert to blocks”. Forms that have the “legacy markup” toggle enabled in the form settings will not inherit the theme styling. Manually update the setting after migration to turn off legacy markup. |
| Group of Links | Completed | UW Group of Links block; UW Links block | Group of Links that are populated via a WordPress menu will migrate in as static links. The option to use a menu in Group of Links is not something that will be accommodated at launch. Equal heights for Group of Links will not be honored in the migration. To achieve this look, users will need to add the “Text-only cards with group of links” pattern and manually add their links back. Also, Group of Links that use at least one in-page link will use the blue arrow style. Reversed group of links buttons didn't have a custom style applied on dark backgrounds in the classic UW Theme, but will appear as outlined buttons when migrated into UW Theme 2.0 |
| Hero Banner (image carousel) | Completed | UW Hero Carousel block | Hiding a hero banner image is not yet available. |
| Hero Banner (static image) | Completed | Cover block | Users will have the option to choose from a number of predefined patterns for hero/banner styles. Static hero images will get migrated to a Cover block with a Paragraph block within it. |
| Hero Carousel: Hide a hero banner | Not yet started | This feature will not be available when migrations begin. An alternative option would be to build a pattern that includes all of your possible hero carousel slides and you can place that on the page when you wish to swap out content. | |
| Hero Carousel: Randomize slide order | Completed | Users will need to manually reset this option after migration | |
| Hero with featured content inset or headline | Completed | Various banner patterns | Any hero images that use these stylistic options will not auto-migrate. Users will have the option to choose from several banner patterns when rebuilding this content. |
| Hide a Row | Completed | Hide a group | Users will need to wrap the content in a Group block and then they will have the option to hide the entire grouping. |
| Image | Completed | Image block | |
| Image and Content Carousel | Completed | UW Story Slider block | If you have any images that are in portrait orientation, this will not display well in the UW Story Slider block. We suggest cropping these to be portrait orientation and re-uploading the image. |
| Image Gallery | Completed | Gallery patterns | The UW Theme 2.0 block does not accommodate a "Title" like the UW Theme Classic did. Instead, the caption overlays the image in the main view and then disappears when the image is selected. |
| Image Only Carousel | Not yet started | This feature will not be available when migrations begin. | |
| Page Level Meta Tags | Completed | ||
| Post Listing | Completed | Posts migrate in as Classic blocks that show content as expected on the front end. Users can utilize a Post Listing pattern for display of a post list, which draws upon the Query block. If there is no featured image present on a post, there will be white space to the left of the title in the post listing view. This cannot be removed. | |
| Posts | Completed | Posts (Classic blocks wrapped in a Group block) | Posts migrate in as Classic blocks that show content as expected on the front end. Post content will be wrapped in a Group block. If users need to edit a previous post, they will have to click "Convert to blocks" on the Classic blocks. Posts that utilize the native WordPress gallery in UW Theme Classic will migrate to a standard Image Gallery block in UW Theme 2.0 after converting to blocks. Migration Station will appear in Posts in case users wish to restore the original post after making edits. |
| Related Posts | Completed | UW Featured Post | Will not auto-migrate. Users will be required to rebuild related posts on older posts if they wish for them to show up. |
| Reusable Content plugin | Deprecated | Synced patterns | The Reusable Content plugin will not be accommodated in UW Theme 2.0 or WiscWeb in the future. This content will migrate in as a shortcode on the page and you will need to manually update it. Synced patterns in the block editor can be used as an alternative approach for pulling the content into multiple places. However, you'll have to manually rebuild the content as a synced pattern. |
| RSS Feeds | Completed | RSS block | |
| Search Box Shortcode | Completed | Search Block | |
| Stylized Quote | Completed | UW Quote block | This option will accommodate both pull quotes and block quotes. This comes in with the “include citation” setting set. If you didn’t have the author set for the quote, you'll have to manually untoggle the “include citation” setting. |
| Tabbed Content | Completed | UW Tabs block | Content will migrate over into the UW Tabs block but each tab will contain Classic blocks that will need to be converted. Click through each tab to ensure content is converted correctly. |
| Text Block | Completed | Paragraph block, Heading block, List block, etc. | The Text Block allowed for a number of actions that will be split amongst several blocks in the future. Features like UW Card Style will be incorporated into patterns for ease of application. Block quotes within Text blocks will not transition automatically and will need to be rebuilt as Quote blocks. |
| Today.wisc.edu List | Completed | Today.wisc.edu block | Today URLs will need to be updated to use ‘https’ instead of ‘http.’ If using http, the content will not migrate. |
| UW Events | In Progress | UW Events plugin and related block | This plugin may not be available when migrations begin. |
| UW Publications | Not yet started | This feature will not be available when migrations begin. | |
| Widgets | Corresponding widget blocks | Widgets won't appear automatically in your post design. If users wish to display these, they can manually add the widget blocks to their primary news page or create a synced pattern for replicating on individual posts. | |
| wpDataTables plugin | Completed | Shortcode block | Users must “Convert to blocks” Users will need to select the Group block and manually set the Content Width to make it wider if the table requires it. |
| UW Language Fonts plugin | Not yet started | ||
| UW Submit to Third Party plugin | Not yet started | ||
| UW Social Share plugin | Not yet started | ||
| UW No Index plugin | Not yet started | ||
| UW KB Search plugin | Not yet started | ||
| NetID page protections | Not yet started | ||
| Custom colors and logos | In review |