I. Introduction

Preamble

uniLETIM was originally created as internet application designed to an administration of LETS group and by the later requests also for TimeBank administration. When you use or prepare to use this application, probably you know what is LETS or TimeBank. If not, you can find more informations here.

uniLETIM enables administration of users, collecting and sorting of offers and queries and recording of performed services. The application works in the internet browser environment. It enables displaying of informations on the screen or printer-compatible formating. Application works in three modes:

1. LETS - multi-user mode
2. Time Bank
3. LETS - single-user mode

LETS - multi-user mode enables administration of data, announces or service records for all members. This mode is suitable to use in the internet environment, where every user can access to his data and modify them. In the Time Bank there is usually one administrator, who serves data inserting and creating of outputs. For that needs it was created a mode for installation on a single local computer without network connection. That mode is usable also for LETS groups, where the majority of members does not have access to internet.

Programming language:

• the application is written in PHP language, by which the server generates HTML pages with outputs

The application is available in two versions:

1. uniLETIM-standalone
2. uniLETIM-full

uniLETIM-standalone package contains just a single uniLETIM application. This version is usable for internet server or single computer, which has installed an http-server with PHP and MySQL support.

uniLETIM-full package contains also the installation batch files for Microsoft Windows operating system and it is determinated for single computer, which is not connected to internet and does not have a http-server with PHP and MySQL installed. This package is advisable for users, who do not have experiences with installation of that applications and which need just install the complete application environment by one click.

uniLETIM-full instalation contains:

• uniLETIM - application PHP scripts
• PHP 4 - enables the running of PHP scripts on the server
• Apache HTTP Server - www-server
• mySQL - database which saves the data used by uniLETIM

Apache+PHP+mySQL installation is based on PHPtriad project. You can read about the license terms for Apache HTTP server, PHP and mySQL on tu.

This application is "free software", which is referred to General public license GNU. The freedom means that it is freely distributable (with source code), and you can freely modify and use it's content in another programs (if they are also distributed under GNU/GPL). It enables free sharing of knowledges and effort outcomes between the software creators, which creates social relations based on cooperation more than on competition. By the way it is also the target of LETSystems and TimeBanks creating.

We did not find any application with comparable features of use.

Informations of project on internet

uniletim.sourceforge.net

uniLETIM project home page

www.sourceforge.net/projects/uniletim

Informations about current status of project, installation packages, source code files, documentation and another usable data.

Files to download

sourceforge.net/project/showfiles.php?group_id=66618

Current version of application - installation files

Source code files available via CVS (Concurrent Versions System)
Warning: the installation from source code files could work unperfectly, because the new features from developers are implemented here. On the other side this version may contain many new features or bugs resolved.

Mailing-lists

uniletim-announce@lists.sourceforge.net

Announces of new versions of application and any news connected with a project.

uniletim-devel@lists.sourceforge.net

Mailing-list for developers. If you want to help to creating and improving of uniLETIM application, you can subscribe this conference.

uniletim-users@lists.sourceforge.net

Mailing-list for users. You can ask the questions connected with application use and share your experiences with another users.

You can subscribe this mailing-lists on this address: http://sourceforge.net/mail/?group_id=66618.

II. Basic informations

System requirements

uniLETIM-standalone:
requirements for PHP scripts running:

• webserver with PHP ver. 4 or higher (for example Apache, IIS, PWS, Sambar)
• mySQL database

uniLETIM-full:
Webserver and mySQL are included into installation and they have this requirements to the system:

• Pentium 75 MHz and higher
• 32 MB RAM (64 MB recommended)
• Windows 95, 98, Me, NT, 2000, XP

What and how to download

Current version of application and updating of older versions:

sourceforge.net/project/showfiles.php?group_id=66618

III. Installation

1. Installation of application

You can run the uniLETIM installation by starting the "uniletim-full-X.XX.exe" file (where XX is a number of current version), which is on the installation CD.

1. Choose the language of the installation dialogs from the menu and click the "OK" button.
2. Read the license and if you aggree with it's content, click the "Aggree" button.
3. Choose the parts of the application, which should be installed.
   The "uniLETIM program files" checkbox must be checked if you want to use the program.
   You can leave the "Server and database" checkbox unchecked if you have an older version of the program installed and you just want to update it.
   You can leave the "Links in startmenu" checkbox unchecked if you do not want to start the program from start menu.
   We recommend to let both checkboxes checked. Click to "Install" button.
   An automatic installation process will start and after finishing the "finished" message will be displayed on the status bar. Click the "Show details" to show the installation process details.
4. Click the "Close" button.
5. The installed uniLETIM application will start.

2. Updating

You can update the program to the newest version by starting of update file with highest number (for example: "uniletim-update-0.92b.exe"), which you can find here:

sourceforge.net/project/showfiles.php?group_id=66618

Choose the language of the installation dialogs and click the "Install" button. After the updating process click the "Close" button.

IV. Usage

1. Group creating

After the first starting of the program (after installation) the form for the new group creating will be displayed. It is necessary to insert all required data (name of the group, kind of group, group administrator user name, password, password confirmation).

