Almond Classifieds. Classified Ads Script.
 

Steps for setting up Almond Classifieds  on your Web-server: 


Unzip your loaded zip file; 

Layout similar to http://www.almondsoft.com/pro2 is set up in the script by default.
If you prefer layout similar to http://www.almondsoft.com/pro
you have to rename files in the classifieds directory:
conf_opt1.php to conf_opt.php
top1.php to top.php
details1.php to details.php
conf_cat1.php to conf_cat.php. 
Before renaming you have to delete old files conf_opt.php, top.php, details.php, conf_cat.php. 
Keep in mind that the layout similar to http://www.almondsoft.com/pro is more complicated and requires
more powerful server for high traffic comparing with the layout http://www.almondsoft.com/pro2 .

If you need to set up two-level fields selection e.g. for choosing country/city 
similiar to demo at http://www.almondsoft.com/pro4 , you have to rename the following file 
in the classifieds directory:
conf_cat3.php to conf_cat.php
(old file with the name conf_cat.php must be removed).
The lists for countries/cities can be set up in the file conf_sf.php

You have to choose layout and make all these files renames before script installation and configuration.

##############

Quick Start:

Upload all script files ( .php) via ftp to your new classifieds directory, 
You have to do this via ftp program from a computer with Windows system 
(as the files are saved in Windows text format) to Unix server in ASCII mode.
 
!!!! 
Set up permission 777 for your new classifieds directory and  permission 755 for  
files index.php and admconf.php by chmod command via ftp client.

Start in your browser configuration script admconf.php (initial password: "adm" ).

At first set up MySQL database parameters:
Database name, hostname, user name, password.
You can ask these parameters   in your web site hosting company. MySQL database can be created 
by  using special web interface provided by your web site hosting company,
or via telnet by using mysqladmin utility

Click in the config area on the link "Create MySQL Tables" and create mysql table for ads. 

Start in your browser the script index.php and try classifieds features with default options.
If everything works fine you can proceed to set up your custom options via the script admconf.php.

You can set up some additional options which are not included into web config interface 
in the files config.php, conf_sf.php, mb_conf.php.

Script admconf.php automatically create configuration directory 'conf' and directory 'photos'
inside your classifieds directory. 
All config files with customized options will be saved in the directory 'conf'. So, you can easily
transfer your customized classifieds script to other web server by copying classifieds directory
with included 'conf' directory. In this case on the new web server, where script has been transfered, 
you have to set up permission 777 (via ftp client)  for directory 'conf' and for all files inside 
this directory. For admin maintenance of ads and membership databases start the script
admin.php in your browser.  

################



MORE DETAILED INSTRUCTIONS (these features are not available for free version ).

How to edit the ad by admin:
Go to admin.php URL in your browser, then input ad id# in the edit area,
then make editing of the ad.

How to delete ads by admin:
Go to delete area in the web admin interface ( admin.php ) , input
ads id# you need to delete, separated by commas, e.g. if you input
5,16,23-27,35,45-48
then  ads with the following id#  will be deleted:
5,16,23,24,25,26,27,35,45,46,47,48

How to moderate ads by admin:
First you have to set up moderation option via config interface.
After this if some user submits ad, this ad will be placed into moderate
folder and will be not visible in the public ads index. 
Admin can click on the "moderate" link in the web admin interface area,
then browse and edit submitted ads. 
To make ads visible, admin goes to " Make ads visible/unvisible" area
and submits list of ads id# he needs to make visible in the public ads 
index. 
 e.g. if you input
5,16,23-27,35,45-48
then   ads with the following id# will become visible:
5,16,23,24,25,26,27,35,45,46,47,48
If you need to delete some ads in the moderate folder, you can submit 
ads id# for deleting in the delete admin area as described above.
If moderating option is set up and some user makes editing of his/her ad, this
ad will be placed into editing folder and only after approving by admin
with the following above way ( as for moderating folder ) this ad can appear 
in the public index. 

How to make ads invisible:
If you need to make some ads invisible for some time period, 
you can submit the list of ad id# of these ads to the  invisible folder,
and after some period make them visible as in the moderating case.

How to get e-mails of ad owners:
To get e-mails of ad owners, you can click on the link with category
name in the web admin interface. You will get e-mails of ad owners
of this category in the alphabetical order. You can copy this list 
for using in  mail list programs. If you click on the e-mail link, you will see
the ad details page with this contact e-mail.



