| |
|
| - |
| - |
| - |
| - |
| - |
| |
|
| - |
| - |
| - |
| - |
| - |
| - |
| - |
| - |
| - |
| - |
-
-
-
- |
| - |
| - |
| - |
| - |
| - |
| |
|
| - |
| - |
| - |
| - |
| - |
| - |
| - |
| - |
| - |
| - |
| |
|
| - |
| - |
| - |
| - |
| |
|
| - |
| - |
| - |
| |
|
|
 |
Customization Tips And How-To's
This section gives you ideas and shows you tips and how to's to customize our scripts
according to your needs and to get the most out of it.
How to add/reduce/work with ad posting steps
How to add/remove fields from ad posting process
How to make a short, integrated registration and ad posting process
How to work with the ad credit system
How to create simple keyword search and display it anywhere
How to create a search for ad id
How to hide account selection field on register area or create different register pages
How to add fields to the sorting box
How to add/reduce/work with ad posting steps
To add, reduce and work with ad posting process steps, the first thing you would like
to do is in admin area, behaviours section to set the "Number of ad post pages" field
according to your needs. If you would like to collect all user profile data on just
2 pages, set "Number of ad post pages" to 2. Now this means you would have the category
selection step (post0.html template), then the first page of ad posting process (post1.html)
and the second page of ad posting process (post2.html). After your members complete the
second step, they will be forwarded to ad preview page where they can review and submit
their profile.
Now that we have identified that you are only going to use post1.html and post2.html
template, you need to set database fields accordingly to show up on either post1.html
template or post2.html template. Now change to admin area, ad database field section and
edit the fields you would like to display on post1.html template, on the edit database
field page of every field, set "When posting an ad, put this field on" setting to "1".
In all fields you would like to display on post2.html template, set this setting to "2".
Make sure that these fields are set "active".
The last step is to add the field [tags] to their respective html template, either
post1.html or post2.html. More information on the tag format is available in the
Strings and Tags section of this documentation.
How to add/remove fields from ad posting process
To add and remove fields from ad posting process pages (templates page1.html - page4.html)
2 steps are required.
The first step is to identify which database field you would like to display on which
ad post template. For example if you wish to display database field "custom5" on step3
of your ad posting process (which is the detailed information collection in the default
setup), go into admin area, ad database field section of field "custom5" and set "When posting an ad, put this field on"
setting to "3". Then make sure the field is set to "active" as well.
The second step is to add the field [tags] to their respective html template, either
post1.html or post2.html. More information on the tag format is available in the
Strings and Tags section of this documentation.
To remove a field, also 2 steps are necessary.
The first step is to edit the html template, and remove the database field tag from the
html template. The second step is to make sure that the database field is set to
"unactive" and "unrequired" in the ad database field settings.
How to make a short, integrated registration and ad posting process
Some admins do not want users to register, then create profiles separated from the
registration process. With our software, you can create such a process seamlessly.
The first step is to remove all unnecessary fields from the "member_register.html"
template by removing all unrequired field tags (make sure the fields you are removing
are set to "unrequired" and "unactive" in member database fields section). You can remove
any field you want, if you want all fields, but you must leave username and password fields
at least on the registration form.
The next step is to send users right to the profile creation process after they submitted
username and password. You can do this in admin area, behaviours section, setting
"Send user after registration to" set to "ad posting page".
Now follow the steps from the tip above on "How to add/reduce/work with ad posting steps"
to create a single registration and posting process. You'll want to set in behaviours
section "Number of ad post pages" to "1". Then make sure all ad fields you want to place
on post1.html template are assigned to this template in ad database fields section,
setting "When posting an ad, put this field on" to "1".
How to work with the ad credit system
The ad credit system gives your members the ability to order or
upgrade an account multiple times, each time ADDING account permissions to their existing
account permissions.
For example, if your member's current account allows the member to upload 1 image, the
member uploaded one but would like to upload one more, he simply orders the same account
again giving him another upload credit.
If your member's current account allows the member to upload 2 media files, the member
uploaded one but decides he want to upload 6 media files, he can order any account with
4 media file upload allowances, this would give him the ability to upload 6 media files.
Since he used 1 media credit already, he would then be able to upload another 5 media files.
This works with all account permissions indefinitely.
If you do not want to use the ad credit system (can be turned on/off in the admin area,
behaviours section) the user would not be able to add credits to his account when
re-ordering or upgrading to the same or another account again. This means when the
member's current account is allowing the member to upload 2 images, the new account
which the member want to upgrade to allows to upload 4 images, the member will only
be able to use the 4 media credits of the new account. If the ad credit system would
be on, it would allow the member to use 6 media credits, 2 from the old and 4 from
the new account.
If you create an account with 1 ad allowance the user purchases the ad and posts it,
everything in one process like you see in common classified ad systems. Once the user deletes
his ad he is not able to post again unti he purchases new ads (as opposed to
ad credit system turned off, in this case the user can post multiple times within his allowance).
How to create simple keyword search and display it anywhere
If you would like to add a simple keyword search field without any selection fields to your
system pages, simply place following HTML on the template:
<form method="GET" action="[PROGRAM_URL]" name="search">
<input type=hidden name="type" value="search">
<input type=hidden name="action" value="search">
<input type=hidden name="offset" value="0">
<input type=hidden name="cat_b" value="0">
<input type=hidden name="cat_a" value="0">
<input type=hidden name="cat_c" value="0">
<input type=text size=20 maxlength=35 name="keywords" value="[SEARCHBOX_KEYWORDS]">
<input type=submit value="search" border=0>
</form>
Of course you can also place this search on any other HTML page, or even on a HTML page on another domain.
In this case replace "[PROGRAM_URL]" with "http://www.yourdomain.com/mojoscript.cgi?mojo=1"
and "[SEARCHBOX_KEYWORDS]" with "".
How to create a search by ad id
If you want to give your users the possibility to search by ad id, you can add following
search form to your pages:
<form method="GET" action="[PROGRAM_URL]"" name="search">
<input type=hidden name="type" value="ad">
<input type=hidden name="action" value="view">
<input type=text name="id" value="">
<input type=submit value="search" border=0>
</form>
How to hide account selection field on register page or create different register areas
If you do not want to display the account selection field on the registration page, maybe because
you only have one account or want to force certain users into a certain account, you can do the following:
Remove [IP_ACCOUNT] tag member_register.html and add following HTML instead, where
the account is hardcoded in the form as hidden parameter:
<input type=hidden name="account" value="ACCOUNTNAME">
(replace ACCOUNTNAME with the actual name of the account you want users to sign up for.)
Of course in a similar fashion you can also create different registration pages, for example if you want
separate registration areas for users and agents. First create the relevant accounts and set permissions
in the account manager area, then access registration page online in your browser and copy the
source code, save it as static html page.
Now remove [IP_ACCOUNT] tag and replace it with the relevant hidden form for one account.
In the static html page, remove the account selection form field and replace it with the relevant
hidden form html for the other account.
Now you have the normal system registration page where users can register and a separate
registration page for agents, companies or other groups.
How to add fields to the sorting box
This software gives your visitors the ability to sort results of each field in ascending and descending order.
By default, the field "TITLE" is sortable in results in ascending and descending order. To add more fields,
you need to follow these instructions:
Download ad_fields.txt from the program_files folder and store it in a very safe place, this is your backup in case something
goes wrong. In this case you can just upload it back to the server and the system works without problems! Download now another copy of ad_fields.txt
from the program_files folder on your server to your PC and open it in a text editor such as notepad.
Add 3 new columns 'use_in_sorting', 'asc_label', 'desc_label’ to each field you want to add to the sorting dropdown box (currently there are “new ads first”, “new ads last, “most viewed” etc.)
To add a field to the SORTING dropdown box, just find the relevant line in file ad_fields.txt describing this field and add content in following format AT THE END OF THE LINE:
|1|ASC_label|DESC_label
Where "ASC_label" is the label for the order, you can replace it with something like "thisfield a-z"
Example:
title|your ad title|Please enter your ad title.|text|any||40|60||0|Yes|0|Yes|Yes||2
IMPORTANT: THIS IS ONE LINE AND MUST REMAIN IN ONE LINE BEFORE SAVING AND UPLOADING THE FILE.
becomes:
title|your ad title|Please enter your ad title.|text|any||40|60||0|Yes|0|Yes|Yes||2|1|Title A-Z|Title Z-A
REMEMBER: THIS IS ONE LINE AND MUST REMAIN IN ONE LINE BEFORE SAVING AND UPLOADING THE FILE.
After this update, the sorting dropdown box shows the new sorting options: “new ads first”, “new ads last”, “most viewed”, “Title A-Z”, “ Title Z-A”
Replicate this for any field you would like to make sortable.
|
|
