Welcome to Toko Web Services
Authoring & Editing web pages
is

easier

then ever !

The

Toko Lite

Version

The box is not shipped.

This is a downloadable product.

Welcome!

Thank you for downloading Toko Web Editor, the industry leading web editor software from Toko Web

Services. With years of experience creating professional web editors software, we have created a new
standard in speed, efficiency and ease of use.

Our product is written in PHP, the web's fastest developing scripting language, and combined with your

choice of language and GUI language.

Why Toko Web Editor?

Toko Software is packed with features for both users and administrators alike, making it a great

experience for your visitors/users and a great experience for you. With innovative features such as multi-
site support, edit area text limitation and upload files of numerous feature settings, comprehensive

warning messages and detailed permission level, administering your sites is easy.

We don't just have great features - we have great support to back them up. We offer clients technical

support via online web Forum and e-mail.

Options to suit everyone!

We offer 2 tiers of license to suit everyone. You can choose to use Toko Light for FREE, or for best value

a Toko Pro with full feature package!

We want you to make sure Toko Web Editor is the right option for you. For this reason, we offer a free

version that is unrestricted and unlimited. Download it today and see what we have to offer!

Help us help you

If you have any questions, queries or comments about our products or services, we'd love to hear from

you. Our contact information is found on our contact page.

We hope you and your visitors enjoy using Toko Web Editor!

1. Conventions Used

Several formatting conventions are used throughout these documents to identify particular types of

information. Three types of information box are used:

WARNING

Warning boxes display very important information that you should read. In many cases, incorrect use of

the settings mentioned in these boxes might cause you installation to behave unexpectedly.

NOTE

General informative notes, advice and links will be displayed in these boxes.

TIP

Tip boxes will be used to tell you about tips & tricks that might save time and/or effort.

When you are instructed to click a button, the button will be shown as:

This is a button

To indicate text that may or should be typed in by you, this formatting is used:

Enter this text

Menu hierarchies are shown using the format: Top menu -> Next menu

Links to other documents/sites are shown as:

Toko Web Services

2. Installation Guide

System Requirements

Whether you're setting up Toko Web Editor for personal, corporate or e-commerce use. On a windows Unix
Mac or Linux, we tried to make your life easy. All of our installation instructions are easy to understand even
for non-technical people.

NOTE

No Data Base (such as MySQL) is needed with Toko web Editor

To install Toko Web Editor, your web server must meet the following specification:

•

Support for running PHP 4.1.0 (or better) scripts.

If you are unsure whether your server meets these requirements, please check with your host before
proceeding with the installation. Advanced users may wish to

download PHP

and install it themselves.

Toko Web Editor works best on an Apache server, and is Apache v1 and v2 compatible.


General Requirements

You will need to have a FTP client installed on your computer to be able to transfer the Toko Web Editor source
files to your web server. Clients you may like to try are:

•

SmartFTP (Windows):

http://www.smartftp.net

•

Transmit (Macintosh):

http://www.panic.com/transmit/

Almost Ready...

You do not need to know PHP to be able to install (and use) Toko Web Editor. However, a basic knowledge of
using FTP is a plus. If you don't know how to use FTP, we would recommend you read the documentation
supplied with your FTP client and learn the basics of uploading files and setting permissions on them (CHMOD).

We are assuming you have already downloaded the Toko zip file, and have unzipped it on your computer. This
installation guide will use the term 'ZIP archive' in reference to the zip file you have downloaded, 'local folders'
in reference to the unzipped TOKO files you now have on your computer and 'remote folders' in reference to the
folders and files you will be putting on your web server.

Got it - let's go!

Uploading

Document Info

Last updated:
» 2nd Jul 2004

Updated by:
» Misk E

If you haven't done so already, create a new directory on your server named appropriately (if you wanted to
access the web editors via 'http://www.domain.com/tokoeditor/', create a directory called 'tokoeditor' in the
'public_html' or 'www' directory on your webserver.

Using your FTP client, move into the directory you wish to upload to (if you followed the above advice, move
into the newly created 'TokoEditor 'directory.)

Creating the directories

Using your FTP client, create the following directories:

•

Images

•

Strings

TIP

If your FTP client supports 'Drag n' Drop' which most modern clients do, you can save yourself some time

and effort by simply selecting all the files from the 'unzipped' zip archive and drag them into your FTP

client window, this will then copy all the files, creating the directories as it goes. If you choose to do this,
you can safely ignore most of the following instructions; just remember to CHMOD as outlined in the

structure and CHMOD guide.

Once the directories have been created, CHMOD the folders "Images" and "Strings" to 0755 (if you get

permissions errors later on, you can CHMOD these to "0777"). Now, upload the contents of the files in
your local folders (from the zip file) into the corresponding directories you've just created on your server.

