4images Installation

[Nicky]

[ENGLISH]

 ==========================================================
                  4images Installation
  ==========================================================

  ----------------------------------------------------------
  System Requirements:
  ----------------------------------------------------------
  - A webserver or web hosting account (Linux/Apache recommended).
  - PHP version 4.0.5 or higher (we recommend to use always the latest stable version).
    To ensure that 4images is functioning properly, "safe_mode" should be disabled
    ("safe_mode = off" in your php.ini).
  - MySQL version 3.23 or higher (we recommend MySQL version 3.23.33)

  Optional:
  - In order to make thumbnails and reduced size images you need PHP compiled with
    the support for the GD library (http://www.boutell.com/gd) or the ImageMagick
    "convert" utility (http://www.imagemagick.org) or NetPBM (http://netpbm.sourceforge.net).


  ----------------------------------------------------------
  Installation:
  ----------------------------------------------------------
  (For updating from earlier versions see Update.english.txt)

  1. Decompress the .zip archive to a local directory on your system and FTP all
     the files it contains (being sure to retain the directory structure) to your host.
     Once all the files have been uploaded to your site you should point your browser
     at this location.

  2. Now, the Install-Screen comes up. Fill out the required fields and press
     "Start Installation".

  3. The installation script will create and populate all the necessary tables in
     your database and some basics settings.

  4. The Install-Script will then attempt to write to the config.php file which will
     contain the basic configuration data . If the installer cannot write config.php
     directly you will be given the option of downloading the file. You should then
     re-upload the file to your server, overwriting the existing config.php in the
     process.

  5. Set permissions for the following directories:

     chmod 777 (drwxrwxrwx) : data
     chmod 777 (drwxrwxrwx) : data/database
     chmod 777 (drwxrwxrwx) : data/media
     chmod 777 (drwxrwxrwx) : data/thumbnails
     chmod 777 (drwxrwxrwx) : data/tmp_media
     chmod 777 (drwxrwxrwx) : data/tmp_thumbnails
     chmod 777 (drwxrwxrwx) : templates
     chmod 777 (drwxrwxrwx) : templates/default
     chmod 777 (drwxrwxrwx) : templates/default/media
     chmod 777 (drwxrwxrwx) : templates/default_960px
     chmod 777 (drwxrwxrwx) : templates/default_960px/media
     chmod 777 (drwxrwxrwx) : templates/default_full
     chmod 777 (drwxrwxrwx) : templates/default_full/media          

     Set permissions for the following files:

     chmod 666 (-rw-rw-rw-) : all files in the directory "templates/default"
     chmod 666 (-rw-rw-rw-) : all files in the directory "templates/default/media"
     chmod 666 (-rw-rw-rw-) : all files in the directory "templates/default_960px"
     chmod 666 (-rw-rw-rw-) : all files in the directory "templates/default_960px/media"
     chmod 666 (-rw-rw-rw-) : all files in the directory "templates/default_full"
     chmod 666 (-rw-rw-rw-) : all files in the directory "templates/default_full/media"          

     You can do this with FTP programs such as Filezilla, CuteFTP or WS_FTP.

  6. You must ensure you remove "install.php" and any "update_*_to_*.php" files.
     Additionally you may delete all files in "data/database/default" and
     the "docs" directory if you wish.

  7. At this point your basic installation is complete. Please be sure to check the
     General Configuration details and make any required changes in your Control Panel.

  8. Since version 1.7.1, 4images has an internal caching system.
     Please read docs/Cache.english.txt for further informations.
    
     Since version 1.7.9, 4images includes an automatic protection against Cross-Site
     Request Forgery (CSRF) attacks.
     Please read docs/CSRF.english.txt for further informations.
    
     Since version 1.7.10 it is possible to define how the fields should be index
     for the search. The settings can be changed in includes/search_utils.php
     There are 3 types:

     "fulltext": Content will be split up by whitespaces. Words will be normalized and cleaned up.
     "keywords": Content will be split up by comma. Words will NOT be normalized and cleaned up.
     "phrase":   Content will NOT be split up. Words will NOT be normalized and cleaned up.

     The values can also be set in the config.php.

[GERMAN/DEUTSCH]

 ==========================================================
                  4images Installation
  ==========================================================

  ----------------------------------------------------------
  Systemvoraussetzungen:
  ----------------------------------------------------------
  - Ein Webserver oder ein Webhosting Account (Empfohlen wird Linux/Apache)
  - PHP Version 4.0.5 oder höher (Empfohlen wird die jeweils aktuellste Version).
    Um zu gewährleisten, dass 4images einwandfrei funktioniert, sollte "safe_mode"
    deaktiviert sein ("safe_mode = off" in your php.ini).
  - MySQL Version 3.23 oder höher (Empfohlen wird MySQL Version 3.23.33)

  Optional:
  - ImageMagick (http://www.imagemagick.org) oder GD (http://www.boutell.com/gd)
  - Um Thumbnails und verkleinerte Bilder erstellen zu können, wird PHP mit Unterstützung
    der GD Bibliothek (http://www.boutell.com/gd) oder das ImageMagick
    "convert" Programm (http://www.imagemagick.org) oder NetPBM (http://netpbm.sourceforge.net)
    benötigt.


  ----------------------------------------------------------
  Installation:
  ----------------------------------------------------------
  (Für Update von älteren Versionen siehe Update.deutsch.txt)

  1. Entpacken Sie das .zip Archiv (z.B. mit WinZip) und übertragen Sie alle Dateien
     in ein geeignetes Verzeichnis auf Ihren Webserver (Achten Sie darauf, dass die
     Verzeichnisstruktur erhalten bleibt) und rufen Sie dieses Verzeichnis
     über Ihren Browser auf.

  2. Nun erscheint die Installationsmaske von 4images. Tragen Sie alle
     geforderten Daten in das Formular ein und klicken Sie auf "Installation starten".

  3. Es werden jetzt die benötigten Tabellen in Ihrer Datenbank erstellt und
     Grundeinstellungen vorgenommen.

  4. Der Installer erstellt während der Installation eine Konfigurationsdatei mit dem
     Namen config.php im gewählten Installationsverzeichnis.
     Sollte der Installer diese Datei nicht direkt auf Ihrem Server speichern können
     (z.B. wenn er nicht die erforderlichen Schreibrechte besitzt), erscheint am Ende
     der Installation ein Hinweis und die Möglichkeit diese Datei herunterzuladen.
     Laden Sie sich die Datei herunter und übertragen Sie diese auf Ihren Webserver.

  5. Setzen die angegebenen Zugriffsrechte für folgende Verzeichnisse:

     chmod 777 (drwxrwxrwx) : data
     chmod 777 (drwxrwxrwx) : data/database
     chmod 777 (drwxrwxrwx) : data/media
     chmod 777 (drwxrwxrwx) : data/thumbnails
     chmod 777 (drwxrwxrwx) : data/tmp_media
     chmod 777 (drwxrwxrwx) : data/tmp_thumbnails
     chmod 777 (drwxrwxrwx) : templates
     chmod 777 (drwxrwxrwx) : templates/default
     chmod 777 (drwxrwxrwx) : templates/default/media
     chmod 777 (drwxrwxrwx) : templates/default_960px
     chmod 777 (drwxrwxrwx) : templates/default_960px/media
     chmod 777 (drwxrwxrwx) : templates/default_full
     chmod 777 (drwxrwxrwx) : templates/default_full/media  

     Setzen die angegebenen Zugriffsrechte für folgende Dateien:

     chmod 666 (-rw-rw-rw-) : alle Dateien im Verzeichnis "templates/default"
     chmod 666 (-rw-rw-rw-) : alle Dateien im Verzeichnis "templates/default/media"
     chmod 666 (-rw-rw-rw-) : alle Dateien im Verzeichnis "templates/default_960px"
     chmod 666 (-rw-rw-rw-) : alle Dateien im Verzeichnis "templates/default_960px/media"
     chmod 666 (-rw-rw-rw-) : alle Dateien im Verzeichnis "templates/default_full"
     chmod 666 (-rw-rw-rw-) : alle Dateien im Verzeichnis "templates/default_full/media"          

     Dies können Sie z.B. mit FTP-Programmen wie Filezilla, CuteFTP oder WS_FTP tun.

  6. Löschen Sie die Datei "install.php" und alle "update_*_to_*.php" von Ihrem Server.
     Zusätzlich können Sie die Dateien im Ordner "data/database/default" und den
     Ordner "docs" löschen.

  7. Die Installation ist nun abgeschlossen. Sie können sich nun mit Ihrem bei der
     Installation gewählten Usernamen und Passwort in den Administrationsbereich
     einloggen und unter "Allgemein -> Einstellungen" Die Einstellungen für Ihre Galerie
     vornehmen.

  8. Seit Version 1.7.1 enthält 4images ein internes Caching-System.
     Ausführliche Informationen finden sie in der Datei docs/Cache.deutsch.txt.
    
     Seit der Version 1.7.9 enthält 4images einen eingbauten Schutz gegen Cross-Site
     Request Forgery (CSRF) Angriffe.
     Ausführliche Informationen finden sie in der Datei docs/CSRF.deutsch.txt.
    
     Seit Version 1.7.10 kann definiert werden wie einzelnen Felder für die Suche
     indiziert werden sollen. Die Einstellung kann in includes/search_utils.php
     gemacht werden. Es gibt 3 Modi:

     "fulltext": Der String wird aufgesplittet und normalisiert.
     "keywords": Der String wird anhand der Kommas aufgesplittet und nomalisiert.
     "phrase": Der String wird nicht aufgesplittet und nicht normalisiert.

     Die Werte können auch in der config.php gesetzt werden.

[Em_Ber]

My problem is that my Install-Screen never comes up. So I can't even get past that point. What can I do please? Any assitance greatly appreciated.

[V@no]

Pick one or more:
1) you upload .php and .html files in binary mode and not ASCII as you should
2) you didnt upload all the files from the package
3) your server does not support PHP or/and MySQL

[Em_Ber]

Thanks for your expediant reply. I'll double check the files, but I
unzipped the update for 1.7.2 I got and I think I got them all. I didn't
post until I had tried to install and download/unzip about 6 times. I
had the previous liscensed version 4im1.7.1 already running. I was
trying to just do a complete new install because I wanted to clean out
the gallery anyway and thoguht this would take less time. The
previous version was running well and installed without problem on
the server a year ago. One more note, when I uploading w/ftp client,
I got a lot of consecutive virus allerts for a TransScout / SubSeven.
This has only happened three times when I've tried to upload the
unzipped files. I've never seen anything like it. I wish I were more
knowledgeable about this but I'm on a learning curve here. Please,
what are my options? Again, your help appreciated.

[Mr. FourEyes]

I am having trouble installing.

I have downloaded the files (.zip) and unzipped to my hard-drive.

Then I transfered it to my server via FTP and I have tried both ASCII and BIN. I transfered all the files in the english folder but when I access it with my browser, all I get is a Index of the files but no installation.

Am I doing anything wrong, and if I am, what is it?

[V@no]

you transfer all the files into english folder? huh?
1) make sure your server supports PHP and MySQL
2) make sure when you upload files to the server, only .php, .txt, .sql and .html files must be uploaded in ASCII, the rest must be uploaded in BINARY
3) make sure that you recreate the directory tree as in the original package (if a file is in includes folder, on the server it must be in includes folder as well)

