Quick Start Template Manual




This document describes how to get started with imCMS once you have installed the system onto your server.

Installation
Before you can start to create templates, set up properties and permissions, create new documents etc. you have to setup the imCMS server and get it running. This process Is not described in this document. We simply assume you have done that and that you have a working system on your server.

Step 1 – create at least one template
All templates in imCMS are created in HTML with a possible addition of JavaScript and/or JSP. You can use any HTML-editor at your choice to create templates – e g Dreamweaver. Or you can use a simple texteditor. All depending on your preferences. We suggest you use the default template and change it to your needs. Do the following steps:
  1. Press the adminbutton in the panel on the first page or visit http://[your.system.yy]/servlet/AdminManager
  2. Select "Templates" in the dropdown menu
  3. Select "Download", select the default template and download it to your desktop
  4. Change the default template as you prefer
  5. Upload the template into the system as a new template or replace the default template with your new template (Do not forget to keep a copy!)
  6. If you added a new template - change the appearance of the first page to your new template

What is needed in your first template?
Your template is built in HTML as any static HTML page. This means that you must use normal HTML-tags like:
<HTML>
<HEAD>
<TITLE>
<BODY>
All design/appearnce is defined by your HTML code. The content is added with imCMS-tags. E.g.
<TITLE><?IMCMS:TEXT no="1" MODE="READ"?> .- www.acme.com </TITLE>
will create an output of:
"The content in textfield 1 – www acmi.com"
in your browsers TITLE bar,

The main components of your webpage are built with:

<? imcms:text no="1"?>
The text tag creates an automatic connection to the database where all text are stored. Just enter the text tag into your layout, wherever you wish to have a possibility to enter and show text.

<? imcms:image no="1"?>
The image tag creates an automatic connection to the database where all imagereferences are stored. Just enter the image tag into your layout, wherever you wish to have a possibility to enter and show images.

<?imcms:menu no="1"?>
The menu tag creates an automatic connection to the database where all menus and the corresponding links to "child documents" are stored. Just enter the menu tag into your layout, wherever you wish to have a possibility to enter and show links to child documents.

# adminMode ## changePage #
Do not forget to use these tags in your template!
# adminMode # will automatically show the admin-panel on the page
# changePage # will show the panel when the "Appearance" button is pressed in the admin panel.

Once you have created a template with the main sections you will be able to:
  • enter and show text
  • enter and show images
  • create new documents and link to them as children in the menus
Step 2 – set up privileges (permissions)
Once you have created a template and used that template on a page, you need to setup the privileges for that page.
Use the admin panel and press "Permissions"
The role "users" is given to all users in the system, also the users that did not log in. This means that if you give the role "users" the right to read the page – any user that visits the webpage can read it.
As you are by default superadmin, you can edit every aspect of the page, without any need to set up further privileges.
If you would like an other user to be able to edit the whole, or parts of the page, you need to set up roles and privileges for that user:
  1. Create a new role – e g "editor". This is done in the super admin section of the system ("Admin" in the admin panel)
  2. Create a user and give that user the role "editor" (In super admin section)
  3. Give the role "editor" the appropriate privileges for the page the editor shall be able to edit. This is done on the page, via the "Permissions" button in the admin panel.
Please note that you only have to do this once, as every page that is created in any of the menus on that particular page, will inherit the same privileges. Or if you wish to change the heritage – you may use the function "Define for new documents" in the "Permissions" section of the page.,

Step 3 – create another template…
Now you may create as many templates as you wish, define what pages use them and enter all information you wish into the pages.
Your simple system is completed
These steps will complete a simple system that you can use to enter as much information as you wish into the system.

Advanced features
If you wish to use more advanced features, you need to fully understand the power of imCMS. Here are som examples.

<?imcms:include….. ?>
Via the include tag you can create server side includes of many types:
  • include a page into a oage
  • include jsp-code that uses the imCMS API
  • include a document with another appearance than the original appearance:
  • e g use the meny on the front page, as menu in all templates. Simply include the fiorst page in the other templates and define an appearance where only the first page menu is shown.
<?velocity?>
Use the Velocity tag to include intelligens into your template. All Velocitty code is preparsed before the imCMS tags are parsed.

mode="read"; mode = "write"
Text, image and menu tags can be defined as mode "read" or "write".
"Read" means that the content of the tag is only shown in "nomal" mode, that is none of the admin buttons have been pressed.
"Write" means that the content of the tag is only shown in "admin" mode, that is one of th of the admin buttons have been pressed.
This enables you to create separate input field, for e g flash or javascript based menues. Simply create the input ("write") in a normal, standard imCMS menu, and use the output ("read") when you need to use the data in your sepcial menu.

<?imcms:menu no="2" template="templatename"?>
The parameter "templatename" is used as defaulttemplate to all shown documents in the menu.

RSS feed
You can output the content of any menu on any page as RSS-feed. Simply use the syntax described in the imCMS on-line manual.