Skip to content

Go through Section Configurations

Trevor Fayas edited this page Sep 8, 2022 · 2 revisions

Once you have the Section Configuration (KX12 To 13 Converter -> Page Converter -> 2 - Section Configuration) built, you'll have to determine the conversion.

Determine Usage

You can use the below SQL statement to see where this layout widget is all used. If it's only used on one or two pages, may be worthwhile to update those pages (both on your clone and on the current site) to use a different layout tool.

declare @SectionWidgetCodeName nvarchar(100) = 'columnlayout_bootstrap'

-- In Widget Zone
select SiteDisplayName, DocumentNamePath, NodeAliasPath, DocumentCulture from View_CMS_Tree_Joined
inner join CMS_Site on SiteID = NodeSiteID
where DocumentWebParts like '%"'+@SectionWidgetCodeName+'"%'
order by NodeSiteID, DocumentNamePath

Combining / Defaulting

Keep in mind you don't need to provide a match for every layout. Sometimes you may determine that you just want to map all the various layouts into a single Page Builder Section (such as a single column bootstrap layout), or the default section. As long as the KX13 section has the same # of zones it should convert just fine.

Updating Bootstrap Versions

Many have used the Bootstrap Layout Tool in Portal Engine, and plan on continuing to use the Bootstrap Layout tool in KX13. Going from Bootstrap 3 to 4/5, or 4 to 5 has some breaking changes.

I have some baked in logic to convert your bootstrap layout tools, just add this global event hook:

PortalToMVCEvents.ProcessSection.After += ProcessSection_After_BootstrapLayout.ProcessSectionAfter_Bootstrap;

This will take any portal engine section with columnlayout and bootstrap in the code name, and convert it to either Bootstrap4LayoutTool or Bootstrap5LayoutTool as long as that's specified as the PB_Section.SectionIdentifier in the configuration.

If your Portal Engine bootstrap section contains "4" in it, it will treat it as Bootstrap 4, otherwise it will treat it as Bootstrap 3.

It will then handle most conversions, however be aware it's not a perfect science to convert Bootstrap classes, so some classes may not upgrade properly.