Active Web Hosting Logo

How To Install 4images 1.7.1

What is 4images?

4images is a photo gallery where you can upload and manage your artwork, photos and other images. This is perfect for displaying your photo album, art gallery, or even distributing desktop wallpaper for your visitors to download. Please be sure that you own the images you upload. Active Web Hosting may deactivate any domain that is found to be in violation of copyright laws.

Requirements:

To use 4images, you need to be sure your CGI account is set up. Please see How To Request A CGI Account for more information. You may also need to have a MySQL account set up if the script accesses a MySQL database. Most PHP-based scripts require this. Please see How To Request A MySQL Database. You will also need to download a copy of 4images. The version used in this tutorial was 1.7.1.

IMPORTANT SECURITY NOTE!
Always be sure you have installed the latest updates and/or patches for the script as well as for any additional add-ons. Updates are very important to the security and proper functioning of the script! Our instructions may be for earlier versions of scripts due to the fact that we are not able to keep up with updates to every script at all times. It is still up to the domain owner to install and use the latest version of these scripts.

Downloading Instructions:

Since the site is in German, English users will want to follow these instructions to obtain the 4images photo gallery script. There are some English translated text on the site but usually the English text is located at the bottom under the German text. Please also note that these instructions were written on March 17, 2005. The 4images site may change in the future.

  1. In the top right side box named 4Images Gallery click the Download link.

  2. Click the radio button next to the English Language-Pack.

  3. Click the check box next to Yes, I agree with the Terms of Use.

  4. Click the Download Button.

  5. Click the Download link in the 4Images Gallery box again.

  6. Click the radio button next to the top download labeled 4images 1.7.1.

  7. Check the box next to Yes, I agree with the Terms of Use.

  8. Click the Download Button.

Restrictions:

Remember that only your main account can access CGI scripts on your server. Any hosting or extra FTP accounts that access these scripts may cause your account to be deactivated and you'll have to contact support.

4images will let you allow visitors to your site and/or registered users to also upload files. Your visitors are not to upload files to your server space. Active Web Hosting's policy is to deactivate any account where anyone other than the domain owner (you) uploads files to the CGI server.

Active Web Hosting only allows web-based files on the CGI server. This means only jpg, gif and png files may be uploaded using 4images, even though 4images allows you to upload other files. For more information, please see File Types Allowed On The CGI Server.

For 4images to work correctly, please do not put it or it's directories inside your cgi-bin directory. If you do, the script may not work. It's best to use a separate directory and leave the cgi-bin directory for your smaller scripts.

Installation:

  1. Extract the language pack and 4Images script files. Copy the english and images_english directories from the language pack directory into the 4images directory.

  2. Create a blank text file called 'config.php' in the 4images directory.

  3. Create a new directory on your CGI server (a suggestion would be a directory called 4images). Upload all the 4images files and directories to the new directory on your CGI server.

  4. Change the file permissions of the config.php file to 666.

  5. Change the file permissions of the following directories to 777:

    data
    data/database
    data/media
    data/thumbnails
    data/tmp_media
    data/tmp_thumbnails

    templates
    templates/default
    templates/default/media

  6. Change the file permissions of all the files in the templates/default and templates/default/media directories to 666:

Configuration:

  1. Point your browser to http://cgi.yourdomain.com/4images/install.php replacing the yourdomain.com with your actual domain name. You should see the installation screen in German. Click the English link in the upper right corner, under the title graphics.

  2. Fill out the form as follows. Note that items in brackets [] are to be filled in with the appropriate information for your domain. For example, yourdomaincom should be replaced with your actual domain name, omitting the dot.

    Database server type: mysql (default)
    Database server hostname: localhost
    Database name: [yourdomaincom]
    Database username: [yourdomaincom]
    Database password: [Your Database password]
    Prefix for tables in database: 4images_

    Admin username: [Pick a username for the administrator account]
    Admin password: [Pick a password for the administrator account then confirm it]

  3. Click the Start Installation button.

  4. Your installation should be successful and a message should appear telling you to go to your administration control panel.

  5. Before you go to the control panel, go back into your CGI server and delete the install.php and update_*_to_*.php fles.

