Prerequisites

As Business Catalyst users ourselves, we wanted our migration system to be as seamless as possible. Anytime you are switching website platforms there will always be issues. We have identified the following issues below and how to fix them before you migrate your site. Note: These changes will not affect your client's current website. They would simply be updates to the latest BC coding practices.

Rename items with an ampersand (&)

The following items cannot use ampersands because it causes an error during migration from Business Catalyst.

• NEW - Website/Project Title
• File Names
• Page Templates
• Content Holders

Rename items with two (2) blank space in a row in the filename

The following items cannot have 2 blanks space in a row.

• File Names
• Page Templates
• Content Holders

Update file paths for external linked items in CSS/JS files, web pages, content holders and more

The Business Catalyst platform didn't recognize a difference between upper and lower case letters. BlueberryCMS is built upon a .Net platform so, the capitalization in files paths matter. For example "/_assets" is not the same as "/_Assets".

Possible locations where to look for bad file paths:

• CSS files
• Javascript files
• Page Templates
• Web Pages
• Content Holders
• Data Collections

Re-code legacy web app module tags

Legacy Web App Modules need to be converted to the newer "Named Parameters" code. Editing the web app module tags in your current website will not break your website.

For example this legacy Web App code:

{module_webapps,ID,filter,itemID,notUsed,target,bkp,results,hideEmpty,rowLength,Sort}

Needs to follow this format:

{module_webapps render="item|collection" id="webappName" filter="item" itemId="" targetFrame="" resultsPerPage="" hideEmptyMessage="false" rowCount="" sortType="ALPHABETICAL" collection="my_custom_collection_name" template="/folder/template.tpl"}

Web Forms

Action tag

Redirecting a user to a specific Web Page after they submit a Web Form has been improved. In Business Catalyst a web designer had to edit the form's "Action" tag. In BlueberryCMS we made this easier by creating a separate drop down field within a Web Form settings. This allows you to use the default web form confirmation page or a custom landing page.

Using Web Form HTML within a Web Page instead of the BC module.

Any BC Web Form HTML that is placed within a Web Page or Page Template will need to be replaced with the new HTML created in the Customize tab of the Web Form builder. You can place either the {bb_webform} module tag or copy the HTML code from the Web Form builder and paste it where you want the form to appear.

Export Secure Zone subscribers

Adobe Business Catalyst does not provide Secure Zone data to be a part of an automated migration or backup, so you will have to manually export your Secure Zone user lists.

In Adobe Business Catalyst, navigate to Site Manager > Secure Zones. Open a Secure Zone and then click the Export Report button and choose the CSV option. Save the file on your computer where you can easily access it for importing in BlueberryCMS. (See Importing Secure Zone List)