TETSI USER'S GUIDE

1. General Information
   1. License
   2. Requirements
   3. Installation
   4. Menu Types (Single Page Text, Stories, Pictures, Guest Book)
   5. Images
2. Administrator's Area
   1. Managing Menu Items
   2. Managing Users
   3. Changing Settings of the Website
   4. Changing Your Profile's Data
   5. Managing Single Page Text
   6. Managing Story Items
   7. Managing Picture Galleries
   8. Managing Guest Book

Introduction

TETSI system is targeted to travelers who want to publish their travel stories and picture galleries on the world wide web. TETSI includes easy management of stories, pictures, guest books, system users.

License

This software is licensed under the GNU GPL

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

Requirements

Minimal webserver requirements for the TETSI driven website:

• Apache 1.3.23
• PHP 4.1.0 (not tested on PHP 5)
• GD 2.0.1
• MySQL 3.21

For text editing in the TETSI administrators area a revamped version (2005/06/07, by Timothy Bell) of the WYSIWYG editor Cross-Browser Rich Text Editor (by Kevin Roth) is used: <http://www.kevinroth.com/rte/demo.htm>
For the forum thread of the revamped version 2005/06/07, click here.

Installation

Here are few simple steps to install and run the TETSI engine on your website server:

1. Download tetsi.zip file from the website.
2. Unzip the file in your local disk to the /tetsi/ directory.
3. Open the configuration.php file and edit
   1. database login information;
   2. specify the path to the directory of your pictures:

      For example, if your pictures are in the directory "photos", then you write
      $pathPhotos = "photos";
      If some of your pictures are in the main directory of your webpage, you may leave photos path information empty:
      $pathPhotos = "";
      

      Note, that you will have to upload (using FTP or web-based file uploading application) your JPG picture files to the directory specified in $pathPhotos. It is not possible to upload files using TETSI engine.

4. Upload all files from /tetsi/ directory in your local disk to the main folder of your website server.
5. Install TETSI engine by running install.php file through your browser.
   E.g., if your website is http://www.yourdomain.com/, then go to the page: http://www.yourdomain.com/install.php .
6. Manage the content of your website through the administrator's area: http://www.yourdomain.com/admin/
   Username for the administrator's area is "admin". Password is "tetsi".
7. Whenever you login the first time into administrator's area, you will have to change your "tetsi" password to a new one. Also you will be given the possibility to change "admin" username to a new one.

If you will have problems installing TETSI, please write us a message.

Menu Types

There are for types of possible menu layouts, while designing your TETSI driven website. To write a welcome message to website visitor's you may use a SINGLE PAGE TEXT menu type. To organize your stories, which may have one or more sections, use STORIES menu type. For grouping your travel pictures pictures use PICTURES menu type, which allows you to manage picture galleries, with one or more sections. The GUEST BOOK menu type will become handy once you will decide to have a guest book for your website. The user may create as many as he/she wants of menus, assigning one of 4 possible menu types. More about managing menus with website's "Administrator's area" in "Managing Menu Items"

Images

TETSI system supports JPEG picture format. In order to have pictures on your TETSI driven website, first you have to upload picture JPEG files to your webserver (using FTP, or maybe web-based image upload application provided by webserver administrators).

Administrator's Area

There are two kind of users for the Administrator's area - administrators (have full access to the website) and non-administrators (are allowed to manage only certain menu items). Logged-in users are automatically logged-off after 15 minutes, if no actions were taken. The value of 15 minutes could be changed in admin/class_sqlsession.php by writing a different value for var $MAX_AUTH_IDLE = 900;.

On the left of the administrator's area, the user may choose item to edit. By pressing menu names above the [LOG OUT] button on the left, the one may edit the contents of the particular menu item. Below the [LOG OUT] button the user may choose to edit menus, users, settings and personal profile.

Explanations of the images used in the administrator's area of TETSI system:

	EDIT the current item.
	DELETE the current item.
	Change the order of items by moving the particular item UP.
