>> Table of Contents >> Beginner's Guide

Beginner's Guide


automatic installation

Notice to PHP newbies: This software requires PHP and thus will possibly not run on your local hard disk, but only on the internet. To be able to run this software on your web site your provider needs to support PHP. If in doubt, ask your provider.

Please remember to check the system requirements and notes on compatibility.

The Yana Framework has a tool, which can accomplish the installation for you.

Step-by-step instructions

To run the installation program do as follows:

  1. Open a connection to your account via your FTP program.
  2. Copy the files "install.php", "install.pak" and "yana.zip" to a directory on your server
  3. Set the access rights for this directory via your ftp program, so that the script may read and write files. For Unix use CHMOD 777. (see figure)
  4. close FTP connection.
  5. Open the file "install.php" in your browser

When starting the installation program you should see the following page:

Figure: front page of the installation program

Click on "next" to continue

Figure: License conditions

Read the license conditions carefully. In order to continue with the installation, you must accept the license conditions. If you do not want to use the program, you can abort the installation by clicking the button below.

Figure: perform installation

To accomplish the installation click the button "start installation now". When you are finished, click "next".

Figure: choose password

On this side you specify a password. With this password you can enter the administration menu of the application. To do so, use the name "administrator". First please enter the password in the left field. Second please retype the password in the right field, just to ensure you didn't mistype it. Following this please click on "OK".

A message will be shown that indicates whether or not the operation has been successful. When you are finished, click "next".

Figure: self diagnosis

In order to make sure that the installation was successful, you may want to run the self diagnosis of the program. To do so click on "OK". Consider the viewed operating instructions.

If you wish additional details to the be printed, mark "more details" and click "OK" again. If you are content with the installation, continue by clicking on "next".

Figure: Finish installation

After completion of the installation the program automatically deletes all temporary files. If you check the option "run the application now", the YANA Framework is started automatically.

To end the installation program click on "finish".

manual installation

Please remember to check the system requirements and notes on compatibility.

Step-by-step instructions
  1. the program files are stored in the archive "yana.zip". Unpack the files using a ZIP program of your choice.
  2. Open a connection to your account via your FTP program.
  3. Upload all files and directories, belonging to the program, to a folder on your web page and link to the start page "index.php" from some page of your choice on your web site.
  4. Set the access rights for the directories "config/", "cache/", the included files AND subdirectories to read and writable for group "public" using your FTP program. For Unix use CHMOD 777. (see figure)
  5. close FTP connection.

Example: Setting access rights

Figure: WS_FTP LE, Win 2000

In WS-FTP (for example) you can change access rights by right-clicking on the directory names and selecting the option "file attributes" from the context menu. Then check all shown options and click "OK".

Figure: FireFTP, Win XP

In FireFTP you can change access rights by right-clicking on the directory names and selecting the option "Properties (incl. contents)" from the context menu. Then check all shown options and click "OK".

If you are using another FTP program, set the rights via the command CHMOD 777 . If you experience problems finding the "right button", search the documentation of your program for the keyword "CHMOD".


open online menu

Open in your browser the file "index.php?action=index", which is stored in the program's main directory.
You will be asked to log on to the system with your user name and associated password. (see figure)

Login: Administrator Password:
Figure: login - Screenshots: Firefox browser

Enter the text "administrator" as "Login".

  1. If you used the "automatic installation", you must now enter the password, which you did choose at the time of installation.
  2. Otherwise, leave the "Password" empty this time.
  3. If you have forgotten your password continue reading at the section "frequently asked questions".

Confirm your entry by clicking on "OK". Then you may access the administration panel. Please note that JavaScript should be activated in your browser, so that the next page can be displayed correctly. If JavaScript is disabled you may experience that some features are not available. Personally I recommend you use Firefox 1.5 or later to view this page.

Choose password

The following section describes how to change the password for your login.

old password: new password: ********
Figure: Change Password

? Tip: To avoid, that someone may guess your password, it should be a minimum of 8 characters in length and contain at least 2 special characters. For example: birthdays, names of persons or animals and terms used in standard dictionaries are easy to guess.

Step-by-step instructions
  1. Scroll down to section "change password".
  2. If you haven't set up a password during installation, you may leave the input filed "old password" empty.
    Otherwise, enter your old password here.
  3. Enter the text, you want to use as password, in the field "new password". (see figure)
  4. To make sure you didn't mistype your password, enter the text again at the field labeled "confirm password".
  5. Click on "save changes".
  6. Finally, you will be asked to use your new password to login to the system.

Write down your new password and keep it safe.

? Note: if the access rights were not set, as described in the "installation" chapter, you will get an error message at this point. In that case read again, what you need to do and execute the instructions step by step. If required contact your operator.

Edit settings

? Note: Please understand that not all the options and settings are explained in detail. The following text will therefore only comment on the most important settings. Where needed follow the references in the program.

If you now want to set up your own settings for your application, please select "page layout Setup" from the options table. On this page you may define the layout of the program. E.g. font size, font color or date format. Colors must be specified as hexadecimal values. If you do not know how to do this, click on the square, colorful button next to the field. This will open a pop-up window, which let's you choose a color. Please also read the help text on this page for more information.

Menu to set up layout options
Figure: layout Options

  1. You may click the button "expert mode" In the administration menu, in order to view advanced options
  2. Click on the small icon with the red / white "i" to get additional information on the current menu
  3. To be able to open or close menus JavaScript has to be enabled
  4. To improve security please remember to click the "Logout" button on the main menu, when you have finished your settings
  5. On the main menu click on the name of a plug-in, a language pack or skin pack to get a description

Author: Thomas Meyer, www.yanaframework.net