Frequency encountered problems.
Problem 1.

Submitted ads do not appear in the index or in invisible folders.

Reasons: 
1. Classifeds mysql table is not created successfully.
2. In the fields set for this category you set up short name of the field that does not
exist in the created table. 


Problem 2.
You can submit photos but they do not appear in the index.

It can be caused by the problem with incorrect paths to photos directory and/or incorrect 
URL to photos directory in the config options. 
Keep in mind: photo directory should be created inside 
your html directory and should have permission 777 ( by chmod command ).
 

You can  customize the layout of classifieds pages.
To customize ads index layout you need to customize html tags 
in the function browse_ads() (file adshtm.php )
Ads on the index page are generated by the loop, you can change ads layout
in the function print_ad ($row) (file adshtm.php ).
Caption for ads table are generated by function get_ads_captions() (file adshtm.php ).
Search form on the index page is generated by function get_search_form() (file search.php ).
To customize second ads page with details you need to customize html tags 
in the function ad_details() (details.php )
To customize top page with categories list  you need to customize html tags 
in the function print_categories() (file top.php ).
To customize add/edit form for ads you need to customize html tags 
in the function  ad_form($ed_add) (file forms.php ).
To customize privacy mail form page  you need to customize html tags 
in the  function privacy_form($idnum) (file forms.php ).
To customize layout of messages you need to customize html tags
in the  function output_message($message) (file funcs2.php )

If you do not like using Event Calendar service, you should  delete category 
with short name 'evntcl' in the list of categories via config admin interface.
-----------------
How to rate ads?
-----------------
  In the admin areas you can see the place with the title "Rate ads". Submit rating you 
 need and then the list of ads id# for which you have to submit this rating. After this 
 submitted ads will additionally appear at the top of ads index in the order of rate,
 ads with the same rate will be placed in the order of ads adding date, ads with rate "0" 
 will not be highlighted; If admin set up ad rate "10" or more, then this ad will be placed
in 'Sponsored Ads' area on the top page (for Layout 1 only).
   
---------------------------------------------------------------------------           


Highlighting ads with on-line credit card procesing
---------------------------------------------------------------------------------------
 
Highlighting options can be set up in admin config area via script admconf.php. 
To provide fee based ads highlighting  with real time credit card processing, 
you need to sign up with ClickBank.Com (or any other such on-line billing company you prefer ).
 Create an account with ClickBank.Com and specify the URL of the scripts   
htad1.php in this account  as a finish page for purchasing  fee based service. 
After on-line credit card processing users will be directed   to the finish URLs.  
E.g. if you use clickbank.com as on-line credit card processor you can specify
link for fee based ads submitting as the following:

http://www.clickbank.net/sell.cgi?nickname/linknumber/linktitle 

where nickname - your ClickBank nickname. 
linknumber - the number of the link you are selling. When you set up your ClickBank
 account, each of your links is assigned a number (1 to 50).  
linktitle - any title you would like to give your link.  

In "Membership Options" area of admin config interface you need to set up payment info for users
(in HTML format) with payment link of your clickbank.com account (as the following above)
(or other on-line credit card processor).

Note: When a user is directed by on-line cc processor to finish URL of the script 
htad1.php, this script will redirect users to URL of script hltads.php with using 
special cookies. It is made for security, as in this case URL of the script htad1.php
is invisible (in future you can change name of the script htad1.php).
Users can see only URL of the script hltads.php. When a user tries to go to URL 
of hltads.php again to make new ads highlighting   without on-line payment, 
he/she will receive error message. Secure features are also included in other 
script places.  


------------------------------------------------------------------------------
Membership features:

Steps for setting new modules for membership features:
 
Set up your membership options in "Membership Options" area of admin config via script admconf.php;
You can set up which services will be membership protected in "Main Options" area of admin config interfece.   

You have to click a special link to create mysql table for membership database 
Via web config interface (script admconf.php) at 'Create MySQL Tables For Classifieds' area.

Template <!--login_info--> can be inserted  in the html header in "Main Options" area
 ( as it is made in our default settings ) in this case,
when user is logged into password protected areas of classifieds, script
will display welcome line with username and link to ads submitted by this member.  


You can get access to membership database via URL of mbadm.php script. 

All main functions for maintain membership database are the same 
as for maintaining ads database and described above.

