1.6.1. Custom Pages

With Custom Pages you can add new links and content to your site.

1.6.1.1. Custom pages types

There are two types of custom pages: Custom Content or External Link

Custom Content - you can add a content to that custom page and edit it with a HTML editor.

External Link - you can only add a link towards an external page. Usually you use this if you want to add a link to your navigation bar towards an external page. Use this in conjunction with Navigator Bar Link, otherwise there is no point adding it.

You can choose to place a link to your custom page in your site navigation bar. You can choose between the main navigation bar, and a secondary navigation that is usually placed in the footer of the page. Set this using Navigation Bar Link field. If you will choose Not Linked here, the link for this page will not appear on any navigation bar.

Some custom pages are already defined when you install the script and they are read only, you cannot delete them, you can only enable or disable them. There are 3 such pages:

1.6.1.2. Adding a new custom page

To add a new custom page, click the Add button on top of Custom Pages table. You will need to fill in the following form:

Title - the title of the browser page. This title will also be used as link title on the navigation bar if you choose Main Navigation Bar Link or Secondary Navigation Bar Link.

Type - choose the type: Custom Content or External Link

External Link - this field will only appear if you choose External Link type. Enter here the external link you need to add.

Navigation Bar Link - choose if you want this page or link to appear in one of the two navigation bars possible: Main Navigation Bar or Secondary Navigation Bar, in the page footer. Choose Not Linked if you don't want the link to appear.

Submenu for - this field appears only if you choose Main Navigation Bar for Navigation Bar Link field. Choose a parent for this link and it will appear as a drop down option for the parent link. You can have more levels of links: navigation bar children links can have other child links of thir own.

Open in new window - if the previous checkbox is enabled, use this one to make the link from the navigation bar open in another window.

Meta Keywords - will only appear for Custom Content type. Enter here meta keywords that will appear on this custom page.

Meta Description - will only appear for Custom Content type. Enter here meta description that will appear on this custom page.

Visible by - This defaults to All value, but if you want a custom page to be visible only by a user group or by not logged in guests, here you can configure it.

After you submit the form, if you added a Custom Content page, you will be redirected to a HTML editor. Use this editor to edit the contet of your new page. You can later come back to edit your page by clicking on Edit Content icon from Custom Pages table.

1.6.1.3. Managing custom pages

You can perform certain operations on your existing custom pages on Tools / Custom Pages section:

Changing custom pages order - can be done using Order buttons. Order is important only for the custom pages that are added to a navigation bar. They will appear after the default links of navigation bar, in the order you set here.

Searching for a string - you can search for a string that exists in one of your custom pages content using the Search box on top right of the table.

Action icons:

1.6.1.4. Custom pages usage

You can use custom pages for the following situations:

1.6.2. Database

This section allows you to easily backup or restore the database used for the current script installation.

On a script installation, all the configurations that you make to the script, excepting uploaded files and images, are kept in a mysql database. To have a complete backup of your site at a given moment you have to have the files of the script and the database backup. You can usually make backup to your database using the tools from the hosting control panel, but we've added a similar tool to the script to make it easier, and also with our script you can automate the process.

Existing backup files. You can see in the table at the top of the page the existing backups in the backup folder. The backup files are saved in the folder db_backup and can be downloaded to your computer by clicking on the Download link or directly with FTP.

Backup - when you hit the button Backup, a new backup for the database will be saved on the server and will appear in the upper table. You can choose to save the backup in the compressed (gzip) or uncompressed version.

Import - If you want to reverse to a previous version that you have saved before, you can use the Import feature (this will restore the database from the file you upload). Same result can be accomplished by clicking on the Restore icon for an existing backup from the table.

Scheduled backups - If you want the database backup to be made automatically, you can enable Scheduled Backups. Choose one of the options Daily, Weekly or Monthly. If you configure a number in Keep Only box, only that number of backups will be kept, the older ones will be deleted. This is to save space on your server.

1.6.3. Google Sitemap

Sitemaps are XML files that have a certain format, and serve the purpose of giving search engines informations about the URLs on your site that are available for crawling. For each URL you can attach informations like when it was updated, how often the page on the link changes, the importance related to the other pages. These URL maps should help search engines index your site better. Please keep in mind that this does not guarantee that the links will be indexed by the search engine.

To create a sitemap for your site you need to check the Enable checkbox, then make the changes to the settings as you think it is more fit for your site: which links you want present: categories links, listings (details pages links) and custom pages links. You can set for each the importance (priority) and the changes frequency. These informations will be submitted to the search engine in XML format. For the ads you can set a maximum number of ads links to be listed, because when your site will grow and have lots of ads, the dimensions of the sitemap file will grow considerably. You can also set a frequency for auto generating the sitemap file - daily, weekly or monthly.

If the default configuration is not enough and you still need to add some extra links to your sitemap, then you must use the extra option Extra Entries. This allows you to add new entries to the sitemap, but you must add it in the recognized XML format for sitemaps. A new entry will look like this:

		
			http://www.yoursite.com/extrapage.php
			1.00
			daily
		
		

Once you created a sitemap for your site you should submit it to the search engine ( not only Google accepts the sitemaps of this sort, also Yahoo, Ask.com and Live, but we will only explain the procedure for Google).

To submit the sitemap to Google you must follow the steps:

1.6.4. RSS

RSS (short term for Really Simple Syndication) is a web format used to publish web content that is updating often, in our case, the latest listings added to your site. RSS feeds can be read with software called RSS reader or feed reader or agregator, which can be desktop based, web based or mobile based. People will be able to subscribe to theese feeds by clicking on the top RSS icon and add it to their favorite RSS reader. When there are new listings on the site, they will be updated.

To configure your site to generate RSS feeds you will need to add new RSS links. Click the Add button and you will be taken to a form. You will be able to configure:

Type - you can add RSS feeds for listings or for users. While normally you would add feeds for listings, there might be cases when you will want a list of dealers for example in a RSS feed.

Short Title - The title that will appear on your site, next to the RSS icon

Title - the title of the feed as will appear to subscribers

Description - the description of the feed as will appear to subscribers

FeedBurner Link - Feedburner is a web tool for RSS feeds owners. If you have created an account and added your feed there, configure here the Feedburner link.

Link - the link to your site

Language - 2 letters language code for your language

Parameters for listings - when you add a feed for listings, you can choose only some listings to appear to a feed, for example only the ones from Auto category, or ony the ones belonging to a certain plan. This way you can add multiple feeds to your site and make them different.

Parameters for users - when adding an users feed you can choose only some of the user groups to appear to the feed, or the users which have enabled Dealer page. You can also choose the sort order for the users feed. By default the users will be sorted by registration date.

Logo_field - If you have configured a logo field for your users and want the logo to display next to the user information you can configure here. Note that the image will not be resized, but displayed in its original size!

Number of Items - The number of last listings or users shown on the feed. Remember that you don't have to add them all, only the latest ads, otherwise the file will become too big to read.

You can add multiple RSS feeds that you will make them differ with the Parameters field. All RSS links will appear in the top of frontend interface, with the title you chosen for it (Short title).

1.6.5. Import/Export

This section allows exporting and importing data from your site (listings and users data only) in CSV and XML formats.

Some possible applications for this are:

A short description of each format:

CSV (Comma Separated Values) - is a simple format where the values are separated by a specified sign. This can be comma, as the name suggests, but not necessarily, you can use other character like ;. Sometimes, when your values can contain comma, it is better to use a character to surround your fields values, usually the double quotes are used. You can configure this in Import/Export / Settings / CSV Settings section.

An example of a listing exported as CSV (considering only the following fields: id,category_id,date_added,title,description,price,currency ):

"1","4","2011-05-24","This is the title of the ad","This is the description of the ad","10000","$"

XML (eXtensible Markup Language) - is a specification for formatting and storing data. XML allows the user to define its own markup elements (tags) that will store the data ( an example of XML format is HTML). Each data element will be contained between a start tag and an end tag:

<title>Title of the ad</title>

Each element (listing or user) will be contained also between start and end tags:

<listing></listing> for listings

<user></users> for users

An example of a exported listing in XML format, including the start tags of the document:

<?xml version='1.0' encoding='UTF-8' ?>
		  <listings>
		    <listing>
		      <id>1</id>
		      <category_id>4</category_id>
		      <date_added>2011-05-24</date_added>
		      <title>This is the title of the ad</title>
		      <description>This is the description of thet ad</description>
		      <price>10000</price>
		      <currency>$</currency>
		    </listing>
		</listings>
		

Defining templates. Templates are useful in the following cases:

When you import data, when using CSV format, you need to have a template defined. The reason is that CSV format is not self explanatory like XML format (does not have tags that explain for each element to which fields it belongs to), it is just a series of data separated by a character and the script needs to know the exact order how to assemble them back. So, the order in a CSV import file is very important and must exactly match the template. For the xml template, the order is not important

You can view the format for CSV and XML for a template by clicking on the View Templates icon. Use this templates as a model how you should create your import files.

There is a similar feature available to users, to allow them to import data, if you allow Bulk uploads for the group they sign up for. Using this feature they will be able to add bulk ads to your site in one of the 2 formats. You can configure which format your site accepts for Bulk Uploads (CSV or XML) in Import/Export / Settings / Ads Bulk Uploads section. You can also configure there the template for the importing ads files, and to which plan will the ads be automatically assigned.

1.6.5.1. Scheduled imports

This section allows you to configure imports which don't need to be manually uploaded, but are downloaded from a location periodically and imported without administrator or user intervention. The import files can be downloaded from a given URL or from a FTP account (see below details).

The following settings are possible for each scheduled import:

Name - the name of the import. This name is only for internal use.

Type - the format of the import file, either XML or CSV

Template - You can choose one template to be used for the imported files. While for xml templates this is not necessary, you should define and choose a template for CSV imports.

Import from - choose between File URL or FTP. Depending on what you choose you can configure different fields below.

File URL - if you selected URL as "Import from", then you will need to enter here the url of the import file. The url should be valid, including http:// in front.

FTP server - if you selected FTP as "Import from" then you will configure the FTP information necessary to download the import file. Enter here the server name or ip address of the ftp server. Do not add ftp:// in front. Ex: 120.9.3.10 or ftp.domain.com or domain.com.

FTP login - the login username for the FTP server

FTP password - the password for the previous login

FTP filename - the filename to import. Include the path if the filename is not located in the root of the FTP login. For example, if the name of the file is "ads.xml" and it is located in /imports folder, then use "imports/ads.xml" value.

Username - imported ads will be assigned to this user.

Default category - if the import file does not specify the category for an ad, this will be used instead as category. Note that if you set a default value for category here, and in the import file another category is set, then the category considered will be the category from the import file.

Default plan - set a default listing plan for the imported ads. If no listing plan is set here, then you should use the "package_id" field in the import file instead.

Use ID as unique field - The "id" field will be used not as the value for the id field in the database, but as a unique id of ads that are imported. When ads are imported, if an ad with the same unique id already exists in the system, the ad will be modified instead of adding a new one. The values of the unique field in this case can be alphanumeric (ex: z^sT18J0 ).

Delete inexisting ads - When Use ID as unique field option is selected, when an import is made, ads which are not contained in the current import (based on the unique id field) will be deleted.

Only download inexisting ads - When Use ID as unique field option is selected, when an import is made, only ads which were not previously imported (based on the unique id value) are imported.

Active - If the current scheduled import is active or not.

1.6.5.2. Configuring Bulk Uploads

To configure CSV or XML bulk uploads you need to configure the following in Tools / Import/Export:

CSV format:

"title" ,"description" ,"price" ,"currency" ,"country" ,"region" ,"city" ,"zip", "pictures"

This is the format for one listing in the CSV import file. For multiple listings you have to add multiple lines like this, one for every ad. If one of these fields separated by comma does not have a value, or does not apply for this type of listing (ex: fields that are only for some categories), empty quotes will be placed. It is important that each line has same number of elements, even if some are empty quotes. Here is an example for a CSV import file for the upper defined template design:

"First ad title" ,"Description 1" ,"12" ,"$" ,"UK" ,"London" ,"London" ,"12345", "http://example.com/1.jpg,http://example.com/2.jpg" 
"Second ad title" ,"Description for second ad" ,"100" ,"$" ,"USA" ,"CA" ,"LA" ,"98278","" 
"Third ad title" ,"Description for 3rd ad" ,"" ,"" ,"USA" ,"NY" ,"New York" ,"", ""

This should be the content of a text file saved with the extension .csv, and this file can be uploaded by every user having Bulk Uploads enabled from the Bulk Uploads section of each user account.

In this example, the comma is the column separator and double quote is the field separator. These can be changed from CSV Settings subsection. If for example, you want to use semicolon as column separator and single quote as field separator the line will look like this:

'title';'description';'price';'currency';'country';'region';'city';'zip';'pictures'

An example of csv file can be downloaded from the following location: http://www.oxyclassifieds.com/bu_samples/csvsample.csv Note that this file might work or might not work correctly to be imported on your system. You must have the same custom fields as in this example and you must have an import template that matches our example.

You need to instruct your clients how to proceed when generating upload files. We have written some samples that will help you in this task. Note that you cannot use these samples exactly as they might not apply exactly in your case. You should use them as examples only.

Sample 1 (for a real estate classifieds): http://www.oxyclassifieds.com/bu_samples/csvimport1/csv_import.html

Sample 2 (for an auto classifieds): http://www.oxyclassifieds.com/bu_samples/csvimport2/csv_import.html

XML format:

