Create / Edit Designer Region

This screen displays the Designer Region Properties.

   
 

Designer Region Name

Name: This is the unique Designer (Common) Region name.  This is the name that will be inserted into any Page Style between the <cregion></cregion> tags.

NOTE: If you change this Name, be sure to update the tag's name in the Page Styles.
 

Shared HTML Content to appear on associated Pages

Content: This is the content that will be displayed in any Page that shares the same Page Style where this Common Region's tag is placed. This content can be edited directly from the Page by any Site Designer.

NOTE: Only Site Designers can delete Designer Regions. Also, for security reasons, you cannot add PHP code to Designer Regions.

TIP: The Code Editor colorizes your code and adds line numbers to make it easier to read and debug. The Code Editor may take a while to "read" through your code and colorize it. This process is particularly slow on Internet Explorer browsers. We recommend the Firefox browser for faster editing throughout the website. It is free to download, and works on most desktop computers.

The Path Tag

The {path} tag can be inserted anywhere in your HTML and is replaced automatically with the absolute URL to the location where your system software was installed. You should always use the {path} tag if you need to reference any uploaded files within your HTML. This makes your links portable, so if you ever need to move the software system to another directory within your web server, your hand-coded links will still work.

Let's look at a typical example.

Say you want to link to a background image file (example.png) that you uploaded through the Design Files within the Control Panel. However, you want to be sure that the link is portable because your web server administrator originally installed the system software into a temporary directory that looked something like this: http://192.168.0.1/~example/software and will need to move the system software to http://www.example.com/software once you have setup your domain and are ready to launch the site.

So if you hard-code your link to example.png file like this:

http://192.168.0.1/~example/software/files/example.png or
/files/example.png

Then when the system software is moved later to another directory, this link would no longer work. So instead, be sure to link to the file using the {path} tag:

{path}files/example.png

The {path} tag is only necessary within your custom HTML such as Custom Page Styles, Editable Head Content in System Page Styles, Designer Regions, and within custom CSS files. The {path} tag is not necessary when adding links through the Rich-text Editor. These links will be converted automatically for you when the content region is saved.

NOTE: If you are the web server administrator and move the system to another directory off of your webroot after installation, be sure to update your .htaccess file per the system's installation / update instructions.