Open-Realty utilizes a very powerful yet easy to understand template system comprised of separate .html template files that each represent a page or complex feature of an OR web site. These templates are created using ordinary XHTML and CSS markup and can also contain jQuery/Javascript code.  There are two active templates that make-up any OR website, which ones are currently set as active is configurable via Site Config under the Template tab.


Administration area templates location:


/admin/template  


(default is: /admin/template/OR_small)


Public templates location:


/template  


(default is: /template/lazuli)


Each template stored beneath /template/ in either case is located its own unique folder.


Additionally, the template system in OR replaces curly-brace enclosed {template tags} located within the template files with the dynamically-generated content that they represent. There are numerous HTML template files used by OR to generate its content pages, all of which have shared and unique template tags available for use within them to provide a wide variety of information, data or appearance.


The template system can also leverage OR's user authentication system and provides a set of permission tags to allow you to restrict sections of your templates and web site to 3 specific user types that are logged-in: Administrators, Agents, or Members.


{check_agent}

content to display to users that are Agents.

{/check_agent}


This section of the OR documentation contains information about the various template files available in OR. Below each of the types of template files, in parenthesis you will see the path (location) of the default template files for those types so you will know where to find them if you wish to edit them or make your own. The term TEMPLATE_NAME is referring to the specific name of the template you are using per your configured Site template in OR's Site Config (Template tab). In the path for the templates FILENAME is listed in place of the specific name of the template file that is used for that template.


example:  /template/TEMPLATE_NAME/FILENAME


Each type of template page may have many different versions of that particular template file available, such as the featured listings templates. You will see these listed below each type of template along with a description of what they do. Most of the different template files that have variations can be selected in OR's Site Config. Most other OR pages only use a specific template file and others will use different template files based upon the template tag you use to call the function that uses that template.


example: The featured listing template that will be used is determined by the specific template tag used to place that feature, for example:


tag: {featured_listings_horizontal}  would load content using the template file: featured_listing_horizontal.html

tag: {random_listings_vertical} would load content using the template file: random_listing_vertical.html


To make your own template from scratch,  it may help to use one of the example templates included with OR as a guideline or example. Some knowledge of HTML markup and CSS will be required in order to create your own template, and a guide on creating or converting a public site template is provided.


A few great resources for HTML and CSS programming and debugging are listed below.


W3 Schools:

http://www.w3schools.com/

HTML validation service:

http://validator.w3.org/

Introduction to Chrome developer tools:

http://www.html5rocks.com/en/tutorials/developertools/part1/


CSS Validation service:

http://jigsaw.w3.org/css-validator/



Related Topics:
Upgrading from OR v2.x
Upgrading from existing v3.x installation
General
Upgrading/Updating Templates
Creating a public site Template
Troubleshooting templates
TEMPLATE SYSTEM LOGIC
PERMISSION TEMPLATE TAGS
Contact Agent Template Tags
FEATURED/RANDOM LISTINGS TEMPLATES
Featured/Random Template Tags
SEARCH PAGE TEMPLATES
Search Page Template Tags
STYLING DYNAMIC MENUS
JavaScript and Ajax
Single Use Hooks
Open-Realty Public Functions
License Errors