4.2. Classifieds

Top  Previous  Next

The Classifieds module includes all functions related to classified ads management, such as placing, searching and displaying ads.

Module functions:

□

add_listing - allows users to add listings

•

Parameters:

o

listing_type_id - the optional parameter pointed at listing ID. If this parameter is not specified, the function returns the list of all the available listing types

o

listing_package_id  - ID of a package. A listing will be added according to this ID

o

input_template - the template of the input form contained listing fields

•

Used templates:

o

listing_package_choice.tpl

o

add_listing_choose_listing_type.tpl

o

add_listing_success.tpl

o

input_form.tpl

 

□

display_listing - displays listings

•

Parameters:

o

listing_id - the optional parameter, listing ID; if this parameter is not specified, the select-box is displays to choose listing ID

o

display_template - the name of the template. Information about a listing will be displayed according to this template

•

Used templates:

o

choose_listing_sid.tpl

o

display_listing.tpl or the template specified in settings of a listing type

 

□

search_form - displays listing search forms and search results

•

Parameters:

o

listing_type_id - the optional parameter, listing type ID

o

restore - the optional parameter, restore content of form fields

•

Used templates:

o

search_form.tpl

 

□

search_results - displays listing search forms and search results

•

Parameters:

o

default_sorting_field - the field that will be used for default sorting

o

default_sorting_order - the order that will be used for default sorting

o

default_listings_per_page - the default number of listings per page

o

sorting_field - the field for sorting that can be assigned in search results

o

sorting_order - the order for sorting that can be assigned in search results

o

listings_per_page  - the number of listing per page that can be assigned in search results

o

page - the current page of search results

o

results_template - according to this template search results will be displayed

•

Used templates:

o

search_results.tpl

 

□

pay_for_listing - payment for listing activation. If activation is not free, a new payment is created for listing activation and user is redirected to the payment page. Otherwise, the system activates a listing and displays a message

•

Parameters:

o

listing_id - listing ID. Payment will be taken for this listing activation or for upgrading the listing to featured  

•

Used templates: no

 

□

activate_listing - activates listing according to the payment

•

Parameters:

o

payment_sid - mandatory parameter, payment SID

•

Used templates:

o

activate_listing.tpl

 

□

edit_listing - edits listing

•

Parameters:

o

listing_id - mandatory parameter, ID of an edited listing

o

edit_template - the template of input form. A listing will be edited according to this template

•

Used templates:

o

edit_listing.tpl

 

□

my_listings - displays listings of a current user

•

Parameters:

o

listings - listing IDs created by a current user

•

Used templates:

o

my_listings.tpl

 

□

manage_listing - a page of listing management (Preview, Edit, Pay for Listing)

•

Parameters:

o

listing_id - mandatory parameter, listing ID

•

Used templates:

o

manage_listing.tpl

 

□

manage_pictures - edits listing pictures

•

Parameters:

o

listing_id - mandatory parameter, ID of listing (edited pictures belong to this listing)  

o

caption - caption of an edited picture

o

picture_id - ID of an edited picture

•

Used templates:

o

manage_pictures.tpl

 

□

listing_picture - displays a picture stored in the database

•

Parameters:

o

picture_sid - mandatory parameter, picture SID

o

type - if there is a thumb, a thumbnail is displayed, otherwise a picture is displayed. By default, there is a picture

•

Used templates:

o

no

 

□

edit_picture - edits picture caption

•

Parameters:

o

picture_id - mandatory parameter, ID of an edited picture

o

listing_id - ID of listing (a picture belongs to this listing)

o

picture_caption - caption that is assigned for an edited picture

•

Used templates:

o

edit_picture.tpl

 

 

□

save_listing - saves a listing in the cookies or in the database depend on a user (listings will be saved in the database for logged in users and in the cookies for not logged in users)

•

Parameters:

o

listing_id - mandatory parameter, ID of a saved listing

•

Used templates:

o

save_listing.tpl

 

 

□

saved_listings - saved listings management (view, delete)

•

Parameters:

o

listing_id -  ID  of saved listing

•

Used templates:

o

saved_listings.tpl

 

 

□

save_search - saves a search

•

Parameters:

o

search_name - the name that is assigned to a saved search

•

Used templates:

o

save_search_form.tpl

o

save_search_success.tpl

 

 

□

saved_searches - saved searches management

•

Parameters:

o

search_id - ID of a search. According to this ID some actions may be done with the search, e.g. delete the search or enable/disable auto notify

•

Used templates:

o

saved_searches.tpl

 

 

□

contact_seller - sending a message to a listing owner

•

Parameters:

o

listing_id - ID of a listing. According to this listing a message will be sent

•

Used templates:

o

contact_seller.tpl

 

 

□

tell_friend - sending a message about a specified listing to a friend

•

Parameters:

o

listing_id - ID of a listing. According to this listing a message will be sent

•

Used templates:

o

tell_friend.tpl

 

 

□

loan_calculator - calculate payment for a property on time

•

Parameters:

o

listing_id - ID of a listing. Terms of payment will be calculated for this listing property.

•

Used templates:

o

loan_calculator.tpl

 

 

□

delete_uploaded_file - deleting an uploaded file of a listing

•

Parameters:

o

listing_id - ID of a listing. A file will be deleted from this listing.

o

field_id - ID of a listing field. A file will be deleted from this listing field.

•

Used templates:

o

delete_uploaded_file.tpl

 

 

□

browse -  browsing listings by any field

•

Parameters:

o

level1Field - mandatory parameter, property ID from the list of Common fields or Extra fields for the first browsing level

o

level2Field - optional parameter, property ID from the list of Common fields or Extra fields for the second browsing level

o

level3Field - optional parameter, property ID from the list of Common fields or Extra fields for the third browsing level

o

level4Field - optional parameter, property ID from the list of Common fields or Extra fields for the fourth browsing level

o

level5Field - optional parameter, property ID from the list of Common fields or Extra fields for the fifth browsing level

o

level6Field - optional parameter, property ID from the list of Common fields or Extra fields for the sixth browsing level

o

browse_template - template for browsing (by default, browse_items_and_results.tpl )

o

listing_type_id - optional parameter,  ID of a listing type

•

Used templates:

o

browse_items_and_results.tpl