simplifycms
  Simplify Help - A guide to using our innovations for your success.
Kyube Tags

What are Kyube Tags?
Kyube tags are a substitute for DreamWeaver tags, and allow you to define a region that can be edited and also define its access rights.
You can take control of where every single region lies in your template by inserting Kyube tags to first define a template, and then defining its inner regions as normal or shared.

Why are Regions important?

Editing
The first reason is that they allow your clients to edit certain content of the website without disturbing the design.

Access
The second reason is because you can control access rights, that is who is allowed to access and edit it.
You can more users, other than yourself to help you in building the website, but you can restrict their access.

For example, if you want to invite your secretary to help you in building some content, you have the option of giving her access only to some parts of the templates.
Or, when giving access to your customers, you can restrict their access to areas that do not affect the design of the page.
To know more about adding access rights, Click Here


 
  Image 1

Template Tags:
Template tags are meant to define the template name to which the page corresponds to.
This is done by adding the below template tag, which should be inserted in the html page, before the <head> tag:

Template Tag (page.html)

<html>
<!--{Template name="/Templates/TemplateName.html"}-->


<head>
...
Each template name should be unique.


Normal regions

A normal region is a region whose content is usually unique to a single page; that is, when changing its content, it only changes in the page where it is located. It is independent from other regions. The content of this region changes from one page to another.
Check Image 1 to see how a normal region would look like inside SimplifyEdit.

Normal region Tags:
To define a normal region, you need to wrap your code with the following tags.

Normal Region Tag (page.html)

<body>
..................

                    <!--{Section_SectionName}--><!--{NAME}-->

                          ..... Middle html code (can include pictures, links, etc….)

                    <!--{/NAME}--><!--{/Section}-->

..................
 </body>

Shared regions
Shared regions are regions that you define to be shared among pages created from one template, or even among different templates. If the customer modifies the content of a shared region then the change is automatically propagated all over the pages that have been created out of the same template.
Shared regions are ideal for the creation of menus, headers, footers, logos, copyright, etc… which are usually shared among your pages. When a shared region exists in the template, it will be created in all the pages created from this template. Consequently all the changes made to a shared region will be cascaded to its counterparts in all the pages.
Check Image 1 to see how a shared region would look like inside SimplifyEdit.

Shared region Tags:
To define a shared region, you need to wrap your code with the following tags.

Library Tag (page.html)

<body>
..................

                        <!-- {Library_NAME} -->

                                   .....   Middle html code (can include pictures, links, etc….)

                        <!--{/Library}-->

..................
 </ body>

** Make sure you substitute the above Name, SectionName, and TemplateName with the names that you wish to call your templates and regions with.
** Note that all your regions names and template names should be strictly alphaNumeric and unique.


Rules to follow in inserting tags
For those of you who would like more examples on how to insert tags and what errors to avoid, please read the below html examples. They also include tips that previous designers have commented about.

Below are some do's and dont's. In most cases, we attached example code so that you can see what’s right and what’s wrong.

  • If you have a DHTML menu that includes both JavaScript and html code, make sure to insert the tag before the JavaScript code. This will allow you to edit the properties of this menu inside SimplifyEdit.


  • Do not put a space between a < div> tag and a Kyube region tag.
  • Region Tag (page.html)

    <div id="login">[space][space][newline]
    <!--{Library_Login.lbi}--> Que Pinga | <a href="#">Agent Login</a> <!--{/Library}--> [space][newline][space]</div>

    Region Tag (page.html)

    <div id="login"><!--{Library_Login.lbi}--> Que Pinga | <a href="#">Agent Login</a> <!--{/Library}--></div>


  • A Kyube region tag should start before a <table> tag and not after it.
  • Normal Region Tag (page.html)

    <table> <tbody>
       <!--{Section_region2}--><!--{a2}-->
       <tr>
          <td>   ..... Middle html code  </td>
      </tr>

       <!--{/a2}--><!--{/Section}-->

    </tbody></table>

    Region Tag (page.html)

    <!--{Section_region2}--><!--{a2}-->
    <table> <tbody>
       <tr>
          <td>   ..... Middle html code </td>
      </tr>

     </tbody></table>

    <!--{/a2}--><!--{/Section}-->


  • A Kyube region tag can start neither after nor before a <tr> tag

  • A Kyube region tag should start after a <td> tag and not before it
  • Region Tag (page.html)

    <table> <tbody>   
       <tr>
      <!--{Section_region2}--><!--{a2}-->
          <td>   ..... Middle html code </td>
       <!--{/a2}--><!--{/Section}-->
       </tr>                  

     </tbody></table>


    Region Tag (page.html)

    <table> <tbody>
       <tr>
          <td>  

           <!--{Section_region2}--><!--{a2}-->
             ..... Middle html code
          
    <!--{/a2}--><!--{/Section}-->
           </td>
      </tr>

     </tbody></table>



  • A Kyube region tag should start outside a <ul> tag and not inside it, or inside an <li> tag
  • Region Tag (page.html)

    <ul>
       <!--{Section_region2}--><!--{a2}-->
       <li>
          .... Middle html code 
      </li>

       <!--{/a2}--><!--{/Section}-->

    </ul>

    Region Tag (page.html)

    <!--{Section_region2}--><!--{a2}-->
    <ul>
          <li>   ..... Middle html code</li> 
    </ul>

    <!--{/a2}--><!--{/Section}-->

    Region Tag (page.html)

    <ul>
          <li> 
    <!--{Section_region2}--><!--{a2}-->
            ..... Middle html code
         </li> 
    <!--{/a2}--><!--{/Section}--> 
    </ul>



  • A region should start outside p, h1, h2, and h3 tags

  • Region Tag (page.html)

    <p>
    <!--{Section_region2}--><!--{a2}-->
          .... Welcome to our site   
      
    <!--{/a2}--><!--{/Section}-->
    </p>

    Region Tag (page.html)

    <!--{Section_region2}--><!--{a2}-->
    <p>
      welcome   
    </p>

    <!--{/a2}--><!--{/Section}-->