<?xml version='1.0' encoding='UTF-8' ?>
		<listings>
		  <listing>
		    <id>1</id>
		    <title>This is the title of the ad</title>
		    <description>This is the description of the ad</description>
		    <price>10000</price>
		    <currency>$</currency>
		    <country>UK</country>
		    <region>$</region>
		    <city>London</city>
		    <zip>12345</zip>
		    <pictures>http://example.com/1.jpg,http://example.com/2.jpg</pictures>
		  </listing>
		</listings>

A bulk upload XML file is build by placing for each listing <listing> block containing all fields defined in the template. One file with multiple listings to upload will look like this:

<?xml version='1.0' ?>
		<listings>
		  <listing>
		    <id>1</id>
		    <title>This is the title of the first ad</title>
		    <description>This is the description of the first ad</description>
		    <price>10000</price>
		    <currency>$</currency>
		    <country>UK</country>
		    <region>London</region>
		    <city>London</city>
		    <zip>12345</zip>
		    <pictures>http://example.com/1.jpg,http://example.com/2.jpg</pictures>
		  </listing>
		  <listing>
		    <id>1</id>
		    <title>This is the title of the second ad</title>
		    <description>This is the description of the second ad</description>
		    <price>10000</price>
		    <currency>$</currency>
		    <country>USA</country>
		    <region>CA</region>
		    <city>LA</city>
		    <zip>98278</zip>
		  </listing>
		  <listing>
		    <id>1</id>
		    <title>This is the title of the third ad</title>
		    <description>This is the description of the third ad</description>
		    <currency>$</currency>
		    <country>USA</country>
		    <region>NY</region>
		    <city>New York</city>
		  </listing>
		</listings>
		

In XML case, fields that don't have any value can be written or they can miss from the <listing> block, the syntax will still be valid even if you don't represent them. See in the example how price and zip files are missing. Only mandatory fields (title and description) cannot miss from the block.

If html characters are used within a tag, then the content should be enclosed between <![CDATA[ ]]> tags, as in the following example:

<description><![CDATA[ Description that contains <b>HTML characters</b>. ]]></description> 

If you use ISO-8859-1 character set for your site, then make sure use this encoding for the file and you specify it as encoding attribute in xml tag on top.

An example of XML file can be downloaded from the following location: http://www.oxyclassifieds.com/bu_samples/xmlsample.xml

Sample files for instructing clients about bulk upload feature:

Sample 1: http://www.oxyclassifieds.com/bu_samples/xmlimport1/xml_import.html

Sample 2: http://www.oxyclassifieds.com/bu_samples/xmlimport2/xml_import.html

How to create bulk uploads information page

On a user bulk uploads page there is a Help icon at the bottom of the screen. When a user clicks on the Help link, an info text will appear. Below is described how you can configure this info to point to a page with extensive bulk uploads description.

1.6.6. Image Tools

This section offers you the possibility to perform some operations on all your images on your site:

1.6.6.1. Regenerate thumbnails

If you already have images added in your system and you realize that you want the thumbnail image size different, then you can change it from Settings / Listing Settings / Images section. But this change will be applied starting with the following uploaded images. To apply the new changes to existing images use this current section, Regenerate Thumbnails.

You will see the image sizes that will be applied. If your system uses a watermark, then you will be able to choose if you want to apply watermark or not when reprocessing the images. This last feature is useful if your images already have a watermark added, and you would not want to add it second time.

When clicking on Regenerate now button, all existing thumbnails will be deleted and new ones will be generated. This process may take a while, depending on how many images your system has.

1.6.6.2. Remove unused images

Normaly, images belonging to a listing will be deleted once you delete that listing. But in special cases, if you delete listings directly from database, not using the administrator interface, of for some reason there are other images present in your images folder aside from the ones that belong to listings, then you can use this section to clean the folders from unused images.

1.6.7. Maintenance

This section offers you some maintenance tools:

1.6.7.1. Clear cache

The caching system of OxyClassifieds caches compiled template files, but also frequently used data like settings in order to keep the database accesses low. There might be cases when you will want to empty the cache, like for example when editing settings using an outside tool other than the administrator interface.

1.6.7.2. Maintenance mode

Set your site in maintenance mode while making updates or other type of changes to your site to avoid your site looking broken to your visitors.

Before setting the site in maintenance mode it is advised to add your IP address as a Maintenance IP. Only maintenance IPs will be able to view the actual site, the rest will see a generic message. So if you need to make changes to the site while maintenance mode is on, make sure you configure your IP here.

1.7.1. Manage Banners

This section will show the existing banners in your system.

1.7.1.1. Adding a new banner or editing an existing one

To add a new banner, click on the Add button above the banners table.

To edit an existing banner, click on the Edit icon on the corresponding table row.

The following form will appear:

Banner Type

You can add 2 types of banners:

Title - you can add here a title for the banner to recognize it easier.

Image - this field will only appear if you choose to create an image banner. Browse and upload the image to use for your banner.

Code - this field will only appear if you choose to create a code banner. Enter here the code for the banner.

Template Position - choose the position for the banner you want to add. Don't forget to consult banners chart to clarify banner positions.

Link To - this field will only appear if you choose to create an image banner. Enter here a link where you will be taken when clicking this banner.

Starting Date - you can set a starting date for your banner, and the banner will start showing with this date.

End Date - you can set an end date for your banner, and the banner will stop showing on this date.

Max impressions - if you want this banner to show only a number of times, set the number here. Leave this field to 0 for unlimited impressions.

Max clicks - if you want this banner to show until being clicked a number of times, set the number here. Leave this field to 0 for unlimited impressions.

Use Banner For - you can choose to assign banners to listing categories. Default selected value is All Categories, but if you switch to Choose Categories, then you will be able to choose the categories you want this banner to show under. This means that when a user browses that category, makes a search for that category, or views a listing belonging to that category, this banner will show.

Sections - for some of banners positions you can also choose the sections you want that banner to appear to. The possible sections are: firstpage, details, listings, recent, user_listings, custom, account, login-register, other. These sections are actually groups of pages for which you can choose your banners to show. You can see below an explanation for each of the sections:

If there are more banners that match the condition to show on a page than the number of banners to show simultaneous, then the banners will be shown randomly from the possible ones.

Open in new window - enable this option if the banner link should be opened in a new window.

Location field - if you enabled module Banners Location, then and only then, this extra field will appear, with the name of the selected banners location field. When you select a location here, search pages will only show this banner if the search is made for that particular location. On listing details pages, the banner will show if the current listing has that particular location. If Location Filter is enabled, the banner will show when the appropriate location for that banner is selected in the location filter.

1.7.1.2. Managing existing banners

You can view banners in Manage Banners section table. The actions that you can perform on banners are the following:

1.7.2. Banners Settings

You can view in this section banners positions and perform some settings on them.

Changing number of banners shown - can be done using the Increase Banners Number and Decrease Banners Number in Display Banners column. This number is the number of banners shown simultaneous for this position. For example, if you want to show to the right side 3 banners at once, then you will use the Increase Banners Number arrow to increase the number to 3. After this, if you have at least 3 banners added to that right banners category, then 3 banners will show one below another. For top and bottom banners, if multiple banners added, they will show on the same line on the horizontal.

Total Banners - represents the number of banners that currently exist in the system for this category.

Enable / Disable - you can disable or enable a category of banners. If a category is disabled, even if you have banners added to a category the banners will not show.

View Banners Chart - will show you the graphic position for the banner in the current frontend template.

1.8.1.1. General Settings

You can configure here some general script settings:

1.8.1.1.1.

Admin name - administrator contact name. It will be used mainly when sending emails from the site as the name for email sender, next to the Admin Email as sender email.

Admin username - The username you login as administrator with. You can change the password for this user from Security / Change Password section.

Admin Email - the email used to send notifications to administrator, like notifications for pending users, listings or listing options. This email is also used as sender email for messages sent to user accounts.

Contact Email - the email used to receive emails that are sent using the contact form. You can set this email to be the same as Admin Email.

Site name - is used:

Enable verification images on - Enable anti-spam image verification (captcha) for each of the pages: Register Page, Contact Page and Login Page

Use Recaptcha for image verification - When this is enabled, Google's Recaptcha is used as image verification. This requires a public and a private key, don't forget to enter these as well if you enable this option. Use this link in order to create the keys for your site: https://www.google.com/recaptcha/admin/create .

Users Can - Choose if users will be allowed to Delete Ads, Upgrade Ad Options or Request account removal

Enable internal messaging - Keep all messages exchanged by users and guests using your site forms in the database. These messages will be visible in Users / Messages section by administrator, and in each user account Messages by each user.

Messages wait admin approval - If you enable this, messages will not be sent, by email or otherwise unless approved by an administrator.

1.8.1.1.2. Post without user account

You can allow in this section posting ads without first registering. Your clients will not need an account anymore to post an ad. Instead, to be able to manage the ad or to be reached by administrator or people that browse the ad, when posting an ad, the owner must enter an email address and a name. The listing can be managed after posting using a special link received in the email, that contains a certain code that allows performing operations on that listing.

You can use this system of posting ads and the system using user accounts at the same time. To do that make sure you have a user group that has Auto Register enabled. When the two posting ads types are supported, with and without an account, when choosing to post a listing you will be taken to a pre ad posting page where you will choose if you want to login or place an ad without an account.

Enable post without user account - Check this box to enable posting ads without login.

Activate listings via Email - If you enable this option, when posting an ad, one must click on an activation link for the ad to be activated. If not, the listing will remain inactive. This method will ensure that the poster email is valid.

Activate listings via SMS - if you enable this option, when posting an ad without account the owner will be sent an SMS containing a code. The owner will need to use that code in order to activate the listing.

Listings pending - Listings posted with this method will remain pending until the administrator checks them.

Allow to edit listing - The listing owner will be able to edit the listing by using a manage listing link that he/she receives in the confirmation email.

Allow to delete listing - The listing owner will be able to delete the ad.

Allow to add listing extra options - The listing owner will be able to choose paid extra options for the listing.

Enable image verification - Enable image verification for listings posted without an account.

1.8.1.1.3. Affiliate accounts

Enable affiliate accounts - This option enables affiliates accounts. More information about the affiliates you will find in the affiliates section

Affiliates cookie availability - When a visitor accesses your site following an affiliate link, the affiliate id is remembered in a browser cookie. As long as this cookie is active in the browser, when a user makes a purchase on your site, the affiliate will receive a share for this purchase. Configure here how long is a cookie active after being created.

Affiliate percentage - The share from the total amount which is paid to your site which is assigned to be paid to the affiliate.

Affiliate payment cycle - The total due to the affiliate is paid after a cycle comprised of this number of days.

Auto Register - Check this box if you want to allow your affiliates to register their own accounts.

Activate Account via Email - Check this box if you want affiliate accounts to require activation by clicking on a link received in an email.

Activate Account via SMS - Check this box if you want affiliate accounts to require activation using a code received via SMS

Admin Verification - Check this if you want affiliate accounts to wait for administrator aproval.

1.8.1.1.4. Periodic operations

Simulate scheduler - There are some tasks that need to be ran daily for the script to function correctly: check if ads or subscriptions expired, delete expired items, send notification mails. When you have this checkbox checked the script will simulate a scheduler for these tasks by running once a day when a user accesses your site. However, when you have many ads in your system, running the periodic script will visibly slow down the connection when running (once a day). This is why it is advisable when the system has many ads, to create a cronjob on your hosting instead, if the hosting supports it. Make sure you set the time to run the script on a not busy hour.

The script will show you in the information to the right of this checkbox, the command you should set the cronjob with, for example:

"php /usr/home/username/public_html/periodic.php"

Delete Auth Info Older Than - When there is a login attempt on your site, it is registered in the database. You can see that information - the status of the attempt (successful or failed) and the IP address from which it was registered in Security / Login History section. This data kept in the database will take up space and you will not need the information that is very old. This is why here you can setup that information older than a number of days to be automatically deleted. If you want that all records to be kept, then you should set this value to 0.

Delete expired ads - You can choose when expired ads to be deleted from your system. The classifieds gives the possibility to users to renew their listings after they expired, so you should consider giving them this possibility by setting a number of days before the expired ads are deleted. You can choose between the following options:

1.8.1.1.5. Notifications

Send notification to admin - Choose if the administrator should receive notifications to the email set as Admin email when some actions happen:

Send notification to user - Choose if the user should receive email notifications when some actions happen:

1.8.1.1.6. Google Maps

Choose default location - Choose on the map the location you want maps in your site to show by default. Choose on the map the location your classifieds refers to. Users will start from this point on the map, and of course they can change it to any location they want.

To display the map and choose the default location click on Display Map link. Place a pin point to mark the middle of the map and change the zoom level.

1.8.1.1.7. Location filter

Location filter allows you to configure one or more fields that can be chosen and will be remembered as current location. All ads displayed will reflect that chosen location every time you open the browser, until you change it again. For example: you configure Country and Region as location fields, and when your users browse your site, they can choose their default country and region. That country and region will be used as their default location, so they can only see the relevant ads for them.

Enable location filter - enable location filter feature explained above. When this feature is enabled you will be able to choose a location on your site using the link from top right of the page, just above navigation bar. The selection can be made from an overlay window, in case you have multiple location fields selected, or from a drop down list, in case only one location field is configured.

Location fields - choose fields that will be used to remember the location. You can choose multiple fields, but use only fields related to location, for example Country, Region, City.

Enable location subdomains - Location subdomains feature allows you to configure one field to be used as a subdomain every time you select it as a location. An example would be to configure City as a subdomain field. When a user will select Paris for example, the site http://yourdomain.com will become http://paris.yourdomain.com.

Subdomain field - choose the field that you want to act as a subdomain field on your site. Only fields of type Menu or Depending will be used.

