SMF Classifieds Help


Introduction
Installing
Permission Setup
Settings Information
Custom Themes
Other Languages
Introduction:

SMF Classifieds is a classifieds system for SMF (Simple Machines Forum). A classifieds system allows users to place listings for items to sell.

Installing:

Requirements for SMF Classifieds:
To have SMF 1.1.x installed, paypal business account (for paid listings and upgrades), fsockopen enabled (for paid listings and upgrades) and that your PHP has GD support for resizing thumbnails.
If you do not know if your current host supports GD ask them or in SMF go to your Admin section of your forum and click on Support and Credits and it may say the GD version if it is installed.

Install is simple you can download the package from the SMFHacks.com site and upload it to your packages directory on your SMF forum.

Once you have the package in your packages folder go to the Package Manager in the admin section of your SMF forum.
Then find SMF Classifieds and click on [ Apply Mod ].
After you click on apply you see if it was able to be installed on all files.
If you are using a custom theme you may see some errors installing on index.template.php
The install will still go fine except you will need to add a button or link to the classifieds in the menu of your custom theme.
You can access the classifieds via http://www.yoursite.com/index.php?action=classifieds if you do not have a link or button on your theme.
If you need some information on creating a custom menu link for the classifieds visit the Custom Themes section.

After the package is applied you are ready to go. Click on Button/Menu Link to view the classifieds. The first thing you need to do is create a new category for your images.
I would also check that the classifieds has read and write permissions to the classifieds folder. This is needed in order to upload pictures to your website.
For an IIS server you will need to set the classifieds folder with permissions for the Internet Guest Account with having read, write, and modify permissions. Check out this image.

Finally, the last thing you need to check is the membergroup permissions for the classifieds. This will be discussed in the Permission Setup section.

Permission Setup:

SMF Classifieds has many built in permissions to help control what membergroup can do a certain action

Permissions
  • View Classifieds
  • Bid on Listing
  • Add Listing
  • Add Comments
  • Edit own Comment
  • Auto Approve Comments
  • Admin Classifieds

View Classifieds permission allows the user to view the classifieds.

Bid on Listing allows a user to bid on listings/auctions

Add Listing allows the user to add listings and auctions

Add Comments permission allows the users to leave comments on a listings

Edit own Comment allows a user to edit their own comments

Auto Approve Comments if given allows a persons comments not needed to be approved.

Admin Classifieds permission should only be given to admins or people you trust to manage the classifieds.


Changing permissions in SMF To change permissions for a group in SMF go to your admin section on your forum.
Then click on Edit Permissions.
For each group you will need add the permissions that they need. You can do this by clicking modify
Then checking the classifieds permissions that the membergroup needs.


Settings Information:

SMF Classifieds comes with options to help configure your forum

Settings:
Classifieds Path - Path on the server to the classifieds files
Classifieds Url - Web address of the classifieds files
Items per page - Number of images per page on a classifieds category
Max thumbnail width - The max width of a thumbnail image
Max thumbnail height - The max height of a thumbnail image
Contact Email: - email used for all contacts on the classifieds
PayPal Email - the PayPal email used for your classifieds
Receive copy of sales email - Sends a copy of the sales email to contact email
Counts child categories product totals
Display newest comments first - The order in which comments are displayed. If checked newest comments are first.
Show who is viewing listing/category - Shows who is viewing a listing/category

Custom Themes:

If you are using a custom theme other than the default that SMF is using then the link/button image for the classifieds will not appear.
Be warned you should create a backup of your index.template.php of the theme you are editing before you make any changes to the file.
For editing themes you should be sort of familiar with php and html. I also suggest to have a text editor with syntax highlighting so you can find mistakes such as ZendStudio.

In order to add a button for a custom theme you will need to edit the index.template.php of your custom theme.

Other Languages:

For using languages other than English the first thing to do is check the SMF Classifieds forums and see if someone has translated SMF Classifieds to your language already.
If not there are three files that will be need to be translated, these files are located in your themes languages folder.
classifieds.english.php or classifieds.english-utf8.php if you are using a UTF based language.
To translate just open up the file and replace all the text inside the single quotes.
$txt['class_something'] = 'REPLACETEXTHERE';
And then save the file as your SMF language file name
For example if you were using Spanish as your language.
You would save your changes as classifieds.spanish.php or classifieds.spanish-utf8.php if you have a UTF enabled forum.

Next, you will need to translate modificiations.english.php or modifications.spanish-utf8.php
To translate just open up the file and replace all the text inside the single quotes.
$txt['class_something'] = 'REPLACETEXTHERE';
And then save the file as your SMF language file name
For example if you were using Spanish as your language.
You would save your changes as modifications.spanish.php or modifications.spanish-utf8.php if you have a UTF enabled forum.
You only have to worry about the UTF files if you are running SMF 1.1.x or higher and have UTF enabled.

Last, you need to translate Who.english.php find $txt['whoall_classifieds'] and translate and place that in Who.yourlanguage.php You will now have all the language strings that SMF Classifieds needs translated

Copyright SMFHacks.com 2008