MojoDirectories.com - MojoCatalog Documentation

MojoCatalog displays dynamic CGI generated Web pages, as opposed to static HTML pages. In MojoCatalog, dynamic is means real-time. Instead of having you modify the HTML code within the Perl script, we have moved all of the HTML specific code out of the program, and into various readily modifiable templates of all kinds of sections throughout the system.

Shortcut to "Customize Categories and ads"
(however its recommended that you read and understand first how MojoCatalog deals with templates before shortcutting to that section)

How MojoCatalog deals with templates

MojoCatalog's templates are standard HTML documents with unique MojoTags, such as [VARIABLE_NAME] wherein VARIABLE_NAME is the database field which defines that tag. Note that there is an opening square bracket ([) and a closing square braket (]), and the tag name inside them. These tags are replaced by the content MojoCatalog generates and should not be modified. You can, however, move them around in the template document, or strip them out completely.

To display the tag values, you would use [VARIABLE_NAME]. However, if you want to collect value for that variable, such as during registration and ad posting processes, then you would use [IP_VARIABLE_NAME] to display the form field for that variable, where IP stands for "InPut".

You may edit the templates offline using any TEXT or HTML (WYSIWYG) editor such as Notepad, EditPlus, Dreamweaver, or Coldfusion. Just make sure that the editor you are using does not change the [ and ] tags contained in the templates.

You can also edit the templates online in the web based admin area. Just log into your admin panel and click on "templates" link.

Note: In MojoCatalog templates, you can embed graphics by using FULL urls such as

<img src="http://www.mydomain.com/images/this_image.gif">

or you can use relative url to the IMAGES PATH that you set in the configurations

<img src="[IMAGE_URL]/this_images.gif">

When the program runs, it will replace [IMAGE_URL] with the correct image path that you set up in the configurations. For more info about tags, please consult the tags page.

HTML Templates

HTML templates are used to display dynamic HTML pages on the screen. As in email templates where information is displayed, HTML templates are also used to collect information for storing in the mysql database.

The following templates can use the "URL Tags", "ads Tags", "MEMBER Tags", and "MISC Tags". To collect information as in registration, ad posting and registration details update, you have to add "IP_" in front of the variable name. For example, if you want to collect the users address, you will use [IP_adDRESS] but not [adDRESS] on the registration template.

The following templates are used for member control panel:

HTML Template Name	Purpose
- ad_delete.html	Used to display ad delete page in user panel, member ads section, embedded in template_adcentre.html template.
- ad_posted.html	Used to display existing member's ads in user panel, member ads section, embedded in template_adcentre.html template.
- ad_saved.html	Displays the members hotlist.
- conform.html	Used to display account conformation screen with information of member's old and new account settings. If members receive this screen, they need to make an adjustment to their existing account in order to be conform with their new account settings. Most likely, the member needs to delete ads, images, multimedia files or delete files from gallery to proceed with his existing account, which allows less credits than previous one.
- member_delete.html	Used when user requested to delete their account.
- member_login.html	Used when user wants to login.
- member_lost.html	Used when user wants to retrieve their password.
- member_panel.html	Member control panel main page. After successful member login, the members will be forwarded to this page. Here you can place all member panel links according to your needs and display some member account stats. You can add some news on this page, special notifications and so on.
- member_preference.html	Member preferences page. Here your members can set various account preferences.
- member_profile.html	Member registration profile page. Shows the data the member submitted upon registration.
- member_update.html	Member registration profile update screen. On this page your members can update their information.
- template_adcentre.html	This is the global ad centre template.
- template_adpost.html	This is the global ad posting process template.
- template_gallery.html	This is the global multimedia gallery template.
- template_mailbox.html	This is the global internal mailbox, private messaging center template.
- template_member.html	This is the global control panel template.
- template_sscentre.html	This is the global saved search/matchmaker template.
- faq.html	Frequently asked questions template with information using the member control panel.
- gallery.html	Member gallery content, embedded in template_gallery.html template.
- gallery_delete.html	Member gallery delete screen, embedded in template_gallery.html template.
- gallery_stats.html	Member gallery stats screen, embedded in template_gallery.html template.
- gallery_upload.html	Member gallery upload screen, embedded in template_gallery.html template.
- gateway.html	Payment gateway screen, if using multiple gateways, the gateway screen will be displayed after the account order/upgrade screen for the member to choose the desired payment option.
- mail_compose.html	Private message section, mail composing screen.
- mail_notification.html	Private message section, mail notification setting screen.
- mail_read.html	Private message section, message screen.
- mail_signature.html	Private message section, signature screen.
- mailbox_display.html	Private message section, main incoming/outgoing message screen with message subjects.
- member_delete.html	Delete account form, here members can cancel their membership with optional message to admin on the reasons.
- pattern_delete.html	Delete saved search pattern page, embedded in template_sscentre.html template.
- payment.html	Payment screen, if using multiple payment options, the gateway screen will be displayed after the account order/upgrade screen for the member to choose the desired payment option. However, if you select a default payment method for an account then this page will not be displayed. Insteatd the member will be forwarded to the payment provider directly. This template can use all "URL tags", "Member Tags", as well as the following: 1. [CREDITCARD_LINKS]: Display alternative credit card payment processors 2. [WEB900_LINKS]: Display alternative telephone payments. 3. [CHECK_LINKS]: Display alternative check payments.
- saved_patterns.html	Saved search pattern list page, embedded in template_sscentre.html template.
- saved_search.html	Saved search pattern form page, embedded in template_sscentre.html template.
- upgrade.html	Account order/upgrade page, lists accounts with account permissions, account terms and payment information. Paysite only: members that do not have access to certain things will be taken to this page where they can select which access levels they want to subscribe to.
- view_profile.html	Member registration details page, embedded in template_member.html template.
- member_pause.html	Member account/listing pause/on-hold page.