1.8.1.1.7.1. Configuring your server for location subdomains

This part will instruct you how you can prepare your domain name to use location subdomains. Note that these configurations are not possible for all hosting accounts, and are usually possible for those that own a dedicated server or virtual server. The reason for this is that some control panel softwares used by some hostings don't allow you to create a wildcard subdomain. However, if you own a hosting account and this is not possible to be done using the usual tools at hand ( hosting control panel ), then you can ask your hosting provider if there is a chance that they configure this for you.

This configuration consists of 2 parts:

Step 1. Create a wildcard subdomain

A wildcard subdomain is a subdomain reprezented by the character "*" , that will match all non existing subdomain names. For example *.yourdomainname.com will match for key1.yourdomainname.com , key2.yourdomainname.com and so on.

You will need to go to your hosting control panel and look for an area where you can define subdomains. Add one subdomain with the name * , pointing to your main domain. Note that the path where it points is very important! When you create a subdomain, the control panel will create it to point to the subfolder matching the subdomain name. Make sure you remove that subfolder from the path, leaving it to point to the main domain path.

Step 2. Add rewrite rules to your .htaccess file

You will need to uncomment the following lines in your .htaccess file

RewriteCond %{HTTP_HOST} !www.yourdomainname.com$ [NC]
			RewriteCond %{HTTP_HOST} ^(www.)?([a-z0-9-_]+).yourdomainname.com [NC]
			RewriteRule (.*) %{SCRIPT_FILENAME}?crt_city=%2 [NC,QSA]

To uncomment these lines, remove the # sign that is initially placed at the begining of the line.

RewriteCond %{REQUEST_URI} ^(.*)(/listings.html)(.*)$ [NC]

To test location subdomain functionality on a local server, you will need to have a DNS server installed on your local computer. This can be easily done on UNIX environments using for example BIND (named). We do not recommend trying this on Windows, as non server versions don't have a DNS server application. Once you have the DNS server installed, you can just follow the above steps to achieve a location subdomains setup.

1.8.1.2. Listing Settings

1.8.1.2.1. Listings display settings

Enable Sold - by enabling this option, users or you as administrator will be able to mark a listing as sold. A Sold corner ribbon will show on top of the small thumbnail picture on short version of the ad, latest ads or featured ads.

To mark a listing as sold you must click on Mark as Sold icon from user Browse Listings section or administrator Manage Listings section. The status can be reversed by clicking on Mark as Unsold icon which will appear for a marked sold listing instead of Mark as Sold icon.

Hide contact info when sold - if this option is set, when a listing is marked as sold the user contact information and profile will not be visible on details page.

Enable Rented - by enabling this option, users or you as administrator will be able to mark a listing as rented. A Rented corner ribbon will show on top of the small thumbnail picture on short version of the ad, latest ads or featured ads.

To mark a listing as rented you must click on Mark as Rented icon from user Browse Listings section or administrator Manage Listings section. The status can be reversed by clicking on Mark as Unrented icon which will appear for a marked sold listing instead of Mark as Rented icon.

Hide contact info when rented - if this option is set, when a listing is marked as rented the user contact information and profile will not be visible on details page.

Hide contact info for not logged in guests - if this option is set, only logged in users will be able to see contact information and user profile.

Show Stock No - Stock number is in fact the unique id number used to store the listing in the database. A listing can be uniquely determined using this stock number. If you enable this option, the stock number will appear on details page.

Show "More ads for this user" link - A button called More ads for this user will appear on listing details page when this is enabled. By clicking on this button, you will go to a page where all listings for the same user are. You can also see there user profile. The user profile visible on that page is composed by all fields the user enters in registration form and are marked as Public by administrator.

Show ad date - Select if you want the date when the ad was posted to appear.

Enable "Time ago" format for date - If you enable this option the date when the ad was posted will appear in the format: X minutes ago, X days ago. You can also configure a limit number of days to use this option for, and ads older than the number of days you set will appear in the usual date format (the format you setup as Short Date Format in Settings / Localization section). Use 0 if you want date to appear always like this, no matter how old ads are.

Days keep ads to Recent Ads - On Recent Ads page listings are shown ordered by posting date in descending order (latest posted listings are shown first). You can set here the number of days a listing is considered to be a recent listing and shown in this section. Listings older than this number of days will not be shown on this page. To set that all listings are shown, no matter how old they are, you can set this value to 0.

1.8.1.2.2. Submit form settings

Check for forbidden words - Set here if you want the system to look in the ad description when entered for forbidden words. You can set badwords list in Tools / Forbidden Words section.

There are 2 possible ways to deal with forbidden words, which you can choose from the next radio buttons:

Add Meta info with listings - When you enable this option, 2 extra boxes will appear to a listing submit form: Meta Keywords and Meta Description. These strings will be used for ad details page meta information.

Translate title and description - When your site is in multilanguage mode (uses more than one language for site frontend), use this option to allow entering a title and description for each language. When this option is enabled, for each language will appear a separate title and description box, with the language name or flag next to it.

Pending edited - This option will make listing modifications to wait for administrator approval. Not all listings will submit to this rule, the same rules from when posting listings apply, those listings which were to remain pending when posted will also have the modifications pending when being edited. More information can be found in Pending Approval Explained section. The following paragraphs will explain how pending edited feature works.

When an eligible listing for pending edited is modified (listing content or pictures), an email is sent to the administrator informing about the new changes to the listing which wait for verification. The administrator can check those modifications either by clicking directly on the link provided in the email, or by going to Listings / Manage Listings. In this section, the Selective browsing drop down menu will have Pending edited as a choice immediately after All listings option. By opting for that choice only pending edited listings will appear in the table.

Pending edited listings will appear marked with a green PE button in States column. By clicking on that button you are directed to the same page as the link you receive in the email which announces the pending modifications. That page will show the old listing and the new modifications, and the fields which are changed are marked in color. Clicking on Accept changes will make the modifications permananent to the listing and send an email to the listing owner informing that the changes were accepted. Clicking on Deny changes will remove the modifications from the record without making changes to the listing, and will also inform the user that the modifications were denied.

1.8.1.2.3. Auctions

Auctions are an alternative for the listing owner to set a fixed price. When an auction is created for a listing, instead of a price two new buttons will appear: one with details about the auction (starting price and maximum bid) and the other a button for placing a new bid. The listing owner can also see the current bids and the message attached to the bid.

Auctions can be managed by users from their My Listings account section.

Enable auctions - Check if you want auctions enabled.

Notify the owner when a new bid is placed - If this option is enabled the owner of the ad will be notified when a new bid is placed. The email template for the email is new_auction_bid.

1.8.1.2.4. Latest Ads

Enable Latest Ads - check this if you want latest ads box to appear on the first page.

Latest Ads No - number of ads shown in Latest Ads box on the first page.

Latest ads on a row - number of ads on each row of Latest Ads box on the first page.

1.8.1.2.5. Images

Here you can make some settings regarding images in the classifieds.

Image maximum dimensions - maximum dimensions allowed for an uploaded image. You can set here image width, height and size in Kb.

Image Resizing - if you want images to be saved in a smaller version on your site than the size the user uploads, you must check Resize image checkbox here. You also must set width and height for the resized image.

Small thumbnail dimensions - The dimensions that are used for the small thumbnail. This thumbnail will be used for the small version of the ad, ads from latest and featured ads on first page, and smaller images on listing details image gallery.

Big thumbnail dimensions - The dimensions that are used for the big thumbnail. This thumbnail will be used for bigger image on listing details image gallery.

Default small image - The image will appear instead of the small thumbnail when there is no image added for the listing.

Default big image - The image will appear instead of the big thumbnail when there is no image added for the listing.

Watermark - set an image to be used as watermark. Upload here an image of type .gif, .jpg, .jpeg or .png. If no image is added, no watermark will be added to your pictures.

You can delete the watermark image and with this disable watermark by clicking on the delete icon next to this field.

Watermark position - set the position on the image the watermark will be drawn in. You can choose one of the following: Top left, Top right, Bottom left, Bottom right or Center

Watermark transparency - you can set a transparency for your uploaded watermark image. The transparency is set in percents, from 0% to 100%. If you set the transparency to 0% the watermark will be drawn as you upload it over the image. If you set it to 100%, the watermark image will not be visible, because 100% transparency means actually invisible.

1.8.1.2.6. HTML Options

HTML editor for ad description - if you enable this option, the description field for posting ads will be a HTML area. Users will be able to format their listings using html elements visually.

Allowed HTML tags - No matter whether the option before is active or not, you can set here the HTML elements (HTML tags) that are accepted in a description field. All HTML tags that are not accepted will be automatically removed. You should allow here only harmless HTML tags like <br>(Line Break) <b> (Bold), <p> (Paragraph), <i>(Italic), <font> (Font), <center> (Center). You should not allow elements like: <script>(Script), <style>(Style), <frame>(Frame)

1.8.1.2.7. Search

Search in fields - define here the fields to search in when entering a string in Word field. By default you will have title and description selected. Add other fields if you want other fields to be searched.

Keyword search type - choose the type of search for the keyword field. You can choose between the following options:

Default search view - choose the default search view. You can choose between List View and Gallery View. This will be the default view for anyone who has not searched on your site before. Once another choice is made by a guest, the chosen type of view will be used until changed again every time the user returns on your site and opens a search page.

Enable search map - if checked, a map will show with the search results marked on it on every search page. It can appear opened or hidden, depending on the next choice Map visible.

Map visible - this is used only when the search map is enabled. If checked, the search map will be enabled by default, if not, users will need to click on show Map button to see it.

Search location fields - when Search Map is enabled, the methods of placing the ads on the map are 2:

Enable location autosuggest - when the guest starts typing in the Location textbox of the quick search form, a number of addresses will be suggested matching the typed string. This feature uses the Places Library in the Google Maps JavaScript API. This means you will need to ensure some conditions are met:

• You have a Google maps API key configured in Settings / General Settings section.

• Ensure that the Google Places API Web Service is enabled in the Google API Console, in the same project you used the Google Maps API Key from. Use the howto in the following link to guide you: https://developers.google.com/maps/documentation/javascript/places-autocomplete#GetStarted

• The Google Places API Web Service has a free usage quota as described in the Usage Limits documentation for Google Places API Web Service. If you exceed this limit you will need to purchase a paid plan.

Location components - assign each type of location components provided by Google Geolocation Service to your own custom fields. This way the search for a location formatted by Google will be able to show correct results. Not all components need to be matched, but you can choose between 5 types of address components: Country, Administrative area level 1, Administrative area level 2, City and Postal code

Limit the suggest to country - If configured, limits the location autosuggest to one or more countries. Enter the 2 letter codes for the selected countries separated by a comma. Use ISO 3166-1 Alpha-2 compatible 2 letter country codes.

Language used for location autosuggest - it changes the language of the suggested places. If nothing is configured, the browser language is considered by default.

Enable distance search - allows to search on a distance around the selected location using the top Quick search form. This feature uses the Geocoding service in the Google Maps JavaScript API. This means you will need to ensure some conditions are met:

• You have a Google maps API key configured in Settings / General Settings section.

• Ensure that the Google Maps Geocoding API is enabled in the Google API Console, in the same project you used the Google Maps API Key from. Use the howto in the following link to guide you: https://developers.google.com/maps/documentation/javascript/geocoding#GetStarted

• The Geocoding Service has a free usage quota as described in the Usage Limits documentation for Google Maps Geocoding Web Service.

The distance search is done based on location Latitude and Longitude calculations. A set of Latitude & Longitude coordinates are found for the location which is introduced in the form using the Geolocation service. But that set of coordinates needs to be matched with coordinates of the existing listings. In conclusion, to return correct results each listing needs to have a set of coordinates for its location. This makes it required to have defined a Google maps Listing Custom Field and that field to be mandatory.

Distance search measuring unit - choose between Km or miles

Distances list - enter the list of choices to appear for search distances, separated by a line

Enable save searches - Gives users the possibility to save searches to their accounts.

1.8.1.2.8. Location

Location fields- Because you can customize your listing fields, you can set the fields that specify the location differently. Using this setting you can choose which fields specify the location for your site. Location will be shown in short version of an ad, latest and featured ads. You can choose multiple fields here. If you choose more than one field, the location will be generated with all location fields separated by comma.

1.8.1.2.9. E-mail alerts

E-mail alerts is a feature that allows your visitors to be announced when listings that match a certain search are added to your site. The visitor will be asked to enter an email address and to choose the frequency to be announced with: Immediately, Daily or Weekly.

When enabled, a box will appear below a page where a search is in place: browsing by category or searching pages.

Enable E-mail alerts - enable email alerts feature.

Require at least one advanced key - will ask that besides a category, at least one more key to be chosen for the alert. You can see the search keys on the top of E-mail alerts box.

Require login - Users will need to login to use this feature.

Alerts require activation - For an alert to apply, the user needs to click on an activation link that he/she receives in an email.

Delete alerts after - Alerts are automatically deleted after this number of days.

1.8.1.2.10. Search by account type

Enabling this option will make appear 2 extra tabs in the search page, allowing your users to filter better the results by user type. The purpose is to make the distinction between the listings posted by private people and those posted by professionals (companies or online businesses). All you need to do is configure the user groups which will be considered Professionals as Professionals user groups. The rest of user groups will be considered Private

1.8.1.3. Site Appearance

Template - the template for frontend interface. If more than one template exists, choose here which one you want to use for your classifieds.

For the latest template Momentum you will also be able to select a colorscheme from a drop down box which will appear next to the template menu.