1 2 3 4 5 6 7 ...	Number of positions the item should be moved (this feature is only for managing order of images).
	Change the order of items by moving the particular item DOWN.

Managing Menu Items

Menu items could be managed via [EDIT] --> [menus] on the left menu. Only users with administrator rights are allowed to change the order of menu items.

Managing Users

[EDIT] --> [users]. Create, delete and edit users of the website administrator's area. It is not allowed to delete yourself from the list of users.

Changing Settings of the Website

[EDIT] --> [settings]. The list of changeable settings is as follows:

GENERAL SETTINGS
FIRST PAGE TITLE	Edit the text that appears in the top block of the webpage.
MAIN TABLE POSITION	Position of the whole webpage: { left | center | right }.
WEBSITE STYLE/COLORS	Assigning certain CSS style sheet for your TETSI driven website. To generate CSS style by yourself, please, use our Online style generator.
WEBSITE ENCODING	Choose encoding of your website. This will add appropriate "charset" meta tag for the pages of your website. It is handy when the website contains travel non-English stories. E.g.: <meta http-equiv="content-type" content="text/html; charset=iso-8859-1">
COMMENTS / GUEST BOOK ENTRIES
COMMENTS PER PAGE	Number of story/picture gallery comments to show per page.
GUEST BOOK ENTRIES PER PAGE	Number of a guest book entries to show per page.
MAX WORDS IN THE COMMENT	Maximal number of words allowed in the comment posted for the story/picture gallery.
MAX WORDS IN THE GUEST BOOK ENTRY	Maximal number of words allowed in the guest book entry posted.
SUBSTITUTION FOR '@'	Combination of letters to substitute the '@' symbol in the email addresses provided in user comments/guest book entries. This will prevent spammers' software to filter email addresses. Instead of "name@domain.com" will be displayed e.g., "name(a)domain.com". Examples: "(a)", "[a]", "[ at ]".
WEBSITE TIME ZONE & GMT(UTC) DIFFERENCE	The difference between the time you wish the guest book entries and comments to be displayed, and UTC (Coordinated Universal Time, also called GMT -- Greenwich Mean Time).
EMAIL NOTICES
ADMINISTRATOR'S EMAIL	Email to which notices about newly inserted and too big comments/guest book entries will be sent.
NOTIFY - "TOO LARGE" COMMENT/GB	The user may choose, whether to send information about a website visitor's attempt to insert too large comment/guest book entry.
NOTIFY - NEW COMMENT/GB	Choose whether to notify about newly inserted comments/guest book entries.
THUMBNAIL SETTINGS
WIDTH	Specify the width for the picture thumbnails displayed in the picture galleries.
HEIGHT	Specify the height of the thumbnail.

Changing Your Profile's Data

[EDIT] --> [my profile]. Update information about yourself: name, email address, password. If you do not want to change the password - leave both password fields empty.

Managing Single Page Text

Whenever you edit the menu item that has the SINGLE PAGE TEXT type, you are able to edit the contents of the page.

Managing Story Items

If the menu has a STORIES menu type, you can change the order of stories, create/edit/delete story's profile (by pressing [Profile] button), sections of the story ([Sections] button), related links ([Links]). It is possible to edit/delete visitors comments posted on the certain story item ([Comments]). The one also may assign a picture gallery to the story ([Pictures]).

Managing Picture Galleries

In case the type of menu is PICTURES you can change the order of picture galleries, create/edit/delete gallery's profile ([Profile] button), sections of the gallery ([Sections] button). By pressing the [Comments] button, the editor may edit/delete visitors comments posted on the certain picture gallery item.

NOTE: as it was mentioned in the Section Images, first you have to upload pictures to the webserver and then you will be able to add those files to the picture gallery by using TETSI administrator's area.

Managing Guest Book

For the GUEST BOOK menu type it is possible to edit/delete guest book entries.