Some folders will contain other files and folders, upload them all - preserving the structure you have in

your zip file (for example, upload the entire contents of the "Strings" folder on your computer to the

"Strings" directory on the server).

Once you have finished uploading into the directories, upload the rest of the files to the same place as
you created the directories earlier (into "tokoeditor" for our example).

Step For Linux/Unix users only

CHMOD all the PHP files *.php to 0666 (if you get permission denied errors later on, you can CHMOD this

to 0777).

That's it !

The hard work is now done! You can proceed to the next step.

CHMOD & File Structure

NOTE

CHMOD only applies to Linux and Unix-based servers. If your server is running Microsoft Windows, you

do not need to CHMOD files and directories.

What is CHMOD?

"CHMOD" is short for "Change Mode". It is essentially the permissions system that Unix and Linux

operating systems use to define who can and can't access particular files and directories. Why does this

matter to TOKO? Well, when a script (like TOKO) writes data to a file, it needs to have the permission

from the operating system to do so. Without it, an error Toko will not be able to save or read information
from files. To give the script permission to write to a particular file, that file must have the proper

permissions set, and doing so is often referred to as "CHMODing" the file. So, CHMOD basically means

changing the access permissions on a file.

CHMOD permissions can be represented using 4 numbers, such as

0777

or

0755

. Most modern FTP clients will

allow you to simply enter this number and it will set the permissions on that file as needed. It is this
number notation that we will use here. Check your FTP client manual to find out how it handles CHMOD,

and how to set CHMOD permissions on a file.

CHMODing Your Files

Use this table as a guide as to which files and directories should have which permissions. Some need the
correct CHMOD from the outset to be able to install Toko, others won't affect the installation but will be

needed to edit certain settings later on. We recommend you set all permissions now to avoid confusion

later.

As well as CHMODing the folder itself, some folders will require you to CHMOD the contents of that folder

too. To do this, navigate into the folder concerned, select everything inside it and follow your FTP client
instructions for CHMODing.

Required CHMOD Values

File/Directory

CHMOD Value

index.html

0644

toko.conf

0755

CheckLogin.php

0755

Edit.php

0755

EditNavBar.php

0755

Frames.html

0644

Editors.html

0644

LoadConfig.php

0755

Login.php

0755

Str.php

0755

Toolbar.html

0644

toko.css

0644

Index.php

0755

Images

0644

Administration

Your Administration File

Toko Web Editor Lite is customizable, with settings exposed to the administrator only. The default

settings when you install your Toko are usually sufficient, so most of the work is done for you. Inevitably

though, there’ll be a few things you would like to change. Don't worry; this guide will explain each and
every option available to you.

The administration file is the power horse behind your web editors. It is where all settings relating to

your users can be set up and later edited if necessary.

Configuration File

The configuration of Toko Lite is simple. You basically have a master file (toko.conf) where you define

the user detail and the configuration parameters.

toko.conf

Edit your mater file toko.conf

You can access your administration file in the main directory (before uploading it to your server).

Simply edit the toko.conf with any text editor.

See below an example of the users.conf.

1) [users] must exist at the top of the file. (In the LITE version you are limited to one user only)

In this section you define user names which will be granted access to the system as well as their

passwords in the following format: username,password

For example: my_new_user11,verysecret123

2) [settings] rootpath

This is the FULL path to the directory that will be considered as the root directory. The root for

all of the edited files are located.

e.g. if the rootpath defined as

rootpath=/home/user01/public_html/news

This means that once you login to toko with your user name and password, you will see the
mentioned folder as the root (meaning /). You will be able to edit any

File with Toko edit tags situated under that folder and subfolders.

Note: This is not the Full path to where Toko files are located, although it can be.

3) [settings] extensions

What kind of file types should be visible to the users when browsing for Toko files in the
following format: extension,extension,extension

For example: html,xml.txt

Note: The file types are case sensitive.

4) [hidedirs]

Specify a list of folders (under the root as defined in rootpath item) to be ignored when browsing

for Toko files.

toko.conf Example:

[users]
martin,167477

[settings]

rootpath=/home/user01/public_html/news

extensions=XML,xml,php,htm,html,asp,shtml

[hidedirs]

Images
cgi-bin

Setting Languages

There are 2 types of language support in Toko content editor

1 – GUI language – Supported

only in the PRO version

, which means that you may set your GUI

language, messages and drop down list to your own language.

2 - Multi language support – you may edit any type of page in any language

Multi Language Support

Toko is supporting all languages. The order of languages in the Character set is predefined and is

ordered alphabetically.

Toko Lite Gui

You may see here the list of all the languages we integrated in Toko content manager.

TIP

The first language on the list will be the default one.

Language list

iso-8859-1,English(en),ltr

iso-8859-1,Afrikaans(af),ltr
iso-8859-1,Albanian(sq),ltr

windows-1256,Arabic(war),rtl

iso-8859-6,Arabic(ar),rtl

iso-8859-1,Basque(eu),ltr

iso-8859-5,Bulgarian(bg),ltr

iso-8859-5,Byelorussian(be),ltr
iso-8859-1,Catalan(ca),ltr

gb2312,Simplified Chinese(ch1),ltr

big5-hkscs,Traditional Chinese Hong-Kong(ch2),ltr

big5,Traditional Chinese(ch3),ltr

windows-1250,Croatian(whr),ltr

iso-8859-2,Croatian(hr),ltr
iso-8859-2,Czech(cs),ltr

iso-8859-1,Danish(da),ltr

iso-8859-1,Dutch(nl),ltr

iso-8859-1,English(en),ltr

iso-8859-3,Esperanto(eo),ltr
iso-8859-15,Estonian(et),ltr

iso-8859-1,Faroese(fo),ltr

iso-8859-1,Finnish(fi),ltr

iso-8859-1,French(fr),ltr

iso-8859-1,Galician(gl),ltr

iso-8859-1,German(de),ltr

iso-8859-7,Greek(el),ltr

iso-8859-8,Hebrew(iw),rtl

windows-1255,Hebrew(wiw),rtl

iso-8859-2,Hungarian(hu),ltr
iso-8859-1,Icelandic(is),ltr

iso-8859-10,Inuit(Eskimo),ltr

iso-8859-1,Irish(ga),ltr

iso-8859-1,Italian(it),ltr

shift_jis,Japanese(sja),ltr

iso-2022-jp,Japanese(ija),ltr
euc-jp,Japanese(eja),ltr

euc-kr,Korean(ko),ltr

iso-8859-10,Lapp(lpl),ltr

windows-1257,Latvian(wlv),ltr

iso-8859-13,Latvian(lv),ltr

iso-8859-13,Lithuanian(lt),ltr
windows-1257,Lithuanian(wlt),ltr

windows-1251,Macedonian(wmk),ltr

iso-8859-5,Macedonian(mk),ltr

iso-8859-3,Maltese(mt),ltr

iso-8859-1,Norwegian(no),ltr

iso-8859-2,Polish(pl),ltr
iso-8859-1,Portuguese(pt),ltr

iso-8859-2,Romanian(ro),ltr

iso-8859-5,Russian(iru),ltr

koi8-r,Russian(ru),ltr

iso-8859-1,Scottish(gd),ltr

windows-1251,Serbian(sr),ltr
iso-8859-5,Serbian(sr),ltr

cyrillic,Serbian(sr),ltr

latin,Serbian(latsr),ltr

iso-8859-2,Serbian(latisr),ltr

windows-1250,Serbian(latwsr),ltr
iso-8859-2,Slovak(sk),ltr

windows-1250,Slovenian(wsl),ltr

iso-8859-2,Slovenian(sl),ltr

iso-8859-1,Spanish(es),ltr

iso-8859-1,Swedish(sv),ltr

windows-1254,Turkish(wtr),ltr
iso-8859-9,Turkish(tr),ltr

iso-8859-5,Ukrainian(uk),ltr

utf-8,utf(utf),ltr

Main Screen

Logging In

In order to log in, direct your browser to the location you placed Toko installation.

e.g.

'http://www.domain.com/tokoeditor/'

A screen of logging in will open up.
Enter your user and password as defined in the toko.conf

Note

Login errors are commonly caused by not entering passwords properly. Passwords are case-sensitive,

meaning that Toko is different from TOKO or Toko. If your login fails, check that you are using the

correct case and that your caps-lock button is not in use.

Main Window

Once logged in, you'll be presented with a new screen, on the left hand side of the window and the upper
right side you will find several controls and drop downs to control every aspect of your editor. In the

main portion of the window, there is an empty area that will be filled once you choose a file in the file

drop down list.

NOTE

Definition Manual

Toko definition is easy and fast.
If you wish to give your users the ability to edit different areas on a page you simply add the
tokoeditare tag to your page text.
For example:

<!-- <tokoeditarea> -->

Page text

<!-- </tokoeditarea> -->

NOTE

This area will be shown to all the Toko users that have access to this file.

1 - For a full comparison between Toko Pro and Toko Lite please refer to

http://toko-contenteditor.pageil.net/page002-comparison.shtml

2 – For asking questions via our support forum please fill free to ask at

http://toko-contenteditor.pageil.net/cgi-bin/yabb/YaBB.pl

3 – For Online Help

http://toko-contenteditor.pageil.net/page007OnlineHelp.shtml

Thank You for choosing us …..
Toko Web Services
Authoring & Editing web pages is

Easier

then ever !