The following templates are used for categories and ads:

HTML Template Name	Purpose
- ad.html	Used to display full ads.
- ad1.html	Used to display one embedded ad that's used to embed in cat.html.
- ad_full.html	Main ad template.
- post0.html	Used to display on ad posting entrance, selecting category.
- post1.html	Used to display when posting ad at step 1, general profile information.
- post2.html	Used to display when posting ad at step 2, profile description.
- post3.html	Used to display when posting ad at step 3, survey information
- post4.html	Used to display when posting ad at step 4, media file upload.
- post_preview.html	Used to display when posting ad at step 5, preview before submission.
- cat.html	Used to display ad categories.
- cat1.html	Used to display 1 embedded category that's embedded in cat.html.
- error_template.html	Used to display error message during ad posting process, if required fields are missing.
- image.html	Used to full size image linked from thumbnail in preview ad, full ad view or file gallery.
- reply_ad.html	Form used for guests and members to reply to an ad and to send a private message to a member.
- report_ad.html	Form used for guests and members to report a suspicious ad to admin.
- send_ad.html	Form used for guests and members to send ad information to a friend via email. Also known as ad notification or tell-a-friend facility.
- ad2.html	This template displays a list of most recent, most popular, most saved, random listings on your main pages. View below and tag page on how to display this template on your main templates.
- member_display2.html	This template displays a list of most recent members on your main pages. View below and tag page on how to display this template on your main templates.

Outside member panel and extra templates:

HTML Template Name	Purpose
- error.html	Used to display error messages. mojoTags: 1. [TITLE]: the title of the message 2. [MESSAGE]: the error message
- member_login.html	Login page for members.
- member_lost.html	Account details retrieval page for members.
- member_register.html	Member registration form. Here, users will register to your system by submitting required information.
- member_validate.html	Member validation form. If members receive an activation code during signup and the email validation does not work, they will be forwarded to this page to submit the required information to verify their account.
- search.html	advanced search form page.
- user_options.html	Displays the menu links on category and ad pages.
- gXXXXXXxxx.hmf*	This template should be edited and uploaded to ibill server, if you use ibill pincoding services. mojoTags: 1. %%REF1?: member username 2. %%REF2?: member password 3. %%CODE?: generated pincode 4. %%TRAN?: Transaction number 5. %%REBILL?: Subscription ID number You need to check with iBill setup for complete instructions.
- web900.html*	iBILL WEB900: Used to let member enter information after a telephone charge. Can used "URL tags", "Member Tags", and "Misc Tags"

admin area templates:

HTML Template Name	Purpose
- account.html	Account manager section.
- account_delete.html	Account manager section, delete account page.
- account_permission.html	Account manager section, account permission page.
- ad_build.html	Category management section, displays ads in category.
- admin.html	admin area, main entrance.
- admin_add.html	admininstrator section, create admininstrator.
- admin_display.html	admininstrator section, admininstrator list.
- admin_display_setup.html	Display section, category table attribute settings.
- admin_edit.html	admininstrator section, edit admininstrator.
- admin_gallery_file.html	Member section, member's gallery.
- admin_mailcompose.html	Email members section, create message screen.
- admin_member_delete.html	Member section, delete member confirmation screen.
- admin_member_detail.html	Member section, member detailed view screen.
- admin_member_edit.html	Member section, member edit screen.
- admin_member_gallery.html	Member section, member gallery screen.
- admin_member_search.html	Member section, member search screen.
- admin_login.html	admin panel, login screen.
- backup.html	admin panel, backup database screen.
- behaviour.html	admin panel, behaviours screen.
- cat_delete.html	Category management section, delete category screen.
- cat_display.html	Category management section, category list screen.
- cat_middle.html	Category management section, create category screen.
- check_referer.html	Referer error screen.
- config.html	admin area, configurations screen.
- database.html	admin area, database selection screen.
- database_display.html	admin area, database field settings display.
- database_middle.html	admin area, database field list.
- debugconfig.html	admin area, debug configuration screen.
- display_account.html	admin area, account manager screen.
- error.html	admin area, error message.
- export.html	Utilities, export database screen.
- filetypedisplay.html	Gallery file type section, file type list screen.
- filetypefield.html	Gallery file type section, file type settings screen.
- groupdelete.html	admin groups, group delete screen.
- group_display.html	admin groups, group list screen.
- groupmiddle.html	admin groups, group creation screen.
- import.html	Utilities section, data import screen.
- import_confirm.html	Utilities section, data import confirmation screen.
- mail.html	Email members, main screen.
- member_add.html	admin area, add member screen.
- member_display.html	Member management section, member display list.
- mojoheader.html	admin area, header HTML including menu links.
- print_env.html	admin area, prints server environment variables.
- print_fatal.html	admin area, prints error message.
- print_installed_modules.html	admin area, prints all modules installed.
- print_server_info.html	admin area, prints server and system information links.
- print_system.html	admin area, system information.
- print_template.html	admin area, template editing section.
- repair.html	Utilities section, repair database table section.
- restore.html	Utilities section, restore database section.
- security.html	admin area, security section.
- security_banning.html	admin area, security section, banning page.
- security_referer.html	admin area, security section, referer page.
- security_reservedusernames.html	admin area, security section, reserved usernames page.
- support_faq.html	Support section, form to contact MojoDirectories for support.
- support_rate.html	Support section, form to rate MojoCatalog.
- template_display.html	Templates section, form used to edit template.
- template_edit.html	Templates section, form used to edit template.
- template_subjects.html	Templates section, form used to edit email subjects.
- utility_main.html	admin area, utility section.

Customize templates

1. Customize categories and ads displays

MojoCatalog offers a broad range of tools to customize your classified section according to your needs. This small section discusses the possibilities of using templates to design the way your categories and ads display.

Fairly easy for beginners, yet powerful for experienced users. You do not have to edit any CGI files to get the display and style you want. The secrets are in four files: ad1.html, ad.html, cat1.html, and cat.html

To display the full ad, we use the ad.html template which utilizes all URL tags and ads tags available in the system. You can move the tags around to suite your taste. Try to get the look and feel of your own unique service. The default layout should be fine, but since we do not focus on graphics and fancy layout, it is very plain.

To display ad preview in "browse category" and "search" pages, you can modify the ad1.html template. The name tells it all, it displays the layout of one ad, but embedded one by one into a dynamic page (cat1.html template). This template will display a preview or summary format of the ads, you can use ever tag there as well, the design is fully up to you.

To customize the way the categories are displaying, modify the template named cat.html.

Template cat.html is used to display categories, ad stats, menus, search box, as well as a few others all in one. This is the most important template which users will see it first when accessing MojoCatalog. You can leave the default which displays the main category list or fancy it up like match.com, remove categories and diplay just a search box with some cool graphics, the choice is yours.

2. Customize "ad posting process"

Problem: You are getting field errors on certain pages, certain fields are not displaying etc.

Solution:

Make sure the number of "ad posting pages" is set to correct value in behaviours section (at bottom of the section) (remember there are 4 ad posting steps, they are listed in the database section).

If a field responds with an error that it has not been completed, it is because it is set required for that posting page in its field settings.
This means: 1. Make sure the field is set to be displayed on the correct ad posting template. For example, if you have 4 ad posting pages and would like to collect "eyecolor" on the first step from your members, make sure the field settings for database field "eyes" is set to be displayed on "post1.html" template or simply "1" in its field settings.

If the field never showed up on its designated posting page, set it to active and adD THE FIELD TAG tag to the correct posting page html template.

If these steps are taken care of you should not get problems with missing or uncompleted fields during the posting process.

3. Display listing and user statistic short lists on your main pages

Listing statistics

On any template you like you can display a list of most recent postings, most populars, most saved or just some random ads. The list HTML is located in template file "ads2.html" and you can customize it according to your needs as usual.
You can call this template into any template you want via mojotags, in following format:

[(\d*)_MostRecentPostings]
[(\d*)_MostPopularPostings]
[(\d*)_MostSavedPostings]
[(\d*)_RandomAdsFromCat_(\d*)_cattype_(\w*)]

(Remark: (\d*) means any digital, (\w*) means A, B or C)

Example: [5_MostRecentPostings]
(Displays list of 5 latest posts)

Also you could show stats using 'display_stats.cgi' located in the script root where admin.cgi is located. It has text field $template inside in which you may use these tags.

User statistics

In the exact similar fashion, you can display lists of your newest members.
The HTML is customizable in file "member_display2.html" and called via mojotags on any template you want:

[(\d*)_MostRecentMembers]

Example: [10_MostRecentMembers]
(Displays list of 10 latest signups]