This site is now out of date, and currently exists here as an archive only.

Mentor Web Blocks is still under development.

Please click here to view the latest version.

Getting started for developers

Installation

First off visit http://webblocks.codeplex.com/ and download the latest stable release.

Installation of Mentor Web Blocks is very much the same as any other package. Go to the developers section within the back office and expand packages then choose 'install local package'. Select the web blocks zip file you downloaded and follow the install instructions.

After installation you will be presented with instructions to update your web.config.

What's next?

If it is your first time using web blocks you will want to check out examples, api reference and possibly the getting started for content editors.  There is also a more advanced topic on how to set up a site search with Examine and Mentor Web Blocks.

Essentials

When developing with Web Blocks the following points are very important to know and are essentially must do's.

Always use WebBlocks.GetCurrentNode() and not Node.GetCurrent()

This is because if you use the latter your block will not render as expected within the back office layout builder.

Naming of block types

Always name your block types macro scripts and document type aliases the same. For example if you have a block type named 'Feature Block' then make sure your macro used for rendering has the same name. This is so that the Web Blocks rendering layer knows what to use to render a block type.

Layout Builder = LayoutContent in templates

For the backend layout builder to pick up your template layouts you must use/name a Content Place Holder as LayoutContent, in which you would then place your containers and pre-defined blocks for use on that template.

Share this page:
Subscribe: