{"id":905,"date":"2020-06-26T17:46:14","date_gmt":"2020-06-26T21:46:14","guid":{"rendered":"https:\/\/dev.ucomm.ncsu.edu\/documentation\/?page_id=905"},"modified":"2022-09-13T00:55:08","modified_gmt":"2022-09-13T04:55:08","slug":"migration-tools","status":"publish","type":"page","link":"https:\/\/dev.ucomm.ncsu.edu\/documentation\/reference\/gutenberg-upgrade-process\/migration-tools\/","title":{"rendered":"Migration Tools"},"content":{"rendered":"\n<h2 class=\"wp-block-heading\">UComm Content Converter Block<\/h2>\n\n\n\n<p>Provided by the Content Converter Add-On plugin, this block assists in auto-converting content where automatic migrations are available, as well as establishing a footprint for existing content where an equivalent block is not available. <\/p>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"761\" src=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-content\/uploads\/2020\/06\/content-converter-not-supported-1024x761.png\" alt=\"\" class=\"wp-image-917\" srcset=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-content\/uploads\/2020\/06\/content-converter-not-supported-1024x761.png 1024w, https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-content\/uploads\/2020\/06\/content-converter-not-supported-300x223.png 300w, https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-content\/uploads\/2020\/06\/content-converter-not-supported-768x571.png 768w, https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-content\/uploads\/2020\/06\/content-converter-not-supported-1536x1142.png 1536w, https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-content\/uploads\/2020\/06\/content-converter-not-supported.png 1574w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<p>For more information about how content is automatically migrated, as well as how to handle Content Converter Block messages, see the full topic on how the Content Converter Block works. <\/p>\n\n\n\n<div class=\"wp-block-ncst-button\"><a href=\"#\" class=\"btn ncst-component__button-link\" data-ncst-lightbox=\"false\" data-ua-cat=\"Button Block\" data-ua-action=\"Button Click\" data-ua-label=\"#\"><span class=\"ncst-component__button-container\"><span>UCOMM Content Converter <\/span><span class=\"nowrap\"><span>Block&nbsp;<\/span><span class=\"arrow-indicator\"> <svg class=\"wolficon\" role=\"img\" aria-hidden=\"true\"><use xlink:href=\"#wolficon-arrow-right-bold\"\/><\/svg> <\/span><\/span><\/span><\/a><\/div>\n\n\n\n<h2 class=\"wp-block-heading\">Block Stats<\/h2>\n\n\n<div class=\"wp-block-image alignright\">\n<figure class=\"size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"996\" height=\"692\" src=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-content\/uploads\/2020\/06\/Screen-Shot-2020-06-26-at-4.17.09-PM.png\" alt=\"\" class=\"wp-image-909\" srcset=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-content\/uploads\/2020\/06\/Screen-Shot-2020-06-26-at-4.17.09-PM.png 996w, https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-content\/uploads\/2020\/06\/Screen-Shot-2020-06-26-at-4.17.09-PM-300x208.png 300w, https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-content\/uploads\/2020\/06\/Screen-Shot-2020-06-26-at-4.17.09-PM-768x534.png 768w\" sizes=\"(max-width: 996px) 100vw, 996px\" \/><\/figure><\/div>\n\n\n<p>Provided by the NC&#160;State Experimental Tools plugin, this utility allows users to find pages and posts by block. This can be useful for simply seeing statistical block usage across all all available block types, but is particularly relevant to migrations as this allows users to see where exactly the Content Converter block is still in use. These usage instances mean that the page\/post contains content that was not automatically migrated and will not show up to end users. For each of these cases, content maintainers should evaluate the Content Converter block&#8217;s feedback message and determine whether to replace, ignore, or delete the content saved within that block. <\/p>\n\n\n\n<h2 class=\"wp-block-heading\">Shortcode Finder<\/h2>\n\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"581\" src=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-content\/uploads\/2020\/06\/Screen-Shot-2020-06-26-at-4.15.31-PM-1024x581.png\" alt=\"\" class=\"wp-image-908\" srcset=\"https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-content\/uploads\/2020\/06\/Screen-Shot-2020-06-26-at-4.15.31-PM-1024x581.png 1024w, https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-content\/uploads\/2020\/06\/Screen-Shot-2020-06-26-at-4.15.31-PM-300x170.png 300w, https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-content\/uploads\/2020\/06\/Screen-Shot-2020-06-26-at-4.15.31-PM-768x436.png 768w, https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-content\/uploads\/2020\/06\/Screen-Shot-2020-06-26-at-4.15.31-PM-1536x871.png 1536w, https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-content\/uploads\/2020\/06\/Screen-Shot-2020-06-26-at-4.15.31-PM.png 1974w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><figcaption>Screenshot of Shortcode Finder interface<\/figcaption><\/figure>\n\n\n\n<p>Provided by the NC&#160;State Experimental Tools plugin, this utility is similar in concept to the Block Stats utility, except that it searches solely for shortcode usage. The Shortcode Finder utility can be used to search for all supported, unsupported, and unknown shortcodes still in use on the site. Full instructions can be found on the \u2018Instructions\u2019 tab of the tool.&nbsp;<\/p>\n\n\n\n<ul class=\"wp-block-list\"><li>If supported shortcodes are found, the page\/post still needs to be converted to blocks.&nbsp;<\/li><li>If unsupported shortcodes are found, the corresponding content should be manually converted to something else or removed.&nbsp;<\/li><li>For all other shortcodes (categorized as \u2018unknown\u2019), manual review should be done to verify that the shortcode still renders as expected and isn\u2019t causing an error.&nbsp;<\/li><\/ul>\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>UComm Content Converter Block Provided by the Content Converter Add-On plugin, this block assists in auto-converting content where automatic migrations are available, as well as establishing a footprint for existing&hellip;<\/p>\n","protected":false},"author":4,"featured_media":0,"parent":893,"menu_order":2,"comment_status":"closed","ping_status":"closed","template":"","meta":{"ncst_dynamicHeaderBlockName":"ncst\/default-header","ncst_dynamicHeaderData":"{\"pageIntro\":\"In addition to the NC State Theme and related ecosystem plugins, several migration tools are available to assist in the migration process.\"}","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\/905"}],"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=905"}],"version-history":[{"count":6,"href":"https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-json\/wp\/v2\/pages\/905\/revisions"}],"predecessor-version":[{"id":3025,"href":"https:\/\/dev.ucomm.ncsu.edu\/documentation\/wp-json\/wp\/v2\/pages\/905\/revisions\/3025"}],"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=905"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}