Administrator Interface Template - the template for administrator interface. If more than one template exists, choose here which one you want to use for your administrator interface.

Administrator Interface Language - choose the administrator interface language

Show Top Header - if enabled, the image set in the field below Top logo will appear on top of the site.

Top logo - upload an image which you want to show at the top of your site.

Small size Top logo - For small site widths like in case of browsing using a mobile or a small tablet, this is the logo which will be used on the top of your site.

Top logo link - if you want your Top logo to have a link attached, enter here that link.

Show Footer Logo - if enabled, the image set in the field below Footer Logo will appear at the bottom of your site.

Footer logo - upload an image that you want to show on the bottom of your site.

Footer logo link - if you want your Footer Image to have a link attached, enter here that link.

Show footer categories - if enabled, a list with all your categories will show up at the bottom of your site.

Footer text - the text that appears in your site footer.

Site Width - you can increase or decrease your site width by changing this value.

Display categories type - you can display categories in 2 ways:

Categories on a row - number of columns with categories shown on each row.

Count ads for categories - choose whether to display number of ads for each category.

Number of listings on page - choose how many listings will appear in a page.

1.8.1.4. Localization

Default Timezone - Use this setting to set the proper time. Choose the timezone that applies to your location.

Charset - change the charset used on your site. Change this only if your language requires a different set of characters.

Short Date Format - The short format for date.

Long Date Format - The long format for date.

If you want to change date format, please see here format specifiers:

http://dev.mysql.com/doc/refman/5.1/en/date-and-time-functions.html#function_date-format

Price Format - define the format for price (used only for price field, for other numbers Number Format is used):

Number Format - define number format:

The Numeric Format is used for numeric type custom fields. You can define a numeric type field by entering numeric as Validation Type. This is only possible for textbox type fields.

Default Currency - choose default currency

Currency position - choose currency position, to the left or to the right of price.

Listing Currencies.

The price field for listings, if enabled, has attached a list of currencies the user can choose from. You can edit here this list.

The list can be just one currency if your location uses only one currency frequently. In this case the currency will appear simply next to price field, the user will not have to choose it, it will be the default value.

1.8.1.5. Extra visibility options

In this section you can make settings for extra visibility options.

1.8.1.5.1. Listings Options

Enable Featured Ads - enable featured ads option.

Featured Ads will show on the first page under Featured Ads box. They are also marked with the Featured Ads button on short and detailed version of the ad.

Featured Ads No - set the number of featured ads shown in Featured Ads box on the first page.

Featured ads on a row - set the number of ads on each row for Featured Ads box.

Featured Option Availability - choose how many days this option is available. After this number of days the option expires (the listing will not be featured anymore). Set this value to 0 if you want this to never expire.

Featured Price - the price a user must pay if enables this option for an ad.

Autoscroll enabled - on templates that support it, this will enable an autoscroll movement for the featured ads, from right to left.

Prioritize Featured Ads - if this option is enabled, in search result pages, instead showing on top listings with Priority option, Featured ads will display first.

Enable Highlighted Ads - enable Highlighted Ads option.

Highlighted Ads will show with a different background color from the other ads on short listing version. Set this color in the following form, Highlighted Color.

Highlighted Color - the background color on short listing for Highlighted Ads.

Highlighted Option Availability - choose how many days this option is available. After this number of days the option expires (the listing will not be highlighted anymore). Set this value to 0 if you want this to never expire.

Highlighted Price - the price a user must pay if enables this option for an ad.

Enable Priority Ranking - enable Priority Ranking option.

Priority Ranking allows you to define different levels of priority for your ads. When browsing the listings, if not other type of ordering chosen, the listings will show up first the prioritized ones, then the normal ones. If you have more than one priority defined, then the listings with the lower priority order will show up first, for example first ones will be the listings with priority 1, then priority 2 and so on.

You will set the prices for each priority in the lower section Priorities List.

Show priority ads randomly - if you enable this option, prioritized ads belonging to the same level will not appear in the order of their posting date, but instead will be shown randomly.

Priority Option Availability - choose how many days this option is available. After this number of days the option expires (the listing will not be prioritized anymore). Set this value to 0 if you want this to never expire.

Enable Video Classifieds - enable Video Classifieds option.

Video Classifieds will allow the user to add a video to a listing. The video will show up on details page, instead of the big image on images gallery.

The difference between Video Classifieds and a video custom field is the place where the video shows. While for Video Classifieds the video will appear on top of the listing, instead of the bigger thumbnail, a video custom field will appear lower in the details page, below ad description. You will have to choose between these two which is convenient to you. It is not advised to use them both at the same time.

The Video Classifieds box will appear in submit listing form if enabled for the listing plan that was chosen for the listing in course of posting, and Enable Video Classifieds is enabled in Settings / Listing Settings .

If the user will choose as extra option for the current ad "Video Classifieds" option, then the box "Video Classifieds" will appear when returning on "Enter ad Details" step, or when editing the listing later.

Video Classifieds Availability - choose how many days this option is available. After this number of days the option expires the listing will not have Video option anymore. Set this value to 0 if you want this to never expire.

Video Classifieds Price - the price a user must pay if enables this option for an ad.

1.8.1.5.2. User Account Options

Dealer Page - you can make some settings regarding Dealer Page. Note that Dealer Page will not appear by default to any account and will not be allowed to be bought unless you have it enabled in the user group settings. See a detailed description on Dealer Page in User Concepts

1.8.1.5.3. Priorities List

If you use Priorities as extra ad options, then you should add here the priorities you want for your site.

To add a new priority use the form on top of the table. You must enter a name and a price for your new priority.

You can edit or delete existing priorities using Action icons in the table.

One thing important here is priorities ordering. Because listings with a higher priority order will appear on top related to other listings, you must set the proper ordering for priorities in this section. You can change order for priorities using the ordering buttons.

1.8.1.6. Seo Settings

This section allows you to make some settings related to Search Engine Optimizations. Please see Search Engine Optimization Features section for more information on site SEO features.

Enable search engine friendly URLs - check if you want to enable search engine friendly URLs for site frontend. This is done with URL Rewriting

Edit links structure - This only refers to the default URL structure mode, not the legacy mode.

Edit to change the word designated to a specific page. Note that if you change at least one of the pages words, you will need to mirror the changes in the .htaccess file. You will need to replace the old .htaccess rules contained between "# start SEF links structure" and "# end SEF links structure" comments with the block of rules you can copy when you click on current links structure link.

Search engine friendly URLs legacy mode - check if you want to use the legacy URL structure. You can see the differences between the normal and the legacy mode in URL Rewriting section.

Maximum URL Slug width

An URL Slug is the descriptive part of an url, written in an URL encoded manner. This can be a category name, a listing title, a user contact name, etc. For example, a listing with the title Two-bedroom modern house will result in the slug two-bedroom-modern-house. You can read more about slugs in URL Rewriting section.

This setting limits the number of character allowed to a slug. If this number is set to 0 there will be no limit considered, otherwise, the slug will be cut (conveniently after a word is finished) to a length less than this value.

Regenerate listings and users URL Slugs!

If you changed the previous setting you must use this button to regenerate slugs using the new maximum slug size value. This will only regenerate the listings and users slugs, if you need to edit categories or custom pages slugs you may do so by editing each category or custom

Google Analytics code - If you want to add Google Analytics to your site, then add here the code you get from your Analytics account.

Pages meta information table - configure for each of the pages which should be indexed by the search engines: title, meta description and meta keywords. You will see here a table with the page name and an edit button. Click the edit button and a form will show up to edit the meta information for that particular page. For each of the pages you will be able to edit:

For each of the pages you will see mentioned on top the tags you can use, if any. The tags are in the form %key, and are to be replaced by their correspondent, for example %category_name will be replaced by the name of the category, on certain pages like search page or listing details page where this makes sense. More information on possible tags you will find below, for each of the pages.

Smarty tags

In addition to internally defined tags you can use Smarty tags for more complex statements. Smarty is the template engine OxyClassifieds uses. You will see its syntax if you will look at templates, but also at Information and Email templates. In this particular usage for Seo Settings it only requires a low level of understanding about Smarty variables and how conditional statements work.

If you feel the need to check its documentation you can find Smarty 3 manual here.

This feature was built especially for search pages meta information, where the wide range of possible search elements require a more flexible environment, but it can be used on other pages also. This is why in the description below for each page, a greater focus will be placed on Smarty tags for Search pages.

Smarty variables - Variables are defined by strings in the form: {$variable_name}. This string will be replaced with the correspondent variable defined in the code.

Example: the following string:
{$category_name}
will be replaced with the current category name, in a php page where this variable has been defined.

Conditional sentences

	{if $var_name="value"} ... {/if} 

or

	{if $var_name="value"} ... {else} ... {/if} 

Conditional sentences are used for parts in the text which will appear if the condition is met. Optional it can be expressed an alternate text for the case when the condition is not met using the else branch. For example in the following part:

	{if $post_array.city} in {$post_array.city} {else} in France {/if} 

will display the text "in Paris" for example when $post_array.city variable is not null, which in Search pages case means that a city field was added to the search filter (in this case with the value Paris). When this variable is null it will display "in France".

Site index page [index.php] - here you can configure meta information for the main index page, and the page containing subcategories in case your site is configured to display categories in Browse mode instead of Tree mode. For the subcategories pages you can use the following tags:

Smarty tags which can be used:

Example: {if $cat}{$crt_category} - {/if}Best free classifieds

Listing details page [details.php]

Smarty tags which can be used:

Example: {$listing.region} {$listing.city} - {$listing.title}

Search page [listings.php]

Smarty tags which can be used:

Example: {if $post_array.region} {$post_array.region} - {/if}Post free classifieds - YourClassifieds.com

Here is a more complex example:

Contact details page [contact_details.php] - this page is for mobile pages only.

Login page [login.php] - there is no tag for this page, except for the location tags

User registration page [register.php] - there is no tag for this page, except for the location tags

Pre-registration page ( user group choices ) [pre-register.php] - there is no tag for this page, except for the location tags

