There are 6 main templates used by the program that can be customized to match the look and feel of your site. These files aren't displayed directly on your site but rather are used as templates to "publish" additional files that are.
_publish_homepage.html Homepage Template _publish_homepage_index.html Homepage Index Template _publish_listing.html Listing Template _publish_listing_index.html Listing Index Template _search_query.html Search Engine Query Page _search_results.html Search Engine Results Page
The templates for your industry are located in a subfolder of the "templates" directory (/listman/templates/[industry]). The subfolder is named appropriately for your industry (_auto, _generic, or _realty). You ONLY need to edit the templates for your selected industry.
When editing these template files we recommend you use a text based HTML editor. The templates use special tags to define and insert information and using a WYSIWYG HTML editor can be problematic. Some of them add and remove code that can interfere with the template contents.
Each template has a number of variables or "placeholders" that can be inserted to
tell the program what information to insert in the published page. A
placeholder looks like this $name$, a word or series
or letters and number surrounded by two dollar signs. Another way that placeholders
are sometimes displayed in the source code is by using a special tag so the
actual placeholder isn't visible when viewing the template, like this:
<!-- template insert : $name$ -->
You need to append special suffixes to placeholder names when using them in certain HTML constructs.
In links, append _ue
<a href="$hfield5_ue$">
In form values, append _he
<input name="x" value="$hfield5_he$">
In javascript, append _je
<script>document.write("$hfield5_je$");</script>
In addition, some templates use templatecells. A templatecell is a block of HTML
that can be displayed or not displayed. An example of this is on the user homepage
where if the user has uploaded any images they will be displayed, otherwise
some "no image available" text is displayed in their place.
Below is a list of all the available placeholders and templatecells for each template in Listings Manager.
_publish_homepage.html
This template is used to create an individual page for each user who has an account setup in Listings Manager. This page contains all the information about that user and up to 10 photos.Placeholders available on this page:
$cgiurl$ - script filename (for use in form tags)
$homepage_url$ - URL of homepage directory
$listing_url$ - URL of listing directory
$search_url$ - URL of search engine
$search_homepage_url$ - URL of search homepage engine addon
$images$ - list of images (made of templatecell content)
$file$ - image filename (used in "image" templatecell)
$desc$ - caption (used in "image" templatecell)
$thumbnail$ - thumbnail filename (used in "image" templatecell)
$thumbnail_width$ - width of thumbnails (used in "image" templatecell)
$thumbnail_height$ - height of thumbnails (used in "image" templatecell)
$user_num$ - homepage user number
$user_name$ - homepage user name
$user_file$ - homepage user homepage filename
$hfieldX$ - homepage field X, where X is a number from 1 to 50
Templatecells on this page:
image - displayed for each homepage images
no_images - displayed if there are no homepage images
_publish_homepage_index.html
This template is used to create an index or listing of all the user homepages. This page contains a summary and link to each homepage along with an optional picture.Placeholders available on this page:
$cgiurl$ - script filename (for use in form tags)
$homepage_url$ - URL of homepage directory
$listing_url$ - URL of listing directory
$search_url$ - URL of search engine
$search_homepage_url$ - URL of search homepage engine addon
$list$ - list of users (created using templatecells)
$file$ - preview image filename (used in "user_image" templatecell)
$thumbnail$ - preview thumbnail filename (used in "image" templatecell)
$thumbnail_width$ - width of thumbnails (used in "image" templatecell)
$thumbnail_height$ - height of thumbnails (used in "image" templatecell)
$user_num$ - user number
$user_name$ - user name
$user_file$ - user homepage filename
$hfieldX$ - homepage field value of field X, X is a number from 1 to 50
Templatecells on this page:
user_image - displayed for users with a preview image
user_noimage - displayed for users with no preview image
_publish_listing.html
This template is used to create an individual page for each listing created in Listings Manager. This page contains all the information about that listing and up to 10 photos.Placeholders available on this page:
$cgiurl$ - script filename (for use in form tags)
$homepage_url$ - URL of homepage directory
$listing_url$ - URL of listing directory
$search_url$ - URL of search engine
$search_homepage_url$ - URL of search homepage engine addon
$images$ - list of images (created using templatecells)
$file$ - image filename (used in "image" templatecell)
$thumbnail$ - thumbnail filename (used in "image" templatecell)
$thumbnail_width$ - width of thumbnails (used in "image" templatecell)
$thumbnail_height$ - height of thumbnails (used in "image" templatecell)
$listing_num$ - listing number
$listing_file$ - listing filename
$lfieldX$ - listing field value of field X, X is a number from 1 to 75
$user_num$ - user number
$user_name$ - user name
$user_file$ - user homepage filename
$hfieldX$ - homepage field value of field X, X is a number from 1 to 50
Templatecells on this page:
image - displayed for each homepage images
no_images - displayed if there are no homepage images
_publish_listing_index.html
This template is used to create an index or listing of all the listings. This page contains a summary and link to each listing along with an optional picture.Placeholders available on this page:
$cgiurl$ - script filename (for use in form tags)
$homepage_url$ - URL of homepage directory
$listing_url$ - URL of listing directory
$search_url$ - URL of search engine
$search_homepage_url$ - URL of search homepage engine addon
$list$ - list of images (created using templatecells)
$file$ - image filename (used in "listing_image" templatecell)
$thumbnail$ - thumbnail filename (used in "image" templatecell)
$thumbnail_width$ - width of thumbnails (used in "image" templatecell)
$thumbnail_height$ - height of thumbnails (used in "image" templatecell)
$listing_num$ - listing number
$listing_file$ - listing filename
$lfieldX$ - listing field value of field X, X is a number from 1 to 75
$user_num$ - user number
$user_name$ - user name
$user_file$ - user homepage filename
Templatecells on this page:
listing_image - displayed for each homepage images
listing_noimages - displayed if there are no homepage images
_search_query.html
This template is used to display the initial search page allowing the user to search for listings that match specific criteria. This page displays the search options and controls how the search engine works.Placeholders available on this page:
$cgiurl$ - script filename (for use in form tags)
$homepage_url$ - URL of homepage directory
$listing_url$ - URL of listing directory
$search_url$ - URL of search engine
$search_homepage_url$ - URL of search homepage engine addon
$userlist$ - list of all user names for use in pulldown menu, eg:
<select name="user_match">
<option value="">Any Agent
$userlist$
</select>
Templatecells on this page:
There are no templatecells on this page
_search_results.html
This template is used to display the results found by the search engine. This lists a brief description for each listing, an optional image and a link to the full listing page.Placeholders available on this page:
$cgiurl$ - script filename (for use in form tags)
$homepage_url$ - URL of homepage directory
$listing_url$ - URL of listing directory
$search_url$ - URL of search engine
$search_homepage_url$ - URL of search homepage engine addon
$list$ - list of results on this page (created using templatecells)
$file$ - preview image filename (used in "*_image" templatecells)
$thumbnail$ - preview thumbnail filename (used in "image" templatecell)
$thumbnail_width$ - width of thumbnails (used in "image" templatecell)
$thumbnail_height$ - height of thumbnails (used in "image" templatecell)
$listing_num$ - listing number
$listing_file$ - listing filename
$lfieldX$ - listing field value of field X, X is a number from 1 to 75
$user_num$ - user number
$user_name$ - user name
$user_file$ - user homepage filename
Templatecells on this page:
row_image - displayed for listings with preview image
row_image_new - displayed for NEW listings with preview image
row_noimage - displayed for listings without preview image
row_noimage_new - displayed for NEW listings without preview image