If you want to create another group, start the"C:\Program Files\uniletim\install.bat" file.

uniLETIM program enables to administrate more exchange groups independently. Every new group needs different name.

Time Bank

When you create a TimeBank group, you will not have a possibility to set a price in the announces. The price will be set just in the paying order and will be determinated in hours. This kind of group is determinated to use on a local computer. All functions connected to uniLETIM usage in the TimeBank mode are enable just for one user - an administrator.

LETS

The members of the LETS groups can determinate the price of their offered goods and services in the LETS currency. In the filling of the paying order the inserted price will be also determinated in the LETS currency.

• single-user mode
  is suitable for the applications, where one person - the administrator of the group - will execute all operations.
• multi-user mode
  is sutiable for the applications, where more persons with their own identity will access to the data. In this mode every member of the lets-group can access to his data, administrate his announces and personal data, submit his paying orders, read the announces, the list of members and the realized payments. The administrators can also create new sections, subsections and accounts for new members.

Every group has at least one administrator (look at group types higher). Insert your user (login) name and a password. Confirm the password. You will need your user name and password for the work with uniLETIM.

(logging in)

2. Running

The uniLETIM program will be started by clicking on the "uniLETIM icon on your desktop or by start-menu:
"Start/Program Files/uniLETIM/uniLETIM vX.XX" (where X.XX is a number of the current version).

You can also start the program via file manager (for example Explorer) by starting the
"C:\Program Files\uniletim\uniletim.bat" file.

If you want to connect to the program from another computer in your local network, you have to insert "http://xxx.xxx.x.x/uniletim/" address to the internet browser, where xxx.xxx.x.x (for example 192.168.1.1) is an IP address of the computer (usually the server), where the uniLETIM program is installed.
You can find out it in "Control panels - Net - TCP/IP protocol - Properties" on that computer.

3. Logging in

Submit your name and password. If it is more groups administrated on your computer, after the submitting of the name and the password the member's group will be displayed.

4. Administration

Sections

Section (for example Services) is a group of subsections (for example Cleaning up, Care). New announces are insertable only into existing subsections and every subsection must be contained by some section.

1. Choose the item "Sections" from the ADMINISTRATION menu.
2. Write the name of the section in the form called "New section".
3. Press ENTER or click to the "Create" button.
   The message about successfull creating of the section will be displayed and the new section will be showed in the list of sections.

1. Choose the item "Sections" from the ADMINISTRATION menu.
2. Go to "Change section", find a section which you would like to rename and click to it's name.
3. Change the name of the section.
4. Press ENTER or click to the "Change" button.
   The message about successfull renaming of the section will be displayed and the new name of the section will be showed in the list of sections.

Only a section, which does not contain any subsections nor announces, can be deleted. If you want to delete the section or subsection, which contains announces, you have to move it to another section (subsection) or delete it.

1. Choose the item "Sections" from the ADMINISTRATION menu.
2. In the list of sections in the "Change sections" part find the section which contains a subsection which you want to delete and click to "Delete" button.
3. Confirm the deleting of the subsection in the system window.
   The message about successfull deleting of the subsection will be displayed and the deleted subsection will disappear from the list of subsections.

Note: You can also administrate the sections and subsections by clicking to "Change" in the header of list of announces.

Subsections

Subsections enables a collecting of more announces with similar topic. Every subsection must be situated in some section. It is easier and faster to orientate in the announces sorted to the subsections.

1. Choose the item "Sections" from the ADMINISTRATION menu.
2. In the "Change sections" part find the section, in which you want to create a new subsection and click to "Subsections" button.
3. Insert the name of the new subsection into the form in the "New subsection" part.
4. Press ENTER or click to "Create" button.
5. The message about successfull creating of the subsection will be displayed in the list of subsections.

Note: You can create a subsection without name and then you can use it to place the announces, which are not placed to any subsection.

1. Choose the item "Sections" from the ADMINISTRATION menu.
2. In the list of sections in the "Change sections" part find a section, in which you want to rename a subsection and click to "Subsections" button.
3. Find the subsection, which you want to rename, in the "Change subsections" part, and click to it's name.
4. Change the name of the subsection.
5. Click to "Change" button.
6. The message about successfull renaming will be displayed.

Just the subsection, which does not contain any announces, can be deleted. If you want to delete a subsection, which contains announces, you must move them to another subsections or delete them first.

1. Choose the item "Sections" from the ADMINISTRATION menu.
2. In the list of sections in the "Change sections" part find a section includes the subsection which you want to delete and click the "Delete" button.
3. The system window will be displayed, click the "Yes" button to confirm deleting of subsection.
4. The message about successfull deleting of the subsection will be displayed and deleted subsection will disapear from the subsection list.

5. Users

Users of the uniLETIM programm we can divide into two groups: administrator and members. Each group must have one administator and it can have optional number of members. Administrator is also a member. The administrator administrates announcements, sections and subsections, member list and payments. Administrator can provide to members: current reports of payments and list of members and announcements. In the LETS - multi-user mode can users administrate their own annoucements, data and payments and also print the reports.