Pre-submit ad page (choice between login or post wihtout a user accounr [pre-submit.php] - there is no tag for this page, except for the location tags

Recent ads page [recent_ads.php]

Refine search page ( mobile only ) [refine.php] - there is no tag for this page, except for the location tags

Dealer page [store.php]

Regular user page [user_listings.php]

Contact page [contact.php] - there is no tag for this page, except for the location tags

Favorites listings page [favorites.php] - there is no tag for this page, except for the location tags

1.8.1.7. Email Settings

Enable HTML mails - Send emails in HTML format. Enable this if you want to format your emails with HTML. If you enable this setting, you shoud edit the mail templates accordingly, and you should at least replace newline characters with <br> element .

By default the system sends emails using PHP mail() function. Some servers have this function disabled. For these cases there is another way of sending emails, using a SMTP server. The following section refers to this case. The settings below are not mandatory.

Use SMTP authentication - check this option if you want to send mails using a SMTP server. The following fields must be also completed.

SMTP server - enter SMTP server name.

SSL enabled - check this option if you use a SSL enabled account. For example Gmail accounts have SSL enabled.

Port - SMTP server port. The port is default 25. Do not change this value unless you know it is different.

Username - the SMTP username

Password - the password for the user above

Send BCC to - if you want that administrator to receive all emails sent from your site as a duplicate on an email address, enter here that address.

1.8.1.8. Payment Settings

1.8.1.8.1 Payment Processors

In this section you have listed the payment methods that our script supports. You can do some basic settings from the payment processors table, and you can configure each payment with your data.

Payment processors table elements:

PayPal

Paypal email - the email for your PayPal account

Paypal Payment Title - the title for payment that will appear on payment page.

Paypal Currency Code - choose the currency used for PayPal, from the list of currencies supported by PayPal.

Paypal Demo Mode - Use Paypal Sandbox for PayPal payment test. Note that a normal Paypal account will not work for this, you must create a developer account on https://developer.paypal.com/.

Canceling Paypal recurring payments. Note that if a subscription that has recurring payment enabled is deleted, the recurring payment is not canceled. A recurring payment can be canceled from the Administrator PayPal account, or from paying member PayPal account. To cancel the recurring payment, search for a payment for that particular subscription. This payment will have a referring link towards the original PayPal subscription. Click on [Cancel Subscription] button on the PayPal subscription page to cancel it.

2Checkout

2Checkout SID - the vendor id for your account.

2Checkout Secret Word - 2Checkout Secret Word is used to check the MD5 Hash passback after payment for security purposes. You can set up the secret word in your 2Checkout account from Look and Feel page of your 2Checkout account. This should be a single or compound word or group of letters and numbers with no spaces, of maximum 16 characters.

2Checkout Demo Mode - Use 2Checkout in Test Mode. Use this for payment tests only!

Skrill

Skrill email - the email for your Skrill account

Skrill Payment Title - the title that will appear on the payment page.

Skrill Currency Code - choose the currency used for Skrill, from the list of currencies supported by Skrill.

Skrill Language - choose the language you want the payment page to be in, from the language list supported by Skrill.

Skrill Demo Mode - use Skrill in test mode.

Authorize.net SIM - only Authorize.net SIM is possible to use from all possible Authorize.net payments. The payment is done on Authorize.net site and the credit card information is not kept on your site. You must configure the following with the information for your Authorize.net account:

Authorize.net login

Authorize.net transaction key

Authorize.net MD5 Hash - if you have configured one for your account.

Authorize.net payment title - the title used in payment page.

Authorize.net test mode - if you set your account in test mode, you must enable this option.

ePay - You must configure the following settings that you get from your ePay account:

PBS Merchant Number

Language

Currency

MD5 Key - if you configured it for your account.

Fortumo

Follow the next steps to configure your Fortumo account and the script settings for this payment type.

Here is an explanation on how you define a Fortumo service in your Fortumo account:

Fortumo payment works like in the following way: after the user makes an action that requires a payment, the info message will contain the following info: to complete the payment, the user needs to send a sms to the shortcode number, having as content the keyword you choose, plus a random code that will determine the operation he/she makes the payment for. The random code is important because it will be used to activate the listing or option for which the user paid, once the sms was sent correctly.

ICEPAY - You must configure the following settings that you get from your ICEPay account:

Merchant ID

Secret code

Language

Country

Currency

Description - enter a description for the payment

Success Url, Error Url, PostBack Url - use these values to configure in your ICEPay account the coresponding values

Country

PayTPV - You must configure the following settings that you get from your PayTPV account:

Client code

User number

Password

Terminal number

PayTPV currency

PayFast - You must configure the following settings from your PayFast account:

Merchant Id

Merchant Key

Item Name - enter a name for the payments.

Test mode - enable this if you want to test PayFast system with a sandbox environment. If you do enable it, use the following credentials for test: https://www.payfast.co.za/s/std/integration-guide#system.

HiPay - You must configure the following settings from your HiPay account:

Member account - get it from your HiPay account: Account Overview page, Account Number column

Website ID - in your HiPay account go to Sell with HiPay / HiPay integration / Merchant Tool Kit API and click Configure sites associated with the Hipay platform. Register a website for this payment. Get the id of the Test Site and enter it as Website ID (the current option) and get the Merchant Password and enter it in Merchant password field (following option).

Merchant password

Notification email - configure here the email where you want to receive payment notices on.

Category - configure this option in the following way: save payment settings once with the Website Id configured. Then a link will appear next to the Order category box. Click it and get the proper category from the xml document that will appear and set it as a value for current Category option.

Currency

Locale

Robokassa - You must configure the following settings from your Robokassa account:

Login

Password1

Language

Encoding

Payment description

Test mode

Result URL

Success URL

Fail URL

Klarna - You must configure the following settings from your Klarna account:

Merchant id

Shared secret

Currency

Country

Locale

Terms URI

Test mode

Stripe - You must configure the following settings from your Stripe account:

Secret key

Publishable key

Item name

Currency

Credits - This is a special type of payment. It allows your users to pay a greater sum once to buy credits, and then use the credits for any option that requires payment on your site. It also allows you as administrator give free credits for users, if you decide so. When this payment is enabled you will see an extra column for Credits in Users list page, and when you edit an user account you can modify the number of credits.

To use credits you need to make the following settings:

One credit equals - the sum for which one credit stands. For example, if one credit is $2, then to buy 2 credits a user needs to pay $4, and 2 credits can be used to pay once or multiple times for options in value of $4.

Enable for groups - you can choose to allow credits for all user groups, by leaving selected All User Groups, or you can only choose some user groups which are allowed to use credits.

Credit Packages - add as many credit packages, but at least one. Users will be able to buy credits using these packages from their main user account page. For each package you need to define a name, price, number of credits, and you can also configure each package for a certain user group.

Manual Payment - can be any type of payment that is not an online payment: check, money order, wire, even SMS payments. What these types of payments have in common is that after the customer pays, you need to check that payment manually, and if you received the money, enable the option the user paid for, from your administrator interface. Usually you set this type of payment as Pending. The listing or option or whatever the user bought from your site stays pending until you check the payment and accept it.

Free - is added here as a payment method for consistency. So when you make settings for the payment called Free, you make actually settings for not paid items. You cannot disable Free payment type.

1.8.1.8.2 Invoice Settings

If you want to generate downloadable invoices for the payments towards your site here is where you configure it.

Enable invoices - Enables invoices and every payment towards your will have a donwnloadable invoice.

Seller details - Place here the information about your company you want to appear on the invoice.

Invoice logo - The logo will appear on the invoice.

User fields - These fields will be used to get information about the buyer. Use fields like Contact name, Company name.

Invoice filename - The donwnloaded invoices will have the name composed by this filename followed by the invoice number. Ex.: invoice_name001.pdf

Custom text - If you configure any text here it will show at the bottom of the invoice as a text.

1.8.1.9. Mobile Settings

Enable mobile templates - Enable mobile templates for your site.

Template - choose the template you want to use for mobile version.

Enable mobile subdomain - When browsing with a mobile device, the site will redirect to the m subdomain, eg: http://m.yourdomain.com. Also, you will be able to view the mobile version with a normal device by accessing the m subdomain.

Number of listings on page - number of listings on a page for mobile version.

Show Top Header - check this option if you want an image to appear on the top of a mobile page.

Header image - use this form to upload an image to be displayed on top of your pages.

Header image link - enter a link for the top image. Leave blank if you don't want the image linked to anything.

Small thumbnail dimensions - width and height for small mobile thumbnail

Bit thumbnail dimensions - width and height for big mobile thumbnail

Default small image - upload an image to be used instead of the small thumbnail in case there is not image for the ad.

Default big image - upload an image to be used instead of the big thumbnail in case there is not image for the ad.

1.8.2. Manage Categories

1.8.2.1. Some terms explained

Parent Category and Subcategory - With our script you can display categories on more than one level. For example, you can have a category Jobs and under that category 2 more categories I'm looking for work and I'm offering work. In this case, the categories I'm looking for work and I'm offering work will be subcategories, and Jobs will be their parent category. You can have as many levels like this you want, for example the subcategories can have subcategories of their own, and so they will be parent categories for those subcategories.

1.8.2.2. Adding or editing an existing category

Click on the Add button to add a new category, or on an Edit icon to edit an existing one.

You will have to edit the following form:

Name - name of category. This field is required

Description - you may enter a description for this category, but it is not required

Picture - enter a picture for your category - optional. This picture will be used only when you select Display categories type as Browse Categories in Settings / Site Appearance section.

Icon - enter an icon for your category - optional. This picture will be used only when you select Display categories type as Tree Categories in Settings / Site Appearance section, and only for main categories (first level categories).

Parent Category - if you want this category to be a subcategory, then choose here the parent category. This newly created category will be added as a subcategory for the parent category you choose.

Fieldset - you must choose a fieldset for each category. Please see Fieldsets section for a more extended explanation for fieldsets.

Page Title - The title of the page for this category. If nothing is entered here, the value set in Settings / Seo Settings will be displayed as title instead.

Meta Keywords - meta keywords for this category

Meta Description - meta description for this category

Allow to post ads to category - you can choose that only some user groups have access to post to this category. If you want this, you must choose on the radio buttons that follow, instead of All User Groups, which is default, Only selected groups. A new select box will appear below. Select the groups that will be allowed to post ads in this category. You can choose multiple groups by keeping CTRL pressed down.

1.8.2.3. Browsing existing categories

You can view the existing categories in a table. You can edit, delete and view the allowed user groups list for each category using the icons attached to every row.

You can also change categories order here by using the ordering buttons. The categories will appear ordered by the order you see on this page.

1.8.3. Fieldsets

Fieldsets are a way to link categories with custom fields. If on your site you have categories that need different fields each of them, then you can group those fields on fieldsets Ex: you will have a fieldset for Auto and one for Real Estate. Both categories and fields must be assigned to a fieldset (for fields you can choose to assign them for all fieldsets if you want to, then they will appear for every category).

Fieldsets are supposed to ease the work when adding fields and categories. For example, when you add a new category you will only need to choose the right fieldset for it, not to edit the fields to make them show for that category. Please see an example for setting up fieldsets, categories and custom fields in Setup Example.

1.8.3.1. Adding a new fieldset or editing an existing one.

Click on the Add button to add a new fieldset, or on an Edit icon to edit an existing one.

You will need to enter in the form that follows a name (mandatory) and a description (optional).

1.8.3.2. Browsing existing fieldsets

You can view the existing fieldsets in a table on Settings / Fieldset page. You can edit, delete and view the categories that are added to this fieldset using the icons attached to every row.

1.8.4. Listing Custom Fields

With Listing Custom Fields you can customize ad submitting forms. This is very important for your classifieds site, so you should read the following carefully.

The fields you see in the table on this section will appear on the submit form, in the same order, not necessarily all of them because you can set some fields to appear only to some categories, as we will explain below.

1.8.4.1. Adding a new custom field

To add a new custom field click on Add button on top of custom fields list. You will need to fill in a form, and we will explain each field below.

Fieldset - you can choose to which fieldsets to link this field to. By doing this, you actually link the fields with categories. If you want the field to appear for every category, leave the default All Fieldsets value. Otherwise, choose Choose Fieldsets and then select from the following list one or more fieldsets.

Type - there are some type of fields you can choose from, depending on how you want to use this field:

Name - name of the field.

Error Message - the error message shown when the field is required and no value was entered or if the user entered a wrong value.

Info Message - an info message that will help the user enter a correct value

List Top Value - (only for menu field type) - the first value that shows on a menu field and that is visible without choosing anything in this field. This value usually is the same as name of the field, or a value like Choose country for example.

Is Numeric - choose this if your field will contain only numeric values.

Number Format - if the Is numeric checkbox is selected then you can configure here the format for the numeric field. You can configure number of decimals, decimals point and thousands separator.

Validation Type - (only for textbox field) - you can set that the value entered in a field to be validated. You can choose one of the predefined types: alpha, alphanum, digit, numeric, price, email, url or enter a valid regular expression. Ex: ^[A-Z0-9._%-]+[A-Z]$

Validation types explained:

Input Field Size - (only for some of field types: Textbox, Textarea, HTML Area, Url, Email, Date, Multiselect, Youtube). This defines the field size. For the one dimensional fields (Textbox, Email, Url, Date) you must enter a number. Ex: 30. For the 2 dimensional field types like Textarea, HTML Area, Multiselect and Youtube, you must enter the number of rows and columns for this field separated by X: CXL. Ex: 50X4

Minimum Characters - if you want a minimum of characters set in this field, then enter it here. Otherwise leave 0 as value.

Maximum Characters - if you want a minimum of characters set in this field, then enter it here. Otherwise leave 0 as value.

Minimum elements selected - this is a special setting only for Multiselect fields. If you want a minimum number of elements selected from the list use this setting.

Maximum elements selected - this is a special setting only for Multiselect fields. If you want a maximum number of elements selected from the list use this setting.

Default Value - if you want a default value set to this field you can set it here

Prefix - a string or a character that you want placed before that field. The prefix will also show up on details page once set up before the value filled in the field.

Postfix - a string or a character that you want placed after that field. The postfix will also show up on details page once set up after the value filled in the field.

Date format - (only for Date field type) - you can set the format for date.

Date format uses the following encoding values: d, dd, D, DD, oo, m, mm, M, MM, y, yy . Please see below the explanation for each code:

Maximum uploaded size - (only for File and Image types) - the maximum size allowed for a file to be uploaded on this field.

Allowed Extensions - (only for File types) - you can allow only some file extensions to be uploaded on this field. Use comma separated values. Ex: pdf,doc,txt.

Resize Image to - (only for Image type) - the uploaded images will be resized to these dimensions. Leave blank if you don't want the images to be resized! The image size should be in the form: WXH, where W=image width and H=image height. Ex: 150X100 - the image will be resized to a smaller image with 150px width and 100px height.

Elements - (for types: Menu, Multiselect, Radio Buttons, Radio Buttons Group and Checkbox Group) - enter here the values to select from. For example, for a Menu field type, these values will be shown when you drop down the menu list as elements of the list, for Radio Buttons will be the actual choices for the radio button and so on.

You can add multiple elements to the list separated by | sign or each on a separate row.

Accept other values - ( only for Menu and Depending Fields) - the user will be able to add other values than the ones in the list, by choosing the "Other" value in the list and typing in a textbox.

Refine Search - the field will appear in refine search box. This is not acceptable for some field types: Image, File, Google Maps, Checkbox Group and Radio Group. For these types of fields you will not be able to choose to appear in Refine search box.

Quick Search- the field will appear in quick search box. This is not acceptable for some field types: Image, File, Google Maps, Checkbox Group and Radio Group. For these types of fields you will not be able to choose to appear in Quick Search box.

Search type - you can choose what kind of search will be performed on this field:

Search Values - Will show up only when your field is a textbox field, you enabled Is Numeric for it and you choose as Search Type Interval. Enter here the list of numeric search values that you want to attach to this field. When this field will appear on a search box (Quick Search or Refine Search), it will appear as two drop down list, one for minimum value and one for maximum value, each drop list containing the values you enter in Search Values field. You can add multiple elements to the list separated by | sign or each on a separate row.

Required - the field is required / mandatory. If it is not filled in, the error that you fill in Error Message will show.

Editable - choose if the field is possible to edit when editing a listing. If the field is not Editable, then after posting the ad the field will not be possible to be edited by the listing owner.

Unique - When this option is enabled, the value for that particular field needs to be unique in the database. If same value exists already in the database for that particular field, it will not allow it and show the error configured in Unique field error message. This option comes handy if you will use the newly added SMS validation option. It will stop users creating multiple accounts with the same phone number.

Unique field error message - The error message displayed when the value entered for a Unique configured field already exists in the database.

Active - or enabled. If the field is not active, then it will not appear in the submit form or on details page. You can use this if you want to disable some fields temporarily, without deleting them.

Validation and International format - This is a special option for Phone fields only and it formats and validates a phone field in international format. When enabled it will show a drop down list in front of the field containing country flags. When selecting one country flag the phone field will be prefilled with a sample format number. Invalid numbers are not accepted and the number is stored in international format in the database.

Show prefixes only for countries - When Validation and International format is enabled for a phone field you can limit with this option the number of countries displayed in the drop down list. By default all countries are shown, but if your business is localized in a specific area you can list here the countries you want allowed. Use comma separated 2 letter country codes (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) like for example: gb,de,fr,es

1.8.4.2. Editing an existing custom field

You can edit an existing custom field by clicking on Edit icon in the custom fields table.

When you edit a custom field, the only difference is that you will not be able to change the field type. The type will remain the one the field was initially created with. All the rest of the configuration fields are the same.

1.8.4.3. Depending Fields

As we mentioned before, Depending Fields is a special type of fields that will show 2 or more (up to 4) menu fields. Fields starting with second one will have a list of values that depend on the selected value for the previous field.

We will treat depending fields separately because they configure differently from the other fields and have separate configuration pages.

Adding a custom depending field - you add a depending field the same as other fields, by choosing the Add button. Once you are on the Add custom fields page, you must select as field type Depending Field. This will show you the following fields:

Fieldset, Type, Name, Info Message, Is Numeric, Accept Other Values, Refine Search, Quick Search, Editable and Active - were previously discussed in the previous section so we will not explain them again.

Depending Fields Number - choose how many fields you want one depending on another. You can choose 2, 3 or 4.

Field no N - name for the N-th menu field (N can be from 1 to 4)

List Top Value N - top value for N-th field

Error Message for Field no N - the error that will show if N-th field is marked required and no value is chosen

Field no N required - choose if N-th field is required

Edit depending fields - you can edit the settings for a depending field by clicking on Edit icon in the fields table.

Edit depending fields values. Here is the page where you actually enter the values for each of the menu lists. You will be always taken to this page after creating a depending field. If you want to change the values later, then you can click on the purple button Edit Values which is located just below the field name.

On edit depending field page you have an area for every of the fields. The first one is for the first field, and you can add values separated by comma or newline. For the following field, when you enter values, you can choose for which value of the previous field you wish to add the values.

One special case is that which, when adding your depending field, you choose a number of fieldsets for the field, not All Fieldsets value. In this case, you can add different values for the first field for each fieldset.

One example for this case would be a depending fields used for Makes and Models. When adding this field, you choose it for the following fieldsets: Cars, Motorcycles and Boats. Because each of the categories for cars, motorcycles and boats will have different makes, you would not want them mixed together. In this case, when editing the depending field values list you will enter values for makes for each fieldset: first choose Cars from fieldset list and enter the makes and models list for cars. Then do the same for Motorcycles and Boats. As a result, depending on which category the user will choose, the correct makes list will show.

The benefit in using this technique against the one where you add a field for each fieldset (Cars makes and models, Motorcycles makes and models, Boats makes and models) is that you will have a single field for Makes and Models, not one for each category type. So in your search forms will not appear duplicate fields, but a single field that will change its list of values with the proper one, depending on what category you choose.

If you want to enter values that are common to all fieldsets, then you can add values for All fieldsets selection. Those values will appear for all fieldsets set for this field.

1.8.4.4. View and manage listing custom fields

In the table from Settings / Listing Custom Fields section you can see and manage the existing custom fields. You will see some information about the fields on each of the table columns. One column that we should explain is Database Field. This field shows the name of the column where the information entered with a listing is kept on the database, in the listings table. Use this value as reference if you want to set other searchable fields from Settings / Listing Settings - Search in fields field, when setting the location field in Settings / Listing Settings - Location fields. Or in case you want to define Import / Export templates.

Other action that you can make on custom fields here is changing order. Like in case of categories, the order that you see here is the order used for the submit form. For the details page it is a little different, all the fields that occupy more space are placed after the ad description Ex: Youtube fields, Google Maps fields, HTML Area fields, Checkbox Group fields.

Using the Action icons you can perform the following actions on the fields:

1.8.5. User Custom Fields

In the same manner as you can customize submit ad form from Settings / Listing Custom Fields, you can customize the registration form in this section. These custom fields will form the user profile, and are very similar to listing custom fields. This is why we will only point out the differences between these two sections.

Here also read only fields exist, but here are different ones: Username, Email, Password.

There is also a special field called Contact name field. It is not a read only field, but there has to be one custom field at all times assigned as a Contact name field. It is strongly encouraged to configure this field as a required field. The Contact name field is marked in the fields table with a dark gray label. Clicking on that label a window will open which will allow you to change the contact name field to other field. Also when you delete this field a similar window will appear asking you to choose another contact name field.

On user custom fields there are two extra type of fields:

Terms and conditions. This field added to the registration form will require that the user checks a checkbox (by which he agrees to your site terms and conditions). When you choose this type of field, a box named Terms and Conditions will appear. Place there your site terms. You should also place an error message that will appear if the user did not checked the checkbox, and an info message that should express that the field must be checked in order to register.

There are 3 more settings that appear for a field in Add or Edit area:

Not logged in guests only - use this to enable this custom field for not logged in guests that post ads. The field will appear in submit ad form, in Your information section, section containing information about the person posting the listing.

Public - if the field is public, not public, or the user can choose if it is public or not. A public field will appear in the user profile on details page or on Dealer Page or the similar More listing for this user page. In other words, the field will be public for other users or guests. If the field is not Public, then it is only visible for administrator and owner. If you select the 3rd option User choice, then next to the field in registration and edit account information forms a new checkbox will appear Make public. The user will be able to choose whether this field will be visible or not.

Use Field For - if you use more than one user groups, choose here the group you want this field to appear for. You can customize like this the user groups to ask different information. For example, if you run two different groups, one for private users and one for companies, the registration form for companies could contain extra fields, like company name, address, location on map, company logo, and so on.

1.8.5.1. Logging in with username or just email address

You can allow your users to login using with their chosen username, or you can allow them to login with just their email address. This can be configured only by enabling or disabling the Username field.

The Username field is a read only field, so you cannot delete it. But you can disable it, and when you do, the registration form will not require a username, only an email address. The login process will also require an email address and a password. When this field is enabled your users will need to use the username in order to login.

1.8.6. Languages

This script can be used as a multilanguage site. You can define multiple languages and users can switch between languages from site frontend.

1.8.6.1. What multilanguage adds to your admin interface

Changing a language does not refer only to changing the translation for the language file. There are other elements in the database that need to be translated like: categories names and description, field names and other elements related to fields, email messages and info messages, and so on.

When adding a new language you will see duplicates of some fields in the admin area for each of the languages. These fields are usually string fields that are visible from frontend. Here is a list with these elements:

When you add a new language, if a file with the name "Language Id.php" does not already exist, one is created with this name by copying the default language file with a new name. Ex: if you create a new language Spanish , with the Language Id esp, a file esp.php will be created for this language. For the translations that don't already exist for our script, you will need to translate this language file from Templates / Language Editor section.

1.8.6.2. Adding a new language

You can add a new language by clicking on Add button from Languages page. You will have to fill in a form:

Language id - must be unique, you cannot add two languages with the same id. Enter here a short code for your language, without spaces. This id will be used for the language file name and as id for your language in the database.

2 letters language code - use the proper 2 letters iso code for the new language. The can be found in the following list http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes. This code is used to automatically select the proper language using the language set for visitor's browser.

Language Name - The name for your language. If you don't set a language image, then this name will be placed on frontend for users to choose from to switch between languages.

Language Image - as we stated above will be used on frontend to switch between languages. It will also be shown on administrator interface on fields that have different versions, one for each language.

URL special characters replacement set - URLs allow a limited set of characters. This is why special characters need to be either encoded or replaced by a a-z equivalent letter. Choose here the proper characters map set to be used to replace the special characters. You should choose the all sets that are likely to be found on your site.

Text direction - you can choose either left to right or right to left text direction. The templates will change accordingly when a right to left language is chosen.

Default - one language (and only one) must be set as default. That language will be the default language when someone enters the site. After a visitor chooses other language, the option will be remembered in a browser cookie and next time that visitor will enter the site that chosen language will be set by default.

Enabled - if the language is not enabled it will not appear in site frontend.

1.8.6.3. Managing languages

You can see the existing languages in the table from Settings / Languages section. You can perform a series of actions with Actions icons for each language:

You can also change languages order with Order buttons. The order will be used on site frontend, to display the languages visitors will choose from.

1.8.7. SMS gateways

If you use SMS validation for user accounts or for listings posted without an account, then you must configure here a SMS gateway.

This page contains a table with the supported SMS gateways in our system. The SMS gateway configured as Default will be used for sending SMS. It is not possible to use multiple SMS gateways, just the default one will be used.

When you pick a Default SMS gateway you will also need to create an account with their company, if you don't have one already. You will also need to purchase credits with the SMS gateway company in order to be able to send SMS messages. Make sure you don't run out of credits, because in that case SMS messages won't be sent and then users won't be able to activate their accounts or listings. The prices differ with company and country to which you choose to send messages.

Use the details you received when registering to the SMS gateway site in order to configure the SMS gateway in OxyClassifieds SMS gateways section by clicking on Edit Settings button.

1.9.1. Adult categories

This module allows you to ask your guests to agree a disclaimer when accessing a list of selected categories. It is meant to make your site comply with different laws which ask site owners to warn their viewers about possible adult content.

Possible settings for this module:

Categories list - list of categories which will ask for disclaimer agreement.

Cookie availability - The terms agreement will be remembered and not be asked again until this time period passes.

Disclaimer text - The actual disclaimer text.

1.9.2. Area Search

This module allows you to add area search to your search forms. Area search means searching ads that have the location within a given area in miles or Km from a zip/postcode geographical location.

When this module is enabled, on Quick Search and Refine Search forms, instead of the field Zip that is added with any installation will appear two fields:

In order to work, this module needs a database with your country zip/postcodes that contains geographical coordinates (longitude and latitude). By default the module contains databases for USA and UK. If you want to use this module and your classifieds is for another country you will need to search for one yourself. Keep in mind that you need to search for one that contains longitude and latitude coordinates. You will find lower in this section some information related to some places where you can find them.

When entering this module Settings section you will find a series of subsections:

Importing new data

For importing zip data csv format is used. This is a widely used format, and if you purchase or download zip data, usually you will find it in this format. The format assumes data for each zip/postcode on a separate row, with data columns separated by a sign, usually comma. You can specify a different sign if your database uses a different one in Column Separator setting. Also, these columns can be enclosed in quotes or other sign, to make the delimitation even better. This sign can be set as Field Separator.

Data fields that are needed for each zip are: zipcode/postcode, latitude and longitude. Since databases come in different formats, with additional fields like city, district, state and so on, you will need to specify the column number for each of the needed fields in Columns Ordering. The order is usually found in the first row of the database, with a # sign in front. Please write down the order for the fields you need, and then remove this first line.

After you filled in the upper information, browse the file that contains your database. This file should have one of the following extensions: .csv or .txt. If it does not have this extension, but you know it is csv format, you can simply change it to one of these.

Information about zipcode databases

The databases included in our script are for the following countries:

UK - free database thanks to freethepostcode.org team. You can see a coverage map here: http://wiki.openstreetmap.org/wiki/Free_The_Postcode_UK_Coverage. You can always download an updated list from the following link: http://freethepostcode.org/currentlist.

USA - free database thanks to boutell.com.

Other unincluded free data:

Canada - you can download a free database for Canada from http://www.populardata.com/postalcode_database.html

Lots of countries databases: http://www.geonames.org

If our script does not have zip/postcodes data for your country, of you consider it incomplete or not up to date, you can purchase a commercial database from one of the following sites:

1.9.3. Banners location

This module allows configuring banners for a certain location only. Choose one field to act as the location field for your banners, for example Region or City and you will be able to configure each banner for a specific value of that location field.

Note that configuring locations for banners makes sense only for listings search page and listing details page. For all other pages location is irelevant, so it will show banners regardless of location. If you want the banners you're configuring with a location to appear only when that location is selected, you will need to configure it only for sections details and listings

You can make the following settings on this module:

Location field - choose the location field for banners. You can only select a single field.

Display any banner with no location set when there are no banners for a specific location - For example you are on a search page searching for Paris, but you don't have any banner configured for this city. If this box is checked, then the script will display any other banner that wasn't setup for a specific location.

1.9.4. Browse by Location

This module will show on first page of the site a box with locations listed and linked towards a search page for that location.

You can make the following settings for this module:

Title - is the title that will be shown on top of the box, if you choose Single type for this module (see below more explanations).

Number of columns - number of columns shown in the first page box.

Mode - this module can work in two modes: Single and Double. In Single mode, you will choose the Location Field to be a menu type custom field, and the values contained as this field elements will show in the location box in the first page. In Double mode , you will choose the Location Field to be a depending type custom field (for example Country & Region field). As a result, the first field values (Country values) will show on top of the box as tabs, and second field values (Regions) will show in the box as locations. When clicking on the top tabs, you can choose a different set of locations, in our example regions for another country.

Location Fields - you must choose here one of the custom listing fields that you defined in Settings / Listing Custom Fields section. In in single mode, the fields that you can choose from are Menu fields, if in Double mode: Depending fields.

Example1: you have a menu field defined for regions named Region. Choose Single mode and this field as Location Field and the values you entered as field elements will be listed in this module box.

Example2: you have a depending field defined for countries and regions named Countries & Regions. Choose this field as Location Field and the values you entered for first field of this depending field ( Countries ) will be listed in top of module box as tabs, for example you will have one tab USA, one tab for UK, one for Canada. The values you enter in the second field of depending field (Region) will appear in the module box. When clicking on one country tab, locations list will change to regions belonging to that country.

1.9.5. Browse by Car Make

This module was meant to show on first page of the site a box with car makes linked towards a search page for each make. But it can be used to display other information instead of car makes if your site is not a car based classifieds and you need this module functionality.

You can make the following settings for this module:

Title - is the title that will be shown on top of the box, if the chosen field for this module is not assigned to multiple fieldsets (see below more explanations).

Number of columns - number of columns shown in the first page box.

Make field - you must choose here one of the custom listing fields that you defined in Settings / Listing Custom Fields section. The fields that you can choose from are Menu or Depending fields.

Example1: you have a menu field defined for makes list named Make. Choose this field as Make field and the values you entered as field elements will be listed in this module box.

Example2: you have a depending field defined for makes list named Makes & Models. Choose this field as Make field and the values you entered for first field of this depending field ( Makes ) will be listed in this module box. If this depending field has different values for different fieldsets, then instead of the module title will appear tabs with the fieldset names, and when changing fieldset tabs you will see the values for that fieldset. For example, if your field is assigned to both fieldsets Cars and Motorcycles, two tabs will show on top of Browse by Car Make called Cars and Motorcycles. When clicking on Cars tab, cars makes will show, when clicking on Motorcycles tab, motorcycles makes will show.

1.9.6. Comments

This module will add comment capabilities to each details page.

When entering this module settings page you can see two areas: first, Comments, where you can view and manage existing comments, and second, Settings, where you can make settings for this module.

Comments - you can view information about each comment: post date, user (if was posted when logged in) , email address, and you can also perform some actions on them: Edit, Delete, Enable/Disable and Block Ip it was posted from.

Settings - The possible settings are the following:

Require Login - If this is enabled, you must login first to be able to post a comment.

Admin verification - Choose if you want to verify each comment before allowing it to show. You can choose between: Always, Never or When not logged in. If you choose the last option, only comments that are posted by guests (not logged in users) will wait for your approval.

Use image verification - Choose if you want to use image verification for posting comments. You can choose between: Always, Never or When not logged in.

Email field - Choose if you want the email field added to comment submit form. You can choose between: Required, Do not use or Optional.

Website field - Choose if you want the website field added to comment submit form. You can choose between: Required, Do not use or Optional.

Use HTML editor - Check if you want the comments text box to appear as a HTML editor.

Check for forbidden words - Check if you want the content of the comments to be checked for forbidden words. The list set in Tools / Forbidden Words will be considered.

Allowed HTML tags - Choose here which HTML tags to allow in your comments text.

Use as logo - If you have any image custom fields defined in your Settings / User Custom Fields section, for example a logo image for each user, you might want to use it to show next to each comment posted by that user. Use this setting to choose that field.

Comments terms - Add here a Terms and Conditions text that you would want shown next to the comments box.

1.9.7. Compare listings

This module will allow you to add listings compare functionality to your classifieds site. When installed, from each short version of the ad and from listing details page you will be able to add a listing to compare list by clicking on an Add to compare link. If the listing is already in the compare list, you will be able to remove it. You also will have a list containing titles of the compare list on the left of listings search page and on the right of listing details page.

When going to the compare listings page you will be able to see the compared listings one next to other so you can compare the details for these listings.

There are no settings to be made on this module.

1.9.8. Connect

This module will add to your site the capacity to accept login using FaceBook, Google and OpenID accounts.

You can make the following settings on this module:

Enable Facebook Login - check this box if you want to enable Facebook login.

Access the following page: http://www.facebook.com/developers. You will be asked for permission to access your basic information. Accept this in order to move forward.

Use Set Up New App button in order to create a new application. You might need to confirm your Facebook account using a phone or credit card confirmation. You also need to fill in your Site Url under Web Site settings tab in Site URL field. To reach this settings page you need to click on Edit Settings after creating the new application.

Facebook App ID - enter your Facebook API ID gained from the actions described above.

Enable Google Login - allow users to login using their Google account.

Google Client ID - use the following guide to get your Google Client ID: https://developers.google.com/identity/sign-in/web/devconsole-project

Enable OpenId Login - allow users to login using their OpenID account.

Contact Name field - when the authentication is made first time, the name is remembered under this field.

Register as user to group - when the authentication is made first time, the user is registered as belonging to this group.

1.9.9. List Dealers Page

This module creates a page where all dealers are listed.

You can make the following settings on this module:

List all users with dealer page - lists all users that have dealer page enabled in their account.

List Groups - list users belonging to this group.

Link to navigation bar - If this checkbox is selected, a link will appear in the navigation bar taking to the dealers page.

Link name - If Link to navigation bar is enabled then you can set here the text you want to show up in the navigation bar.

Logo field - If you have an image logo field setup for your users, choose it here, and it will show up in the left side of each dealer box. If you have Dealer Page enabled you can choose Dealer Page Banner as the dealer logo.

Name field - The field that will stand up as the main field (name or company) for dealers.

Details fields - Choose here other dealer details fields that you want to show up.

Search fields - The fields you choose here will appear in dealers page as search fields, to allow users to search for different terms.

Group dealers in categories - If you check this box dealers will appear grouped by values for the Category Field.

Category Field - Configure this with a menu type User Custom Field.

Number of categories on a row - Dealer categories on this many columns on the dealers page.

Page title, meta description and meta keywords - the page title, meta description and meta keywords on the dealers page.

Enable search map - on the dealers page a map will show with the current page dealers location.

Map visible - if checked, the search map will be enabled by default, otherwise you will need to click on Show map button to see it.

Search location fields - choose the fields which will be used to establish the location on the map, when search map is enabled.

1.9.10. Loan Calculator

This module will display a loan calculator box on each details page which will calculate monthly payment for a certain amount and considering other factors: Down Payment, Trade in Value, Loan Amount, Sales Tax, Interest Rate and Loan Term.

You can make the following settings for this module:

Module Title - the title shown above the loan calculator box.

Categories list - if your site is not a Realty based classifieds but it works in multiple fields, then using this setting you can configure only the categories which are Realty based to use this module.

Use "Trade In" field - choose to show a Trade In field in loan calculator box if this applies.

Default Down Payment - default value for Down Payment.

Default Interest Rate - default value for Interest Rate.

Default Loan Term - default value for Loan Term in months.

Default Sales Tax - default value for Sales Tax.

Currency - the currency used.

Text - add some explanatory text to the module box.

1.9.11. Meta extension

This module allows you to customize meta information for different search pages.

By default the search page will show meta tags set by you in Settings / Seo Settings page, or a category meta information, if a category is chosen as a search term. This can lead to many different search pages to have same meta information. This module helps you set different meta information for as much search pages as you want. This way your site can achieve higher search engine ranking.

The module functions in the following way: after installing this module click the Settings button. From the page you're redirected to, add a new "search - meta information" pair by clicking on the Add button on top. You can enter here page title, meta keywords and meta information, and fill the parameters of the search: category, search word, and other fields that you have in your database. When the guests will look for these terms, the meta information you enter here will show. When a search is made, the best match within your added meta extensions is considered (the one with the best number of search fields matched ).

For example: You have added in your meta extension module the following:

			1. title = Title for first case
			meta keys = Meta keys for first case
			meta description = Meta description for first case
			
			category = Real Estate
			country = Canada
			state = Ontario
		

			2. title = Title for second case
			meta keys = Meta keys for second case
			meta description = Meta description for second case
			
			category = Real Estate
			country = Canada
			state = Ontario
			city = Toronto
		

For a search like this:

			category = Real Estate
			country = Canada
			state = Ontario
			city = Toronto
		

The second meta info is used because it matches more terms than for the first one.

1.9.12. News

This module will allow you to add news articles to your classifieds site. The news articles will appear on the first page as a short version, and as full version when you click on Read more button.

You can make the following settings on this module:

Title - the title that will appear over the new box on the first page.

Number of news on first page - number of short version news that will appear on the first page.

Number of news on each news page - when clicking on Read More button and you are taken to a news list, on each page will appear this many news.

1.9.13. Promote listings

Some listings might not get the views they need. This module allows you to warn users which listings don't get enough hits that they can use your extra options in order to promote their listings.

You can configure the following: the number of hits is considered a low number of hits, the number of days for which the hits are calculated and an email template for the email sent to the listing owner. If for any listing, in the configured number of days the total hits does not reach the hits number you configure, then the listing owner will receive an email. The email should contain as much information as you can about the extra options you enabled on your site: featured, highlited, priorities, video classifieds.

1.9.14. Popular Ads

This module will make appear a box of most popular ads in the front page. Ads with most number of views are shown here.

You can make the following settings on this module:

Title - the title that will appear over the popular ads box.

Number of popular ads - number of popular ads.

1.9.15. Ratings and reviews

Using this module you can enable ratings and reviews for users or listings.

You can make the following settings on this module:

Allow to rate - choose the behavior of the module regarding rating same resource multiple times. You can choose between the following values

Require Login - you will be required to be authenticated to be able to rate.

Rate listings - enable ratings for listings.

Rate users - enable ratings for users.

Users cannot rate themselves - if this is enabled one user will not be able to rate himself or his/her own resource.

1.9.15.1. User reviews settings

Enable reviews - check if you want user reviews enabled

Use for groups - you can select here the user groups you want to allow reviews for. Leave unselected if you want this to apply to all user groups, or select all.

Admin verification - you can configure reviews to wait for administrator approval or not, or just in case a not logged in guest posts the review.

Use image verification - you can configure reviews to ask for image verification or not, or just in case a not logged in guest posts the review.

Title field - choose if you want to use title field for the review and if you want it to be mandatory or not.

Email field - choose if you want to use email field for the review and if you want it to be mandatory or not.

Website field - choose if you want to use website field for the review and if you want it to be mandatory or not.

Use HTML editor - choose if you want to use html editor or not for the review content.

Check for forbidden words - choose if you want the review content checked for forbidden words.

Allowed HTML tags - select here the html tags you want to allow in the content of a review. You should only choose harmless tags like <b>, <br>, <span>, <p>, <em>, <font>, <i>, <strong>, <u>

Use as logo - you can choose an image field to be used as a logo for the ones which post the review using their user accounts. Note that the script will not shrink the image, you should only use image fields which have a size limit or resize the images to avoid breaking the design of the page by displaying large images.

Reviews terms - if you want to display terms for posting the reviews you can add them here

Number of reviews on page - the number of reviews on a page, if more than one page exists.

1.9.15.2. Listing reviews settings

This subsection has similar settings like the previous one and will not be explained.

1.9.16. Similar Ads

This module will make appearing on each listing details page a box with similar ads.

You can make the following settings on this module:

Title - the title that will appear over the similar ads box.

Number of similar ads - number of similar ads.

Number of similar ads on row - number similar ads on each line. If this number will be lower than Number of similar ads, then ads will appear on multiple lines.

Match category - if the similar ads need to be from the same category as the current listing.

Match fields - select the fields that need to be matched when choosing similar ads. For example, if you want ads to have the same make as current listing, then select the make field in the box. You can choose multiple fields from the list using CTRL and SHIFT keys on PC and OPTIONS key on MAC

1.9.17. Social Networks

You have the following settings on this module:

Settings - settings for Facebook, Twitter, Google+, Youtube, Pinterest, Instagram and Linkedin buttons that will appear lower in the page. These buttons will take to your Facebook page and Twitter account.

Facebook Like button- settings for the Like / Recommend button which will appear on every listing details page.

Facebook Share button- settings for the Share button which will appear on every listing details page.

Facebook comments- if enabled, a box with Facebook comments will appear on listings details page. Make here the necessary settings for this particular option.

Tweet button- settings for the Tweet button which will appear on every listing details page.

Google +1 button- settings for the Google +1 button which will appear on every listing details page.

Facebook Recent Activity plugin- settings for the Facebook Recent Activity box that can be enabled to show on the right side of first page.

Facebook Like Box- settings for the Facebook Like box that can be enabled to show on the right side of first page. This box will be linked to your Facebook page you configured in this module.

Tweet ads when posted- using this part you configure the script to tweet listings title when posted on your site. To use this feature you will need to make some settings on your Twitter account:

Post ads on Facebook- using this part you configure the script to post ads on Facebook when added. Before enabling this option you will need to make some configuration:

1.9.18. Tag Cloud

A tag, according to Wikipedia, is "a (relevant) keyword or term associated with or assigned to a piece of information (e.g. a picture, article, or video clip), thus describing the item and enabling keyword-based classification of information." This module will display in the first page a box with tags from your site. The tags are chosen from keywords used for search (in the search keyword field).

This tool is useful for:

You can make the following settings for this module:

Module Title - the title shown above the tag cloud box.

Split search expressions in multiple tags - when this option is enabled, it splits the search key into words and keeps the tags as single words. When it is enabled it keeps the search keys as they are searched, even if they are multiple words. For example when searching for used cars, an enabled Split search expressions in multiple tags will result in two tags: used and cars, while an disabled one will result in one tag used cars.

Number of tags to show - number of tags to show at a time in this box.

Keep searches for - We explained that the tags are taken from individual search terms made by your visitors. These terms are kept in the database and every time the tags will show, the list is processed to determine the strength of each term (which will reflect in font size), and the most relevant terms will show in a random order. The relevance is determined by the number of searches on this term. But these search terms should be deleted periodically because otherwize the database will become too big and hard to process, and this will add a delay in showing the tags. Also, this ensures that the tags are the ones that people are looking for in this period of time, and not in the past.

Use only words with at least - you can choose not to consider words with less number of characters than this number.

Exclude words - enter here words that you don't want to show, even if searches are made by this term.

1.9.19. EU cookies regulation

This module will allow you to display a notification banner on your site which states that your site uses cookies, as European Union legislation requests. To use it you will need to enable the module, and edit the messages this module will display on your site:

Click to edit EU cookie top notice - click the button to be taken to the Templates / Info Templates section in order to edit the information text which will appear on top of your site when the module is active.

Click to edit EU cookie regulation text - will allow you to edit the custom page which present more information about how your site uses cookies. A draft custom page is already created with some base iformation, feel free to modify it or remove any parts which don't apply to your site.

1.9.20. Default ads images for categories

This module allows you to configure different images to display when the listing has no photos for different categories. For example display an image containing a car for auto ads, a building for real estate ads and so on.

To configure it you will need to add default images for as many categories as you want. Click on the Add button, then configure the following:

Category - select one category

Default small thumbnail and Default big thumbnail - upload the small and big size thumbnails for that category. It is recommended to keep the same size you configured to resize the thumbnails to in Settings / Listings Settings .

Apply to subcategories - check this box if you want the same thumbnails to apply to the subcategories of the selected category.

1.9.21. Extra Visits

When you start your website it might be hard to get the visits you would like in order to attract clients which will post ads. This module will falsely increase the number of visits by a value more than 1 when a listing page is accessed, to appear that you have more traffic. We encourage you to use this module wisely and not more than it is necessary!

This module has one configuration only:

Maximum number of visits - when a listing page is accessed, a random number of visits will be added between 1 and this number.

1.9.22. Latest Auctions

Will show the latest ads which have auctions enabled in a box on the first page.

You can configure for this module:

Title - The title which will appear above the box.

Number of latest auctions - Number of ads with auctions which will appear in the box.

1.9.23. Linkify

If you want to allow links in your ads but don't want to enable a HTML editor, then use this module. It will automatically transform on the fly urls contained in listings description in links.

This module does not allow any settings.

1.9.24. MultiCurrency

When you use more than one currency this module allows prices conversion from one currency to another and also ensures correct price sorting in search pages. The prices are calculated according to defined ratios between the currencies in the system.

This module will display your configured currencies in a table. Each currency will have a ratio. One of the currencies will be the default currency, which will always have the ratio 1. The other currencies will be configured with ratios related to the default currency. You can always change the default currency, just be careful afterwards to readjust the other currencies ratios. You can use an online currency converter like http://www.xe.com/currencyconverter/.

After finishing the configuration of the currencies ratios always click the button at the bottom of the page Recalculate listigs prices! This will recalculate the unit price which is used to sort correctly the listings by price no matter what currency they use.

1.9.25. Price extra configuration

This module will allow you to enable Negotiable checkbox, enable Free word instead of 0 price value, allow alternate tags like Please Contact or Swap/Trade. You can make different such configurations for different fieldsets.

To configure this module add one or multiple configurations for different fieldsets. Click on the Add button on the top of the page. For each new configuration you can enter:

Fieldset - Choose one or more than one fieldsets, or make the configuration for all fieldsets.

Use Negotiable - for a price greater than 0 the Negotiable checkbox will appear next to the price value. This checkbox enabled will add a Negotiable sign next to the price.

Negotiable - if the previous value is enabled, use this to enter a different name or translation to be used for Negotiable.

Use Free - if this checkbox is enabled, users will be able to select Free instead of entering a price and a Free sign will appear instead of the price.

Free - if the previous value is enabled, use this to enter a different name or translation to be used for Free.

Use Tags - if this checkbox is enabled you will be able to add one or more than one tags to be used instead of a numeric price.

Tags - if the previous value is enabled, use this to enter one or more than one tags to be used instead of a price numeric value. Add the tags each on a new line or separated by | sign.

1.9.26. Spam Prevention

A measure against the increasing spam issue on the web, this module checks email and IP addresses used on your site against a spammers list from stopforumspam.com and takes action according to your settings.

When blocked the IPs address will appear in the Security / Blocked IPs list, and the emails in Security / Blocked Emails list. IPs can be blocked only temporary if you choose to, or you can block them permanently.

This module has 2 subsections:

1.9.26.1 Settings

Check registration email and IP addresses - enable this option if you want that when a user registers, the used email and IP address to be checked against the database.

Check contact forms email and IP addresses - enable this option if you want IP and email to be checked when writing a message from a listing page to a listing owner

Check comments email and IP addresses - enable this option if you want IP and email to be checked when posting a comment. Use this only if Comments module is enabled.

Check reviews email and IP addresses - enable this option if you want IP and email to be checked when posting a review. Use this only if you have reviews enabled in Ratings and Reviews module.

Block Tor IP addresses - block IPs belonging to Tor exit nodes

Block some of the Internets most hostile spam friendly networks

Minimum score limit - each entry in StopForumSpam database is rated with a percentage value from 1 to 100, 1 being the smallest and 100 the highest threat. You can enter a minimum score, and all entries below that value will be discarded (no action will be taken).

Block ip after attempt for X hours - enter the number of hours to block IPs which are identified with this module. To block them permanently use the value 0.

1.9.26.2 Spam log

Here you will find a list with all blocked IPs and emails. For every registration in the list you will find the following infomation:

IP - the IP address if what it was blocked was an IP address

Email - the Email address if what it was blocked was an Email address

Type - based on which page it was blocked on you will see as type the values: Registration, Contact form, Comments or Reviews

Score - the value of the threat score

Date - date when this was blocked

You can perform the following actions on the registrations of this list:

Unblock - if the IP or email was added by mistake or you consider it was classified wrongly as spam, delete it from the block list

Add to whitelist - delete the IP or email from the block list and add it to whitelist. This will prevent it from being blocked again.

1.9.27. Bump Ads

This module will add a new paid feature to allow users to push their listings to the top of the search list for a period of time.

Bumped ads are prioritized ads. They can be used in addition to other defined priorities, or without them. Bumped ads will appear on top of other ads in search pages, even on top of other prioritized ads.

Duration - number of days while listing will be prioritized.

Change posting date - if this option is enabled, when the ad is bumped the posting date will be changed with the current date.

Price - the price for bumping an ad.

1.9.28. Mobile home screen icon

This module allows you to configure a mobile home screen icon. When your users will save your website link on their mobile home screen for quick access, these icons will be used for that purpose.

You will be able to configure a number of icons with different sizes for IOS or Android devices. Make sure you use PNG images as icons.

1.9.29. Limit ads per account module

This module allows you to limit the number of total ads posted for a user account. When maximum of allowed ads is reached the older ads will be deleted.

The settings form is simple, you just need to configure Maximum ads, which is the maximum number of ads you want to allow for an account.

1.9.30. Latest visited module

Shows the latest ads seen by the current visitor. You can configure the number of latest visited ads shown and to choose if to show them on search pages and/or listing details pages.

Title - The title shown on site for the Latest Visited ads block.

Number of latest visited ads

Show on index page - check if you want the Latest Visited ads block to show on the first page.

Show on search pages - check if you want the Latest Visited ads block to show on listings search pages.

Show on listing details page - check if you want the Latest Visited ads block to show on listings details pages.

1.9.31. Video Ads

Shows a number of video ads on the first page, and a link towards an all video ads page.

Possible settings for this module:

Title - the title of the section on the first page.

Number of video ads - Number of video ads shown on the first page.

1.9.32. Auto Renew

Automatically renews expired ads after a configured number of days. You can choose to renew all ads, or only those belonging to some listing plans.

Possible settings for this module:

Auto renew after X days - the number of days the listings are renewed after.

Listing plans - You can select only some listings plans to have their listings automatically renewed.

1.9.33. Legacy links compatibility

If your site was indexed with Legacy URLs, then this module will help you maintain the compatibility with the old link types.

This module will add the functionality to support both URL types, legacy and current, and will add canonical links to avoid duplicate content issues.

1.10.1. Templates Editor

Our script uses templates for the HTML part. This means that HTML code is completely separated from the php code. For this reason it is easy to change its design.

First of all, to view a template file that you want to modify, you need to choose the proper template from Select Template menu (if there is more than one template). Then choose from Select File menu the file you want to see and hit View. A box will appear with the content of this file.

Some details regarding template syntax.

The template system that we are using for the script is Smarty (http://www.smarty.net/). If you want to read extended syntax documentation, please view this page: http://www.smarty.net/docs/en/

Basically, what you should know is that every template file uses HTML code and some specific elements that will be replaced by the script with the proper value. Those elements should remain intact, you should not replace them with normal text or other HTML elements unless you know what you're doing. Here are the types of syntax you will find:

Variables

Variables are defined by strings in the form:

{$variable_name}

This string will be replaced with the correspondent variable defined in the script.

Example: in the following sentence:

{$lng.useraccount.welcome} {$username}

The string {$lng.useraccount.welcome} will be replaced with the language variable for welcome, and {$username} with the currently logged in username.

Conditional Sentences

			{if $var_name="value"}
			...
			{/if}
		

Conditional sentences are used for parts in the template that will appear if the condition is met. For example in the following part:

			{if $listing.user.store>0}
			{* show store button *}
			{/if}
		

The part {* show store button *} will appear only if the user has dealer account enabled.

Comments

Comments are part of the template that are not interpreted by the template engine in any way, in fact those parts will not show in the generated html code. These parts are only added for reference. You can recognize a comment by having {* *} signs around. Please view in the earlier example, the string {* show store button *} is a comment.

Loops

There are two types of loops used: for loops and sections. Loops execute the code inside as long as the condition is met, usually for all values in an array. Please see examples below:

			{foreach from=$categories item=v name=cat}
			{* ..... *}
			{/foreach}
		

Adding javascript code or CSS code to a template

Since javascript code and CSS code can contain characters that can be mistaken as belonging to templates syntax (like the curly brackets or braces: { }), when you add code like that to your templates you should place the code between {literal} {/literal} strings.

Ex: You want to add Google Analytics code to the footer of your pages. The code will look similar to the following:

				<script type="text/javascript">
					var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
					document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
					</script>
					<script type="text/javascript">
					try{
					var pageTracker = _gat._getTracker("UA-xxxxxx-x");
					pageTracker._trackPageview();
					} catch(err) {}</script>
		

Here is how you should enter it in the templates:

				{literal}
				<script type="text/javascript">
				var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
				document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
				</script>
				<script type="text/javascript">
				try{
				var pageTracker = _gat._getTracker("UA-xxxxxx-x");
				pageTracker._trackPageview();
				} catch(err) {}</script>
				{/literal}
		

Including files

You can include another template file to your code with the following syntax:

{include file="header.html"}

This example will include the file that contains the header (top) of the template.

1.10.2. CSS Editor

CSS (Cascading style sheets) are used to describe the formatting of a HTML document. You can control by editing this document things like colors, backgrounds, font sizes, elements spacing. Use this section in addition to the previous section if you want to make changes to your site look.

To make changes to this page, basic knowledge of CSS principles are required.

1.10.3. Language Editor

All site texts that appear on site interface, except for the ones that are kept in database (all values that you can edit in administrator panel) are kept in a language file. If you need the script for other language that the script does not have translated, or if you simply need to change some of the texts on the interface, you can edit the language file.

In the section Language Editor you have a drop down list where you can choose the language from, and a box, where the content of the language file is shown. The languages shown in the drop down list are the languages from Settings / Languages section.

You can always edit languages files for certain modules that have a language file. To do so, change next to the option Main file or module the menu and choose the module you want to edit the language file for. The way you edit a modules language file is just the same as when you edit the main language file.

There is another way to edit a language file, use the method you find easier to you. This second method is to edit the language file on your computer. You will need to copy it using a FTP program on your computer. Then you can edit it using any text editor (PHP files are in fact text files) like Notepad for example. After you finish making changes to the language file, upload the file back and overwrite the old version.

The language file is actually a .php file. So it needs to follow a set of rules to be valid. If there is an error in the language file, the HTTP server will show you an error like the following:

Parse error: syntax error, unexpected T_VARIABLE in /usr/home/yourdomain.com/lang/eng.php on line X

If you do get this error, then you should check at the line specified what is the error. You must follow these rules for not generating errors:

If you follow these rules then you will be able to make a translation without a problem.

1.10.4. Mail Templates

In this section you can edit the mails that are sent from your site in different cases. Please take the time and edit these templates before lanunching your site.

Examples of mails sent are: mails sent when an ad is posted - to user and admin, notifications when listing expired or before expires, recommend ad mails, password recovery mails, and so on.

The page shows two areas, a left select box and a right part where you can see the mail template. You can choose in the left side the mail template you want to edit and it will reflect in the right side. You can see a description for the current email template in red, on top of the right side. After you made the changes hit Save.

Mail Templates use the same template system as HTML templates regarding elements that will be replaced in the background by the system.

A mail template will look like the following:

			Subject: {$sender_name} recommended you this ad!
			Mail content: Hello {$name}
			{$sender_name} thought you would be interested in the following resource:
			{$ad_link}
			{$message}
			Best Regards,
			{$administrator}
		

All strings in the form {$variable_name} are variable names and will be replaced with a value. Please see a wider description here for templates syntax.

So when the email is sent, it could look like this:

			Subject: Matt recommended you this ad!
			Mail Content: Hello John
			Matt thought you would be interested in the following resource:
			http://www.yourdomain.com/details.php?id=12
			
			You really should check out this ad!
			
			Best Regards,
			Yoursite Administrator
		

1.10.5. Info Templates

When your site users perform certain actions there are certain messages that will be shown to them. For example, after placing an ad, when buying a subscription, when upgrading an ad and so on.

This section is similar to the previous section, Mail Templates. What we should point out here is that the formatting here should be HTML since these informations will appear directly in the HTML pages. So for example, to add a new line you should enter the newline HTML character <br/>.