Home |  Mewsoft |   Overview |  Features |  License |  Installation |  Troubleshooting |  SDK |  Customization |  FAQ |  PDF    
 
 Engine Management
  Auctions Manager
  Accounts Manager
  Pending Accounts
  Accounting Manager
  Banner Advertisers
  Mail Manager

  System Statistics

 System Management 
  Category Manager
  Language Manager
  Fees Manager
  Database & SQL Manager
  System Announcements
  System Maintenance
 System Setup
  Configuration
  General Options
  Category Options
  Listing Options
  File Upload Options
  Billing System Setup
  Portal Tools
 Layout & Integration
  General Classes
  Special Classes
  Template Editor
  Custom Functions
 System Tools
  Lock System Access
  Server Backup
  Setup Wizard

 

Customization

 

 

Overview
Templates Customizations
Example Template File

MS FrontPage Important Notes

 

 

Overview
The software is designed using Mewsoft unique technology which allows the end user to have full control over customizing the program to the feel and look that needed for specific application. All the program output is totally customizable. Customization can be done using many built in tools in the system. These can be done easily online or offline from the administration center.

The software is totally pure html template based system. This means that the program uses an regular html files for formatting its output. These templates are just html files that can be edited from the admin center and using the built in editor or using any other text or html WYSIWYG editor like MS FrontPage.

 


Templates Customizations
Templates are pure html files usually located in the directory "data/templates". The system uses specific variables or place holders inside these templates or html files to its insert the output.

Language Variables:
Because the system is multi language capable, the program uses a language variables inside the templates instead of using the actual text. Each language variable refers to some text in the language files.

The language variables are inserted inside the templates between "[[" and "]]" as follows:

[[language_variable_name]]

At the program run time, the system will replace the language variables by its text values. This way, the same template is used to display any number of languages.

Language variables and text are kept inside the language files. Each language has its own directory under the "data/language" directory. below is few lines of a langue file shows how these files are build.

create_account~==~Create Account
edit_profile~==~Edit Profile
registration~==~Registration
search_home_bar~==~Main
browse_categories~==~Categories
account_manager~==~Manage Account

Each line is a language variable and its value separated by "~==~" and must be on one single line. These files can easily edited from the administration center or using any text editor. Language files has the extension ".pm" and must be edited and transferred in ASCII mode not binary mode.

Classes:
Since the system is template driven, the program uses a special plug ins or place holders inside the templates.

The general format for the classes is:

<!--CLASS::Class_Name-->

Where "Class_Name" is  a unique name for each class. Some classes are general and can be used inside any template, like the "Header" class. Some classes are specific to certain functions and therefore only available for specific templates.

At the program run time, the system will replace the "<!--CLASS::Class_Name-->" by code generated for this specific function name. This way the program can place the code generated inside the templates anywhere you place these classes. This allows you full control over the program output and customization.

 


Example Template File "contact.html"
<!--CLASS::Header-->
<DIV ALIGN="center"><CENTER>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="0" BGCOLOR="#FFFFFF" CELLSPACING="0">
<TR><TD ALIGN="center" WIDTH="100%">
<!--CLASS::Top_Navigation-->
<!--CLASS::Top_Area-->
<!--CLASS::Welcome_Area-->

<!-------------------------------------------------->
<DIV ALIGN="CENTER">
<TABLE BORDER="0" WIDTH="610" CELLPADDING="3">
<TR>
<FORM NAME="Contact_Us_Form" METHOD="POST" ACTION="<!--Action-->" >
<INPUT TYPE="hidden" NAME="Lang" VALUE="<!--Language-->"> 
<INPUT TYPE="hidden" NAME="action" VALUE="Send_Contact_Us">
<TD COLSPAN="2">
<P ALIGN="CENTER"><B><FONT SIZE="5" COLOR="RED">[[contact_us_page_title]]</FONT></B></P>
</TD>
</TR>
<TR>
<TD COLSPAN="2">[[contact_us_page_help]]</TD>
</TR>
<TR>
<TD WIDTH="100%" COLSPAN="2"><B>[[contact_us_form_help]]</B></TD>
</TR>
<TR>
<TD WIDTH="35%">
<P ALIGN="RIGHT">[[full_name_label]]</TD>
<TD WIDTH="65%"><INPUT NAME="Contact_Us_Full_Name" SIZE=35 VALUE=""></TD>
</TR>
<TR>
<TD WIDTH="35%">
<P ALIGN="RIGHT">[[email_address_label]]</TD>
<TD WIDTH="65%"><INPUT NAME="Contact_Us_Email_Address" size=35 VALUE=""></TD>
</TR>
<TR>
<TD WIDTH="35%">
<P ALIGN="RIGHT">[[phone_number_label]]</TD>
<TD WIDTH="65%"><INPUT NAME="Contact_Us_Phone" SIZE=20 VALUE=""></TD>
</TR>
<TR>
<TD WIDTH="35%">
<P ALIGN="RIGHT">[[subject_label]]</TD>
<TD WIDTH="65%"><INPUT NAME="Contact_Us_Subject" SIZE=45 VALUE=""></TD>
</TR>
<TR>
<TD VALIGN="TOP" WIDTH="35%">
<P ALIGN="RIGHT">[[comments_label]]</TD>
<TD WIDTH="65%"><TEXTAREA NAME="Contact_Us_Comments" cols=50 rows=8 wrap=physical value=""></TEXTAREA></TD>
</TR>
<TR>
<TD WIDTH="100%" COLSPAN="2">
<P ALIGN="CENTER">[[contact_label]]
<SELECT SIZE="1" NAME="Contact_Us_Contact">
<OPTION VALUE="Please contact me" SELECTED >[[yes_label]]</OPTION>
<OPTION VALUE="">[[no_label]]</OPTION>
</SELECT>
</TD>
</TR>
<TR>
<TD WIDTH="100%" COLSPAN="2" ALIGN="CENTER">
[[submit_button]]&nbsp; [[clear_form_button]]
</TD>
</FORM>
</TR>
</TABLE>
</DIV>
<BR>
<!-------------------------------------------------->
<!--CLASS::Bottom_Navigation-->
<!--CLASS::Bottom-->

</TD></TR>
</TABLE>
</CENTER></DIV>
<!--CLASS::Footer-->
 

In the above template code example, the classes are colored in red, language variables are colored in blue, and other program plug ins are colored in green.


MS FrontPage Important Notes

Templates can be edited using any WYSIWYG editor like MS FrontPage or else. MS FrontPage has specific issue that affects some templates. This problem is specific to MS frontPage. It replaces all "<" letter by "&lt;" and all ">" lette by "&gt;". As you can see from the above template code, the program uses classes and special plug ins between the comments like <!--CLASS::xx-->, so MS FrontPage changes these to &lt;!--CLASS::xx--&gt;. There are two very easy solutions. The first is to configure MS FrontPage not to change the code:

From Tools->Page Options->Click the "HTML Source" tab->Select the radio button "Preserve existing HTML".

The other solution is, after you finish editing in MS FrontPage, replace all the "&lt;" by "<" and all the "&gt;" by ">". You can do this from the Edit->Replace menu.


 
Copyright 2001-2004 Mewsoft Corporation. All rights reserved.