OxyClassifieds - Classifieds PHP Script

Changing files and folder permissions

Some features in our script need write access on files or folders in order to work. For example uploading images, editing language files. To allow write rights you will need to change permission of those files or folders.

You can change files permissions in 2 ways:

1. Using the FTP client that you use to access your files. Search for something in the menus similar to Change permissions and choose the mode which our script suggests for those files, usually 644 for files and 755 for folders.

2. Using the File Manager from your hosting control panel. You will usually need to browse to the location of the file you need to change permissions to, then search a button or link for permissions.

Adding Google Analytics to your site

You can add Google Analytics code easily from Settings / Seo Settings section. Search for the option Google Analytics code, place the code you get from your Analytics account in the box and save changes.

Mails are not sent, what can I do?

By default the script sends mails using the php mail() function. Some hostings limit the usage of php mail() function. Some are disabling it, some are limiting the functionality to sending only using a from flag with an account from that particular server.

Try configuring the script to send mails using a smtp account. You can do this from Settings / Mail Settings. You will need to check the box Use SMTP authentication and to configure below a smtp email account.

How to resize images

To resize an image you can use any image editor, there are many good free programs like the one on http://www.photoscape.org . You can also use an online image editor for that: http://www.picresize.com/ .

SEO Tips

Here are some tips to help you with you promoting your site :

1. Use different meta description for search pages, categories, custom pages and general pages. Meta description should be a natural description of the page content and it is important that it is different for each page. You can configure it in our Settings / Seo Settings section. See more information about configuring it in our SEO Settings documentation.
2. Enable Add Meta info with listings option from Settings/ Listing Settings section, which will permit adding meta information for each listing when posting it. If this option is Off, meta information will be automatically generated from the ad content.
3. Use Sitemap feature our script comes with and add a site sitemap for Google. See the script manual for Google Sitemaps for more details.
4. Make an account to feedburner.com and add your RSS feed there. Also see the script manual RSS configuration section.
5. Social media presence is very important these days, so use social networks like Facebook, Twitter, Google+ and configure them using our Social Networks Module.
6. Consider using a paid system like Google AdWords to promote your site.
7. Consider adding a blog where you can write articles periodically, if you have the possibility. Search engine will index your blog content and send you more visitors for many different keywords.
8. Use tools like Google Analytics and Google Webmasters Tools which will help you have a sense of the traffic your site has or diagnose issues your site might have.
9. Add your site to free directories that you can find, forums or any other sites. Use in your site description keywords that you want to promote your site for.

How to edit language files

There are 2 ways to edit a language file:

1. From web interface from Administrator Panel / Templates / Language Editor

2. Download and translate the file lang/LANG_ID.php on your computer (using any text editor) and then upload it back to your server.

If you choose to translate from web interface please press Save button from time to time because if the login session expires and you did not save your work you will loose it.

When you translate, you only need to translate the second part, for example in this line:

$lng['navbar']['home'] = 'Home'

You only need to translate the part colored in red.

If you have a single quote in the text, you need to put a \ (backslash) in front, like in the example:

$lng['users']['errors']['passwords_dont_match'] = 'Passwords don\'t match!';

How to edit a template file

To make changes to the HTML code you will need to edit the template files.

Please see the section for Templates Editor in our documentation for more details.

How to add javascript code to your template

To add JavaScript or CSS code to the script template you will need to enclose the code you add in tags, otherwise you can receive an error from the template engine.

Your code to add will look like this:

{* ------- your code to add here ------- *}

Adding bank transfer to supported payment types

Manual payment type is intended to be used for this purpose. It can be used for any payment that requires an action which cannot be done directly from the site, for example sending a physical check to an address, wiring the money to a bank account and so on.

This payment type is advised to be set as pending, so the actions which are paid with this type of payment will remain pending until you are able to check if the payment is done.

To setup this type of payment all you need to do is edit the emails and info messages that are sent to the user after choosing this payment. You will need to do this from the sections Templates / Mail Templates and Templates / Info Templates.

In Mail Templates section you will need to edit the emails that require payments and replace the part that is marked by the following comment :

with your payment information.

The email templates that need to be edited are: "ad_publish_status", "buy_store_status", "subscription_status", "ad_options_upgrade_status".

In Info Templates section you will need to edit the information shown to the user when a payment is done. You will also need to replace the part marked with the upper comment with your payment data, just like for the mail templates.

The info templates that need to be edited are: "ad_publish_status", "buy_store_status", "subscription_status", "ad_options_upgrade_status".

Search engine friendly URLs containing special characters for non-English sites

If the site uses Search engine friendly URLs option and your site language or languages have special characters other than a-z latin characters, then using those special characters in URLs will be a problem. Those characters will be either removed or replaced by our script with their latin equivalent.

To configure their replacement you need to login to your admin panel, go to Settings -> Languages, then edit each language you use. For URL special characters replacement set option choose all languages your site uses and press submit. This configuration will make sure the site replaces special characters for those languages in URL with URL friendly characters.

Move the script to a new domain or server

When you move the script to a new domain which resides on another server you will need to:

1. Copy all files to the new domain, on the new server

2. Make a backup of your database from Tools / Database section. Use this backup and import it to a newly created database on the new server. You can use a tool like phpMyAdmin, which is usually installed on any hosting servers.

3. Change in config.php file the following lines:

$config_live_site='http://www.yourolddomain.com';
$config_abs_path='/usr/home/olddomain/public_html';

with the new values for the new domain. The first line must contain the full url where the script is installed. The second must contain the absolute path on the server where the script files are placed.

4. Change in config.php the database configuration settings:

$config_db_server='oldserver';
$config_db_server_username='oldusername';
$config_db_server_password='oldpassword';
$config_db_database='olddbname';

Change these values with the values for the new database server name, mysql username, password and database name.

When you move the script to a new domain which is on the same server you will need to:

1. Copy all files to the new domain location on the server.

2. Change in config.php file the following lines:

$config_live_site='http://www.yourolddomain.com';
$config_abs_path='/usr/home/olddomain/public_html';

with the new values for the new domain. The first line must contain the full url where the script is installed. The second must contain the absolute path on the server where the script files are placed.

Note! If you want to move the script to a new domain name then the license allows it, but you must remove the script from previous domain name. Also you must inform us about the change.

How to enable interval search for a field.

Only fields of type Textbox or Menu can be set to appear in search forms as an interval: to allow you to select a minimum value, a maximum value or a two values interval for this field.

In order to appear as an interval in search forms, a field must have Is Numeric checkbox selected. Having this checkbox selected will reveal a new option in Search Type option for this field: Interval. Select this option and save changes for the field.

For a textbox field you can also customize the search values list by adding a list of values to Search Values field. If you want to simply show two textboxes where people can enter their own values, do not enter any data here.

Disable Register link from the site frontend.

If you don't want to allow users to register from your site frontend, then you can disable registration for your site.

In order to disable registration you need to edit each user group in your system from Users / User Groups section and uncheck the option Auto Register. This option allows registration as a user belonging to that group by filling in a registration form.

If no user group is allowed to register from the site frontend, the Register link will disappear. You will still be able to add users from administrator panel Users section.

Could not access oxyclassifieds.com error message

If you have the following error in your Admin Panel first page, section Statistics -> Latest Available Version

"Could not access oxyclassifieds.com"

You can fix that error by either:

1. installing curl on your server

2. adding the following line in php.ini:

allow_url_fopen = 1