[princessew]

After the installation, I went to step where you save the config and now I'm stuck with changing permission of the chmod. I dont see them anywhere, and what are they? should I make them in some folder or is it automatic? Thanks

[V@no]

Refer to your FTP client's manual. This is the basics that you must know in order to use ANY scripts.

P.S. try google: "what is CHMOD" ftp (with quotes)

[princessew]

Thanks I did that, but I still don't get one thing,  it sais this:

 chmod 777 (drwxrwxrwx) : templates/default
 chmod 777 (drwxrwxrwx) : templates/default/media

chmod 666 (-rw-rw-rw-) : all files in the directory "templates/default"
chmod 666 (-rw-rw-rw-) : all files in the directory "templates/default/media"

I don't understand the letters in (), and I haven't seen this when I was changing CHMOD in my FTP client. So sould the chmod be 777 or 666.

[V@no]

666 is equal to -rw-rw-rw- its just different representation of the permissions. Some FTP clients uses numbers only, some uses letters only and some can use either. For you conviniens the author put both in the instructions.

as the instructions said, the folders must be CHMOD 777 and files inside these folders must be CHMOD 666

P.S. I hate to say that, but you seems to know nothing about websites/ftp. maybe you should start with some tutorials (google it) and less advanced and complex scripts then 4images...