Setup:

Point your browser to http://cgi.yourdomain.com/4images/admin/index.php replacing yourdomain.com with your actual domain name. Log in with your new Admin username and password.

Click on the Settings link in the General section in the left side menu. Change the following (leave anything not mentioned at the default settings). You can make additional changes later if you wish. Note that items in brackets [] you should fill in with the appropriate information.

General Settings:

Site Name: [Type in your site name here.]
Admin Email: [Type in your email address here.]
Choose language directory: english
Conversion tool for thumbnails: None

NOTE: All thumbnail options were tested and we could not get any of them to work in version 1.7.1, so therefore in that version you need to set the Conversion tool for thumbnails to None and upload your thumbnails separately.

In the latest version of 4images, thumbnails are working just fine if you set it to use GD for generating thumbnails.

Upload Settings:

Valid file extensions: jpg, gif, png

NOTE: We do not allow any other file types to be uploaded on the CGI server via this script.

Auto-create thumbnail: no (Please see note for Conversion tool for thumbnails above.)

Comment settings:

Badword list: [Use the example to add words you do not wish to show up in the comments.]

Click the Save Changes button. You should see the Settings Saved message at the top left of the page.

Adding A Category

NOTE: You must add a category before you can upload any images.

Click the Add Categories link in the left side menu in the Categories section. Type in a category name and description.

Permissions:

View Category: All
View Image: All
Download: All (or Registered Users)
Upload: Administrators (See note below.)
Direct Upload: Administrators (See note below.)
Vote: Registered Users
Send eCard: Registered Users
Read Comments: All (or Registered Users)
Post Comment: Registered Users


NOTE: Only domain owners may upload files to the CGI server. To prevent visitors from doing this, the Upload and Direct Upload options must be set to Administrators. Your domain may be taken offline if it is found that you are allowing visitors to upload files to your CGI directory.

Click the Add button. You'll then see the message at the top left: Category Added.

Adding An Image

  1. Click on the Go to the Gallery Home Page at the top right of the page.

  2. Click on a category name.

  3. Click on the Upload button on the top right.

  4. You can upload a file from your hard drive using the Browse... button, or you can use the URL field to point to an image on your web server. Be sure you own the image!

  5. If you are using an older version of 4images, and not the most recent, then do this for the thumbnail file if you have one. Note that if you leave this blank a default thumbnail will be used, instead of a smaller version of the image. It is recommended you make your thumbnails no larger than 150 x 150 in size.

  6. Fill in the title (name) for Image Name.

  7. Fill in a description of your image.

  8. Fill in keywords for your image, separating each word with a space.

  9. Click the Submit button.

Deleting An Image

  1. Click on the thumbnail of the image you want to delete.

  2. Click the [delete] link under the image.

  3. Choose yes when asked in a separate window if you want to delete an image. NOTE: Firefox and other tabbed browser users may see this in a separate tab as the last tab in the row.

  4. Click the YES button. NOTE: If you get an error when deleting the image, close the delete image window or tab, go back to the image page and try again.

Troubleshooting:

I get a database error when I try to run 4images.

Be sure that you have set up the configuration properly. For more information, please see I get a database error when I try to run a script that accesses the MySQL database.

I get a notice saying there was an error deleting a file.

Close the delete image window or tab, go back to the image page and try again.

I click on the [delete] link and nothing happens.

Firefox and other tabbed browser users may think that nothing has happened when they clicked on the link. Look for an extra tab at the end of your row of tabs in your browser. The last one should be the delete page. This can happen if your browser is set up to open popups in a tab rather than popping up normally.

Support:

If you have any problems or questions about 4images, please contact the author at 4homepages.de

Active Web Hosting may not be able to provide support for this program or it's installation.

Alternative Software:

Below you'll find a list of alternative software that you may also want to try. Click on the program name to go to the author's site. Click on the 'Tutorial' link to view our installation tutorial.

 


Home - Support - Management - About Us
... Active Web Hosting, 1445 American Pacific Dr. Ste 110-318, Henderson, NV 89074 ...
Toll-Free (800) 946-7764   Fax: (702) 567-1831