Build your template into Servee
To get started as quickly as possible, here is a list of things you need to know.
1. To set up a basic template, there are only two PHP tags that are required for Servee to work properly.
<% site: navigation %>
This tells the program to build the navigation in that specific location in your template. The navigation will always be displayed with a class and an ID, as follows:
<ul id="navigation" class="nav">
<li><a href="http://www.servee.com/">Servee home</a></li>
</ul>
<% page: content %>
This places the content of the given page in this location of the template.
2. Don't use relative URLs in your template.
Or at least, don't use URLs that are relative to your template folder. Since the template is pulled into the root of your site, calling the URL images/header.jpg from your template won't work. The image is actually located at /templates/Default/images/header.jpg from the root of your site, so that is the URL you need to
Calling relative links within your CSS file is fine, because those documents don't move. See our Default template for examples of this.
3. Typography.css and reset.css are pulled into the content editing window.
So if you want your big blue headings to look like big blue heading while you're editing, put your type styles in the typography.css file. Any classes you add to the typography.css file will pull into the styles menu. You'll notice that our editing toolbar doesn't contain a 'font' chooser. That was on purpose. You have complete control over the styles that you hand over to your clients to use.
So there are the basics. If you just want a simple site, this is all you need to know about your template. However, if you want dynamic sidebar items, or a header and footer that your clients can edit with Servee, read on.
4. Locations.
To add editable fields to your template, you need to add locations. You can name these whatever you would like. The names must start with a letter, and can only contain letters, numbers, and spaces. Here are some examples:
<% location: header %>
<% location: right sidebar 1 %>
<% location: right sidebar 2 %>
<% location: Under Content %>
<% location: left sidebar %>
<% location: footer %>
In the Servee template editor, you can add plain text, javascript, or Servee Modules to display blog headlines, calendar events, or image galleries. We will have some samples of Servee modules posted in the forums soon.
5. Other tags
In addition to the tags above, there are additional tags that provide dynamic functionality. You can use these in the template directly, within locations in the Servee template editor, or even in the standard content area of individual pages:
<% site: navigation %>
<% site: name %> (Name of the site, specified in the advanced editor)
<% site: root %> (Complete root of the site, for use in URLs)<% page: content %>
<% page: title %>
<% page: headline %>
<% page: subhead %>
<% page: featureMedia %>
<% page: tags %>
This is all you to build a complete template. If you have any questions, feel free to contact us or post a comment below.