Fee based membership subscribing with on-line credit card processing:
-----------------------------------------------------------------------
If you chose mambership activation option, then after membership profile subscribing
user will  be directed to on-line credit card processor.  
To provide fee based membership profile activation with real time credit card processing, 
you need to sign up with ClickBank.Com (or any other such on-line billing company you prefer ).
 Create an account with ClickBank.Com and specify the URL of the scripts   
sgnp.php in this account  as a finish page for purchasing  fee based service. 
 Users will be directed after on-line credit card processing to the finish URLs.  
More info about payment link has been described above (highlighting ads). 

In "Membership Options" area of admin config interface  you need to set up payment info for users
(in HTML format) with payment link of your clickbank.com account (as the following above)
(or other on-line credit card processor).

Note: When a user is directed by on-line cc processor to finish URL of the script 
sgnp.php, this script will redirect users to URL of script mbp.php with using 
special cookies. It is made for security, as in this case URL of the script sgnp.php
is invisible (in future you can change the name of the script sgnp.php).
Users can see only URL of the script mbp.php. When a user tries to go to URL 
of mbp.php again to make new membership subscribing without on-line payment, 
he/she will receive error message. Secure features are also included in other 
script places.  



------------------------------------------------------------------------------

Please read the following before using Almond Classifieds:

 LICENSE AGREEMENT. 

By using Almond Classifieds  you signify that you
accept all terms of this agreement. Purchase of one license 
of Almond Classifieds script entitles you the usage of Almond Classifieds 
script for one web site ( for a single domain  ). You may NOT 
resell, install give away or distribute by any methods this script
without purchasing an additional license for each new website.
Each next license costs half of the first license price and can be 
purchased at the following link:
 
http://www.almondsoft.com/licagr.html

Each legal installation of the Almond Classifieds script should be registered
 in our database at the following link:
 
http://www.almondsoft.com/reg/reg1.php
 
You may not  submit any information about this script or URL of  your 
web pages with script description to webmasters' resources or any other
 web resources, only official site http://www.almondsoft.com can offer 
and sell licenses for this script. 

You may make any modifications to the Almond Classifieds script according to
your needs for your personal usage at your own risk.
However, we will not be able to fix the problems caused by your modifications. 
Modified version cannot be resold or distributed without  purchasing an 
additional license for each new website. You may  purchase additional license 
per half price of first license to install this script to your own client.
 
The small text link to http://www.almondsoft.com must remain in the 
script and appear at the footer of all web pages genarated by this script. 
 
Almond Classifieds script, including sources code, HTML layout, user 
and admin interfaces is Copyrigt © 2008 AlmondSoft.Com
and protected under international laws and treaties.
 
   
DISCLAIMER OF WARRANTY & LIMIT 
OF LIABILITY.
 
THIS SOFTWARE AND THE ACCOMPANYING FILES ARE PROVIDED
"AS IS" AND WITHOUT WARRANTIES AS TO PERFORMANCE OR 
MERCHANTABILITY OR ANY OTHER WARRANTIES WHETHER 
EXPRESSED OR IMPLIED.  NO WARRANTY OF FITNESS FOR 
A PARTICULAR PURPOSE IS OFFERED. IN NO EVENT WILL THE 
AUTHOR BE LIABLE FOR ANY SPECIAL, INCIDENTAL, INDIRECT, 
OR CONSEQUENTIAL DAMAGES WHATSOEVER (INCLUDING, BUT NOT 
LIMITED TO, DAMAGES FOR LOSS OF BUSINESS PROFITS, BUSINESS
INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR ANY OTHER
PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY TO 
USE THE SOFTWARE PRODUCT. ANY LIABILITY OF THE SELLER WILL 
BE LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF
PURCHASE PRICE.
 
Failure to install the program or not being able to run this script
 on your server is not a valid reason for requesting a refund of the
 purchase price such as you have an ability to load for free 
"Almond Classifieds (free version)" and try all main features of the 
script before purchasing commerce version.

By purchasing  the script "Almond Classifieds" you agree to the terms
of our licensing and copyright policies. If you do not agree to all 
the terms of this agreement please do not purchase this script.

------------------------------------------------------------------------
Visit  site http://www.almondsoft.com/alcl.html for more details 
about Almond Classifieds script.

Copyright © 1999-2008 AlmondSoft.Com   All Rights Reserved. 



