Documentation : Classifieds 1.2 Features and use

Posted by john on 2008/8/13 6:20:00 (5058 reads)
Classifieds Features and Use

Version 1.2 RC1

This version is not Cloneable.
This version NEEDS Frameworks.

Get Frameworks Here

1. Fixed search result showing html code.

2. fixed captcha not working on the addlisting page.

3. added captcha to the preferences, use it or not.

4. changed some functions names so they are unique(prevents fatal error when wf-downloads is installed).

5. changed search.inc.php so include_once for functions.php is always found.

6. changed some template files.

7. added 2 more category fields in the category creation.
1. Moderate this category.
2. Moderate subcats for this category.

Features.

User Side


1. Xoops Notifications
Users can select to be notified if a listing is added in any category(whole module) or get notifications in just certain categories(category).


2. A Sorting System.
Users can sort the listings by date DESC, date ASC, price DESC, price ASC, title DESC, title ASC, hits DESC, hits ASC.


3. A Rating System.
Users can rate the user who is selling the product and also rate the product.

4. Has a page for users to see all ads by 'this user'.
Users can see all the Ads by another user, and the owner of the ads can administer their Ads from that page.


5. Users can choose how to be contacted.
Users can select to be contacted by email, PM, telephone or any combination of those.


6. Users can print out the Ad.

7. Users can send an Ad to a friend.

8. Users can now add a number of pictures that you decide, You can choose how many pictures a non premium user can add and how many a premium user can add.
I have taken the Yogurt module guts and fit them into this module.



Admin Side


1. Has Xoops Group Permissions, per category - per group.

2. Clonable.(Not now, but by 1.2 final)
There are steps to do manually and the module will be cloned, with no errors.

3. Also read about the Preferences below.

4. You can now choose your form editor in the preferences.
Only Koivi, DHTML AND FCK work right.



Installation


How to install

You will need to make the following folders writable(chmod 777) :

classifieds/photo
classifieds/photo/thumbs
classifieds/photo/midsize

1. Unzip the file Classifieds_1.2_RC1.zip.
2. Upload the folder classifieds to your Xoops modules folder.
3. If you want to rename the module do it now, you can't change it after you install the module, you must also go into the sql/mysql.sql file and do a replace with your favorite text editor and replace all

classifieds_

with

yournewname_

4. Go to Xoops Module Administration and install like normal.
5. You MUST Go to Classifieds Module administration and click on category maintenance, create your categories.
6. Go to Classifieds Module administration and click on Permissions and set up the following for each category.
A. View Ads Permissions - Select which groups can view Ads.
B. Ads Submit Permissions - Select which groups can submit Ads.
C. Ads Premium - Select which groups can set how long an ad will stay on the site until it is deleted. If they don't have permission it will default to whatever you set in the Classifieds Module preferences (default is 14 days).
7. Go to Classifieds Module administration and click on Preferences and set to your liking.
8. That should be it.


Upgrading from all versions

1. Back up your database.
2. Overwrite the classifieds module with the new files.
3. Point your browser to yoursite/modules/classifieds/admin/upgrade.php, you must be admin to run this script.
4. Update module.
5. Delete the files below if they exist.
a. include/preferences.inc.php
b. include/pictureform.inc.php
c. admin/admin.php
d. editdesc2.php
e. listing-p-f.php


That should be it.


If you aren't sure about something just ask me.


Setting up the Preferences


1. Currency symbol :
Your default money sign -- Module Default is $

2. Listings per page :
How many listings do you want to show -- Module Default = 10


3. Show new Listings :
on the Front Page of Module
Choices are (Yes No) -- Module Default = Yes


4. Number of new Listings :
on the Front Page of Module
-- Module Default = 10


5. Listings marked new for :
in days
Marked with a 'new' graphic for so many days -- Module Default = 3


6. Allow anonymous users to reply to a classified ad.
using the e-mail form (recommended is No, because of spam.)
Choices are (Yes No) -- Module Default = No
THIS WILL BE REMOVED AS AN OPTION.


7. Listing Duration :
in days
The default time before a listing is automatically deleted, remember premium users can change this time. -- Module Default = 14

8. Maximum number of pictures for a non premium user-- Module Default = 1

9. Maximum number of pictures for a premium user-- Module Default = 12

10. Path Uploads.
The directory where the photos will be uploaded to.

11. Link Uploads.
The URL where the photos will be stored.

12. Thumb width
The maximum width of the thumbnail
Module Default = 125

13. Thumb height
The maximum height of the thumbnail
Module Default = 175

14. Resized width
The maximum width of the resized picture
Module Default = 650

15. Resized height
The maximum height of the resized picture
Module Default = 450

16. Max original picture width
The maximum width of the original picture
Module Default = 2048

17. Max original picture height
The maximum height of the original picture
Module Default = 1600

18. Max size in bytes
This the maximum size of your picture, in bytes.
like 512000 for 500 KB-- Module Default = 512000

19. Display subcategories :
on the Front Page of Module
Choices are (Yes No) -- Module Default = Yes


20. Number of subcategories to show :
How many subcategories you want to show, if you selected 'yes' to 'Display subcategories' -- Module Default = 4


21. Category Default Sort Order
The order that the categories will be sorted.
Choices are by alpabetical order or by your personal preference (numbered) order. -- Module Default = alpabetical


22. Listing Default Sort Order
The order that the listings will be sorted.
Choices are by title, date, price or popularity. -- Module Default = date


23. Allow Users to use different name
Will allow users to use a different name when submiting a listing
Choices are (Yes No) -- Module Default = No


24. Allow Users to use different e-mail
Will allow users to use a different e-mail when submiting a listing
Choices are (Yes No) -- Module Default = No


25. Allow Users to rate sellers
Will allow users to rate the user selling the item
Choices are (Yes No) -- Module Default = No


26. Allow Users to rate items.
Will allow users to rate the item being sold
Choices are (Yes No) -- Module Default = No

27. Use the country field.
Some users want to display the Country
Choices are (Yes No) -- Module Default = No

28. Choose Form Editor
You can choose which editor your users can use.
Choices are DHTML OR Koivi, the others don't seem to work.
-- Module Default = DHTML

29. Use lightbox effects with pictures.
Choices are (Yes No) -- Module Default = No




Tags: Classifieds  
Printer Friendly Page Send this Story to a Friend Create a PDF from the article
The comments are owned by the author. We aren't responsible for their content.
Author Thread
Login
Username:

Password:

Remember me



Lost Password?

Register now!
 
Main Menu
 
Who's Online
9 user(s) are online (1 user(s) are browsing News)

Members: 0
Guests: 9

more...
 
Donat-O-Meter
Make donations with PayPal!
Stats
Goal: $25.00
Due Date: Nov 30
Gross Amount: $0.00
Net Balance: $0.00
Left to go: $25.00