SMF Gallery Help

For Lite and Pro Editions

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

SMF Gallery is a gallery system for SMF. Allows users to upload pictures to the gallery and comment on them.
SMF Gallery comes in two editions SMF Gallery Lite and SMF Gallery Pro.
The Lite Edition is primary for people who do not have many pictures or are on a limited budget.
The Pro Edition supports multiple pages of images and some additional features.

Installing:

Requirements for SMF Gallery Lite or Pro:
To have SMF 2.1.x, SMF 2.0.x, SMF 1.1.x or SMF 1.0.x installed and that your PHP has GD support.
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.

Lite Edition: Install is simple you can download the package from the SMFHacks.com site and upload it to your packages directory on your SMF forum.
Or you can add the SMFHacks.com package server with the server address of www.smfhacks.com and download it directly to forum. Shown in this picture.

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 Gallery 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 gallery in the menu of your custom theme.
You can access the gallery via http://www.yoursite.com/?action=gallery 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 gallery visit the Custom Themes section.

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

Permission Setup:

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

Permissions
  • View SMF Gallery
  • Add Picture
  • Bulk Uploads (Pro Edition)
  • Edit own Picture
  • Delete own Picture
  • Rate Picture (Pro Edition)
  • Leave Comments
  • Edit own Comment (Pro Edition)
  • Report Pictures/Comments
  • Auto Approve Comments (Pro Edition)
  • Auto Approve Pictures
  • Personal Gallery (Pro Edition)
  • Manage Gallery

View SMF Gallery permission allows the user to view the gallery and images.

Add Picture permission allows the user to add pictures to a gallery

Bulk Uploads (Pro Edition) Allows the user to upload multiple pictures at one time though the bulk upload form

Edit own Picture permission allows the user to edit their own pictures that they have uploaded to the site.
If they do not have auto approve image permission then their picture will be unapproved till it is approved by an admin.

Delete own Picture permission allows the user to delete their own pictures.

Rate Picture (Pro Edition) allows a user to rate a picture on a scale of 1 to 5

Leave Comments permission allows the users to leave comments on a picture if the allow comments on the picture is set.

Edit own Comment (Pro Edition) allows a user to edit their own comments

Report Pictures/Comments permission allows a user to report a bad picture and if you have the pro edition report comments as well.

Auto Approve Comments (Pro Edition) if given allows a persons comments not needed to be approved.

Auto Approve Pictures permission allows all people in that membergroup to have their pictures autoapproved and will instantly appear in the gallery.

Personal Gallery (Pro Edition) if a user is allowed to have a personal gallery of their own.

Manage Gallery permission should only be given to admins or people you trust to manage the gallery.
With manage gallery they can add and delete categories, delete pictures, approve and unapprove pictures, and delete user comments.


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


Settings Information:

SMF Gallery comes with options to help configure your forum

Settings:
Max allowed image height - The max height of an image allowed in pixels
Max allowed image width - The max width of an image allowed in pixels
Max image filesize - The biggest image that is able to be uploaded in bytes
Gallery Path - Path on the server to the gallery image files
Gallery Url - Web address of the gallery image files
Images per page (Pro Edition) - Number of images per page on a gallery listing
Max thumbnail width (Pro Edition) - The max width of a thumbnail image
Max thumbnail height: (Pro Edition) - The max height of a thumbnail image
Max display image width (Pro Edition)
Max display image height: (Pro Edition)
Max category width (Pro Edition) - The max width of a category image
Max category height: (Pro Edition) - The max height of a category image
Resize Images if too large (Pro Edition) - Auto resizes the picture if it is larger than the limits
Counts child categories picture totals (Pro Edition)
Display who is viewing a picture - Shows which members or number of guests viewing a picture or a gallery
Display newest comments first (Pro Edition) - The order in which comments are displayed. If checked newest comments are first.
Show pictures ratings (Pro Edition) - Shows the pictures rating when you view a picture
Enable multiple folders for picture storage (Pro Edition)
Disable highslide javascript functions on image display (Pro Edition)
Show top rated pictures on the main page (Pro Edition)
Show the most recent images on the main page (Pro Edition)
Show the most viewed images on the main page (Pro Edition)
Show the most commented images on the main page (Pro Edition)
Show the index blocks on top of gallery (Pro Edition)
Show user gallery category on gallery index (Pro Edition)
Allow the user to toggle if comments can be shown or a picture or not.
Thumbnail Settings:
Show total views (Pro Edition)
Show filesize (Pro Edition)
Show date (Pro Edition)
Show comment total (Pro Edition)
Show username (Pro Edition)
Show rating (Pro Edition)
Image Display Settings:
Show image height and size (Pro Edition)
Show previous and next links (Pro Edition)
Show description (Pro Edition)
Show title (Pro Edition)
Show views (Pro Edition)
Show posted by (Pro Edition)
Show date (Pro Edition)
Show filesize (Pro Edition)
Show rating (Pro Edition)
Show Keywords (Pro Edition)
Watermark Settings:
Watermark Enabled (Pro Edition) - wether watermarking is enabled or not
Watermark Image path (Pro Edition) - file path on the your webhost to where the watermark image is
Watermark Image Percent (Pro Edition) - how much percent to make it transparent
Watermark Text (Pro Edition) - text to show for the watermark
Watermark Text Color (Pro Edition) - text color of the watermark text
Watermark Vertical Alignment (Pro Edition)
Watermark Horizontal Alignment (Pro Edition)

Custom Themes:

If you are using a custom theme other than the default that SMF is using then the link/button image for the gallery 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.
For Pro Edition customers I have some button images for certain SMF themes that you can use in the customers only Add On board in the forums.

Other Languages:

For using languages other than English the first thing to do is check the SMF Gallery forums and see if someone has translated SMF Gallery 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.
Gallery.english.php or Gallery.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['gallery_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 Gallery.spanish.php or Gallery.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['gallery_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_gallery'] and translate and place that in Who.yourlanguage.php You will now have all the language strings that SMF Gallery needs translated

Copyright SMFHacks.com