{"id":886,"date":"2020-06-10T17:27:06","date_gmt":"2020-06-10T21:27:06","guid":{"rendered":"https:\/\/dev.ucomm.ncsu.edu\/documentation\/?page_id=886"},"modified":"2022-09-13T00:53:45","modified_gmt":"2022-09-13T04:53:45","slug":"upgrading-to-gutenberg","status":"publish","type":"page","link":"https:\/\/dev.ucomm.ncsu.edu\/documentation\/reference\/gutenberg-upgrade-process\/upgrading-to-gutenberg\/","title":{"rendered":"Supported and Unsupported Migrations"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">Supported Conversions<\/h2>\n\n\n\n<p>The following blocks and shortcodes are fully supported for automatic conversion in the new Gutenberg NC&#160;State Theme. Once a page or post is converted to blocks (via the Convert to Blocks mechanism), the following shortcodes and modules will automatically convert into their new block counterparts.<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-red-heading-stripes\"><table class=\"has-fixed-layout\"><thead><tr><th>Module Name<\/th><th>Block Name<\/th><\/tr><\/thead><tbody><tr><td>Text<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-theme\/blocks\/heading-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Headings<\/a>, <a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-stories\/blocks\/paragraph-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Paragraphs<\/a>, <a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-stories\/blocks\/list-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Lists<\/a><\/td><\/tr><tr><td>Events<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-theme\/blocks\/events-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Events<\/a><\/td><\/tr><tr><td>Fact<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-theme\/blocks\/big-fact-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Big Fact<\/a><\/td><\/tr><tr><td>Image Divider<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-theme\/blocks\/media-divider-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Media Divider<\/a><\/td><\/tr><tr><td>Mini Story<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-theme\/blocks\/ministory-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Mini Story<\/a><\/td><\/tr><tr><td>Linked List<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/link-list-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Linked List<\/a><\/td><\/tr><tr><td>Featured Content<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-theme\/blocks\/featured-content-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Featured Content<\/a><\/td><\/tr><tr><td>Highlight (component)<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-theme\/blocks\/ministory-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Mini Story<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<figure class=\"wp-block-table is-style-red-heading-stripes\"><table class=\"has-fixed-layout\"><thead><tr><th>Shortcode Name<\/th><th>Block Name<\/th><\/tr><\/thead><tbody><tr><td>Button<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/button-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Button<\/a><\/td><\/tr><tr><td>Giving Form<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/giving-form-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Giving Form<\/a><\/td><\/tr><tr><td>Pullquote<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-stories\/blocks\/pull-quote-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Pullquote<\/a><\/td><\/tr><tr><td>Marketing Quote<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-stories\/blocks\/testimonial-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Testimonial<\/a><\/td><\/tr><tr><td>Spotlight Box<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-theme\/blocks\/spotlight-box-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Spotlight Box<\/a><\/td><\/tr><tr><td>Toggles<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-theme\/blocks\/accordion-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Accordion<\/a><\/td><\/tr><tr><td>Video Image<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/video-image-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Video Image<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Unsupported, But Coming Soon<\/h2>\n\n\n\n<p>The following blocks do not currently have automatic conversions available, as the block equivalent version is planned but still unreleased. In these cases, you may choose to leave the content as-is (will not render) until the equivalent block is available for conversion, or select an alternative block to manually copy\/paste the old data into. This decision will likely be determined by how critical the old content in these modules was to the purpose of your page. <\/p>\n\n\n\n<figure class=\"wp-block-table is-style-red-heading-stripes\"><table class=\"has-fixed-layout\"><thead><tr><th>Module Name<\/th><th>Block Name<\/th><\/tr><\/thead><tbody><tr><td>News (RSS feed)<\/td><td><em>Coming soon<\/em><\/td><\/tr><tr><td>Link Blocks (component)<\/td><td><em>Coming soon<\/em><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\">Automatic Conversion Unsupported<\/h2>\n\n\n\n<p>The following blocks and shortcodes were previously supported in older versions of the NC&#160;State Theme, but do not have a direct equivalent in the new Gutenberg version. All content previously entered in these blocks is preserved, but will not appear as it used to. <\/p>\n\n\n\n<p>Each instance where these modules and shortcodes were used should be evaluated on a case by case basis during site review and manually migrated to another block (or deleted). The <a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/content-converter-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Content Converter Block<\/a> will help you find these unsupported bits of content and provide a copy\/paste friendly version of the data to aid in the process.<\/p>\n\n\n\n<p>Listed below are potential alternative blocks to explore.<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-red-heading-stripes\"><table class=\"has-fixed-layout\"><thead><tr><th>Module Name<\/th><th>Potential Alternative Blocks<\/th><\/tr><\/thead><tbody><tr><td>CTA Icon Block<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/fact-list-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Fact List<\/a><\/td><\/tr><tr><td>HTML<\/td><td><em>No Equivalency<\/em><\/td><\/tr><tr><td>Calendar<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-theme\/blocks\/events-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Events<\/a><\/td><\/tr><tr><td>Photo Gallery<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-theme\/blocks\/instagram-feed-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Instagram Feed<\/a><\/td><\/tr><tr><td>Single Tweet<\/td><td><em>No Equivalency<\/em><\/td><\/tr><tr><td>Storybook<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-theme\/blocks\/ministory-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Mini Story<\/a>, <a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-theme\/blocks\/featured-content-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Featured Content<\/a>, <a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-stories\/blocks\/heading-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Headings<\/a>\/<a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-stories\/blocks\/paragraph-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Paragraphs<\/a><\/td><\/tr><tr><td>Featured Content (Component version)<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-theme\/blocks\/featured-content-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Featured Content<\/a><\/td><\/tr><tr><td>Newswire Feed<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-theme\/blocks\/automated-posts-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Automated Posts<\/a>, <a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-theme\/blocks\/featured-content-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Featured Content<\/a><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<figure class=\"wp-block-table is-style-red-heading-stripes\"><table class=\"has-fixed-layout\"><thead><tr><th>Shortcode Name<\/th><th>Potential Alternative Blocks<\/th><\/tr><\/thead><tbody><tr><td>Box<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/platforms\/nc-state-theme\/blocks\/spotlight-box-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Spotlight Box<\/a><\/td><\/tr><tr><td>Responsive Iframe<\/td><td><em>No Equivalency<\/em><\/td><\/tr><tr><td>Retina Image<\/td><td><a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/image-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Image<\/a><\/td><\/tr><tr><td>Social Box<\/td><td><em>No Equivalency<\/em><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<p>For more information about how to handle unsupported migration content, see the full <a href=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/content-converter-block\/\" target=\"_blank\" rel=\"noreferrer noopener\">Content Converter Block<\/a> topic. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Need help?<\/h2>\n\n\n\n<p>Have questions? Feel free to reach out with any questions or concerns at\u00a0<a href=\"http:\/\/go.ncsu.edu\/ucomm-dev-request\">go.ncsu.edu\/ucomm-dev-request<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Supported Conversions The following blocks and shortcodes are fully supported for automatic conversion in the new Gutenberg NC&#160;State Theme. Once a page or post is converted to blocks (via the&hellip;<\/p>\n","protected":false},"author":4,"featured_media":0,"parent":893,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"ncst_dynamicHeaderBlockName":"ncst\/default-header","ncst_dynamicHeaderData":"{\"pageIntro\":\"When converting between an old version of the UComm NC State Theme and the new Gutenberg version, certain modules support automatic conversion to block counterparts, while other data may need to be manually converted. \"}","ncst_content_audit_freq":"","ncst_content_audit_date":"","footnotes":"","_links_to":"","_links_to_target":""},"acf":[],"_links":{"self":[{"href":"https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-json\/wp\/v2\/pages\/886"}],"collection":[{"href":"https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-json\/wp\/v2\/users\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-json\/wp\/v2\/comments?post=886"}],"version-history":[{"count":8,"href":"https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-json\/wp\/v2\/pages\/886\/revisions"}],"predecessor-version":[{"id":3022,"href":"https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-json\/wp\/v2\/pages\/886\/revisions\/3022"}],"up":[{"embeddable":true,"href":"https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-json\/wp\/v2\/pages\/893"}],"wp:attachment":[{"href":"https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-json\/wp\/v2\/media?parent=886"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}