New user

User is a person who is registrated by administrator as the member of the group. User can publish and change his announcements and realize his payments.

1. Choose the item "New user" from the MEMBERS menu.
2. Fill the data about the new member. Only obligatory data is "User name". Next data are optional (in the LETS - multi-user mode is needed to insert also user pasword).
3. Click the button "Create"
4. The message about succesful creating of the new user will be displayed. There will be also displayed the user card.

The new user can be added by clicking on "New user" button in member list. Choose item MEMBERS/Members -> New user.

Administrator can add, change and delete the announcements, edit the personal data, add and view user's payments. (In the LETS - multi-user mode administrator can change status of the member (User - Group Administrator - Main Administrator)).

User list

The list of all users of the group will be displayed by clicking the "Members" button in MEMBERS menu.

Members list can be sorted by the User name, First name, Last name or by Account state by clicking on the relevant title in the header of the member list.
Click the "New user" button to add new member.
If click the "Print" button there will be displayed the report from the member list in the new window which includes telephone and email contacts and current account states in printable format.

Information about the user

Click the User name of member in the member list.
The card of the member will be displayed. On this card there can be changed user´s personal data, administrated the payments and annoncementsna or can be changed the administrator password (on the administrator card).

Note: To view information about user click the User name anywhere in the application (except of printing reports).

Changing the user data

Display the user card (according to previous steps). Click the "Change data" button on the user card to change all user personal data which system includes. Click the "Change password" button on the administrator card to set and confirm the new password of group administrator.

Deleting the user

1. Click the "MEMBERS" button in the page header.
2. Click the "Delete" button in the line where is the user who will be deleted.
3. Confirm deleting of the user.

6. Announcements

Announcement includes the information about demand or supply of user who published the announcement. Programm provides possibility to administrator to add, edit, view and delete announcements of all group members.

Viewing announcements

To display all announcements (in all sections and subsections) click on empty line under the section list in "ANNOUNCEMENTS" menu or click the "ANNOUNCEMENTS" button in the page header.

Choose the title of section you want to view in "ANNOUNCEMENTS" menu.
All subsection annoncements of this section will be displayed in the order as were inserted.
To view announcements in groups sorted by subsection click the "All" button in the fourth line of the page.

Click the subsection title you want to view which is placed under the section title. The list of subsection which belong to chosen section will be displayed.

Click the "Announcement" button on the user card. The announcements of chosen user will be displayed.

Programm uniLETIM provides possibility to search announcement according to key word.
Display the page with the announcement list. Insert the key word in the last line of the page, choose the section in which you want to search and choose the time allocation.
Click th "Search" button.

The annoncements which include the key word will be displayed.
It doesn't make any difference to use capitals in key word and the key word can be also only the part of the word.

You can also search all announcemets in certain time allocation.

Adding the announcement

1. The way 1:
2. Choose the item "New announcement" from the "ANNOUNCEMENTS" menu.
3. Insert the text of the annoncement, choose the user who publishing the annoncement, choose the subsection, choose the time allocation (time perion in which will the announcement valid - if you select e.g. "week" after this time the annoncement automatically disapear. Choose the item "demand" or "supply" in the next field and click the "Insert" button.

1. The way 2:
2. Display the announcemets of the section in which you want to add a new announcement. (from the "ANNOUNCEMENTS" menu e.g.: ANNOUNCEMENT/Services).
3. Click the "Insert" button in the last line of the field Demand or field Supply.
4. Insert the data valid for the new announcement in the same way like in the point 1.
5. The message about the succesfull inserting of the new announcement and also the form for the inserting of next announcement to the same section will be displayed. If you want to insert annoncement to the other section click the "New announcement" button in the "ANNOUNCEMENTS" menu.

Changing the annoncement

1. Display the card of the user , who published the announcement you want to change.
2. Click the blue title "Annoncements" on the bottom of the page.
3. Find the announcement you want to change and click the "Change" button.
4. Change the announcement text, choose the subsection or the character of the announcement (demand/supply).
5. Click the "Change" button.

Deleting the announcement

1. Display the card of the user who published the announcemet you want to delete.
2. Click the blue title "Annoncements" on the bottom of the page.
3. Find the announcement you want to delete and click the "Delete" button.
4. Confirm the deleting.

7. Payments

Viewing the payments

Payments are realized in the determinated currency valid for the current group. Each payment transfers certain number of units from the account of the user who receives some service or product (payer) to the account of the user who provides this service or product (recipient).

You can show the viewing of the payments by clicking to "Payments" in the menu. The payments will be shown for ten items per page sorted by the time of the transaction realization. You can show the older transactions by clicking the page number on the bottom of the screen. When you click the member's name, you will see his personal informations. You can click the "Transaction" to realize the paying order.

Paying orders

The paying order is a form, where you can set the provider, the recipient, the number of units and the service, for which the payment is realized. After the filling of the form the inserted number of units will be moved from the recipient account to the provider account.

I am sorry, this manual is not finished.