good luck.

[princessew]

Aha, it said files! I can't even read... Thanks for your help now everything works and too bad that images uploaded with FTP wont auto thumbnail automatically... I'll just do that on my own. As I know my self I might have some ? in future but for now, I'm good to go! Thanks again!

[izone]

Is there anywhere that I can find a manual upgrade? I have many mods on mine and it is better for me to do it manualy!

[tvvladimir]

I get smae thing as most people here:
1. I have easyPHP installed! that is Mysql, phpmyadmin, apache and php engine!
2. I have checked my php works!
3. i have tried to open the install file with

http://localhost:8080/4images/lang/english/install.php

but i get blank page.

So i guess it ii step 2 or three i do wrong:

2) make sure when you upload files to the server, only .php, .txt, .sql and .html files must be uploaded in ASCII, the rest must be uploaded in BINARY

I have uploaded only binary install! In fact i can't understand howamny file si have to download?! I downloaded binary for windows! and isn't it enough?

3) make sure that you recreate the directory tree as in the original package (if a file is in includes folder, on the server it must be in includes folder as well)

let me see if i understant this statement right- i just copy and pase unzipped folder 4images to my localhost root folder? with all the folders and files being same as when after being unzipped?

[V@no]

1) you dont need to point to any of .php files, or if you wish, point to install.php that is located at your 4images root directory: http://localhost:8080/4images/install.php
2) I dont understand neither what you did nor what is your question... if you are working on your local machine, then that step not applyed to you, it only needed if you upload files via FTP to a remote server
3) exactly. the zip archive already has all needed files into correct folders. All you have to do is copy the files into the same folders as they are in the archive.

[tvvladimir]

God i';m so stupid! I was pointing at wrong nstall php file!