CMS Support - KBlocks

A global KBlock is placed in a template. It shows on all pages using that template.

Example - You might have a main menu that should show on every page.

A Module KBlock is an optional KBlock. When a site contributor adds a new page, the page lists the available modules at the bottom with check boxes. Checking the box next to the desired module will automatically add it to the page in the location it was inserted into the template.

Example - You may have 3 different menus on the side navigation. The contibutor can choose which menu fits each page.

A toggle KBlock is used when some system event occurs that may need to display one of 2 results.

Example - The system allows for a "flash notice" like "Your comment was saved" among other notices. A designer is able to place the KBlock anywhere within a template.

There are multiple Toggle KBlocks:

• Flash Notices
• Logged In / Logged Out

A Component KBlock is displayed based on what type of page is being loaded such as a webpage, blog post, ecommerce product, or an external application. This is helpful for when you want to simplify the number of templates you're using, but have some slight variations between the different areas of the website.

Example - You're using the same template for products and product categories. The only difference is one displays a list while the other displays all the details for a product.  Create 2 component KBlocks and then add the appropriate KMods to each, and then add both of these KBlocks to the template.

The site KBlock is the same as the global KBlock, except that it is only available for a specific site, whereas the global KBlock is available for any site in the account. 

Example - You have content that is specific to one site, but not the others. It will still work if it's a global, but it will clutter up your KBlock page on all the sites that don't need it. 

Some websites provide content in multiple sections of each page. As a rule of thumb, it's not a good idea to include layout elements within the content in case the website template is to change in the future. With a Field KBlock you can add the field to the template and a new content field shows on every page.

Note: The Field KBlock content is not edited in the module, but on each web page.

Example - You may have a main content area and sub content area for each page.

If you need to show different content based on what role your visitor belongs to, use the Role KBlock.  If it's simply a matter of whether or not somebody is logged in, use the Toggle KBlock instead.

Example - You have 2 roles:  one for customers and one for sales people, who have access to different pages in your website. Build a menu KMod for each role and place them into separate Role KBlocks.