SMF Store Help


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

SMF Store is an ecommerce system for SMF. Allows a forum owner to setup their own store for their forum / website

Installing:

Requirements for SMF Store:
To have SMF 1.1.x installed, paypal business account, fsockopen enabled 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 Store 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 store in the menu of your custom theme.
You can access the store via http://www.yoursite.com/index.php?action=store 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 store visit the Custom Themes section.

After the package is applied you are ready to go. Click on Button/Menu Link to view the store. The first thing you need to do is create a new category for your images.
I would also check that the store has read and write permissions to the store folder. This is needed in order to upload pictures to your website.
For an IIS server you will need to set the store 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 store. This will be discussed in the Permission Setup section.

Permission Setup:

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

Permissions
  • View Store
  • Rate Item
  • Add Comments
  • Edit own Comment
  • Auto Approve Comments
  • Admin Store

View Store permission allows the user to view the store.

Rate Item allows a user to rate a product on a scale of 1 to 5

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

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 Store permission should only be given to admins or people you trust to manage the store.


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 store permissions that the membergroup needs.


Settings Information:

SMF Store comes with options to help configure your forum

Settings:
Store Path - Path on the server to the store files
Store Url - Web address of the store files
Buy Now image url - Choose what image to show as the buy it now button
Items per page - Number of images per page on a store 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 store
PayPal Email - the PayPal email used for your store
Notify Low Stock Qty - set the qty to receive an email when the stock is low
Notify Low License Key Qty - set the qty to receive an email when the licenses is low
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 products ratings - Shows the products rating
Show Comments - Whether comments are showed on product pages or not.
Category Display Settings
Show picture
Show price
Show instock
Show date
Show comment total
Show rating

Custom Themes:

If you are using a custom theme other than the default that SMF is using then the link/button image for the store 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 Store forums and see if someone has translated SMF Store 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.
Store.english.php or store.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['smfstore_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 Store.spanish.php or Store.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['smfstore_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.2 or higher and have UTF enabled.

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

Copyright SMFHacks.com 2007