This page describes the initial setup procedure of phTagr to initialize and configure phTagr. It assumes that you successfully installed all the required software (see HowToInstall or HowToInstallInUserDir).

You init phTagr either through the system wide environment  http://localhost/phtagr/setup or through your home directory  http://YOUR_SERVER_URL/~YOUR_NAME/phtagr/setup.

Assumtions

All modifications assumes that you are in the directory of phtagr (e.g. /var/www/phtagr/app or ~/public_html/phtagr/app).

Watch the setup procedure at youtube:  http://www.youtube.com/watch?v=KMgQ4zqb5D4

Security Salt

phTagr has a security salt which is used for password and session encryption. Therefore this must be changed first (otherwise the setup session would not working properly). If the file ./config/core.php is writeable phTagr changes the security salt by its own. Otherwise you get an hint to change it manually

Setup

If your web server, cake and phTagr are working properly (and the security salt is changed), you get an welcome screen

Continue on clicking on click on here.

Paths

phTagr checks if the required paths are writeable. Usually it should be already done in the install procedure but maybe something went wrong. So you get following screen to change the paths

Information: The user path is uses to store all uploaded data and preview cache files of the users. The tmp directory is used for system cache files and for debug and log files.

Database Connection

Now phTagr request the correct database connection. If phTagr can write into the path ./config you will get following screen to complete all the settings for you database connection

If the directory ./config is not writable you get an sample file for the database which should be writen to ./config/database.php. Please edit the page by your own.

After successfull database connection phTagr initializes now all the required tables.

Admin User

phTagr requests now some data for the admin account.

Please fill out the form with our prefered name, password and email. This email will be used for password recovery or comment notification.

Note: The admin account gets an initial upload quota of 100 MB. This could be changed later in the system preferences.

External Programs

phTagr could use some external programs for some advanced features (e.g. create video thumnails, flash videos, or writing meta data back to the photos). These external helper programs are optional and could be set here. phTagr searches in /usr/bin, and /usr/local/bin for these files. You have to enter it manually if phTagr could not find it - or you can set them later in the system preferences.

Note: To create proper flash videos ffmpeg should be built with mp3 support! See CreateFlashVideo

Final

phTagr is now completely installed and ready to rock! Congratulations! Now continue with the FirstSteps...