_____________________________________________

txtForum 0.7.6 (24.Mai.2005)
(C) [GPL] 2001-2005 Lauri Kasvandik
_____________________________________________

txtForum - võimas tekstifailidel töötav foorum.

Sisukord
========
1. Võimalused
2. Paigaldamine
3. Uuendamine (upgrade)
4. Nipid
5. Kontakt


1. Võimalused
=============

+ töötab harilike tekstifailidel PHP piiratud versioonis (Safe Mode)
  (töötab kui PHP.ini-s on konfigureeritud register_globals=on ja 
  samuti ka kui register_globals=off, vt. Nippe).
+ kategooriad: kui on defineeritud ainult üks kategooria siis foorum 
  näitab automaatselt selles kategoorias olevaid postitusi, kui aga
  on rohkem kategooriaid siis näidatakse kategooriate nimekirja.
+ paindlik kasutajate süsteem: administraator, moderaator, kasutaja
+ mallid - disaini muutmine on äärmiselt lihtne, kasutajad saavad
  Profiilist foorumi kujundust vahetada.
+ administraatrori liides postituste kustutamiseks, muutmiseks, liigutamiseks
  teise kategooriasse. Foorumi seadeid (veebikoha nimi, vaikimisi keel ja 
  -mall) & kategooriate seadeid saab muuta veebiliidese kaudu. Foorumi 
  administraatoril on võimalus teemasid lukustada/taasavada ning muuta
  püsivaks ja tagasi harilikuks. Foorumi sõnumeid/seadistusi saab 
  arhiveerida tar ja gzip formaatidessse.
+ moderaator saab liigutada, muuta ja kustutada kõiki postitusi
+ kasutajad saavad kustutada ning muuta enda tehtud postitusi.
+ võimalik kasutada erinevaid keeli, kasutaja saab eelistatava keele valida
  Profiili alt
+ BBKood
+ smailid ning postituste ikoonid
+ kõik emailid krüpteeritakse, nii on spam-bottidel raskem leida
+ online kasutajate loendamine (näidatakse palju on külastajaid ning palju
  registreeritud kasutajaid, viimaseid näidatakse nimeliselt)


2. Paigaldamine
===============

txtForum nõuab veebiserberilt php4 tuge, kusjuures register_globals peab olema "ON"
(tavaliselt ongi; kui ei ole siis selle liigutuse peaks tegema kaasapandud .htaccess 
fail).


0. Paki arhiiv txtforum-xxx.zip lahti (jälgi et kataloogid säiliksid)
1. Saada failid PHP-d toetavasse serverisse
2. CHMOD-i* andmekataloog (vaikimisi "./tf.data/") 777-le
3. Mine lehele forum.php, loo administraatori konto ning defineeri kategooria(d).
4. See ongi kõik!

* failiõigusi saab muuta ftp-programmiga (harilikult paremklõps failil/kataloogil 
  ning valida avanenud menüüst CHMOD) või Internet Exploreriga (asukohareale
  ftp://kasutaja:parool@zone.ee paremklõps failil/kataloogil ning avanenud menüüst 
  valida Properties ning märkida kas kõik märkeruudukesed (so. õigused 777) või 
  ainult lugemise ja kirjutamisega seotud (666).

Täiendavaid malle (erinevaid kujundusi) on txtForumi jaoks võimalik tõmmata 
aadressilt zone.ee/txtforum/download-addons.php ja keelefaile aadressilt
zone.ee/txtforum/download-addons.php#lang

3. Uuendamine (upgrade)
=======================

Versiooni 0.6.x kasutanutel on võimalus foorumi sõnumid ning kasutajate andmed 
uuemasse formaati üle tuua. Selleks tuleb administraatorina sisse logida, minna
Administraatori paneelile ning valida Upgrade. Seal saab muuta vanade foorumifailide
asukohta ning valida millisesse kategooriasse sõnumid salvestada. Peale valikute
tegemist tuleks vajutada Submit nuppu ning sellega peakski kõik korras olema.

Versioonilt 0.7.0 uuendamine versioonile 0.7.1 mingeid lisaliigutusi ei nõua, piisab
0.7.1 failide serverisse tõstmisest kusjuures olemasolevad failid tuleks ülekirjutada.

4. Nipid
========

* Kui foorum ei tööta korralikult, siis see võib tingitud olla sellest, et
  PHP konfiguratsioonis ei registreerita globaalmuutujaid. Selle vea parandamiseks
  tuleks avada tf.actions.php ning otsida välja rida (see asub üsna faili alguses):

	#register_globals();

  Reaalgusest tuleks eemaldada '#' märk ning peale faili salvestamist peaks foorum 
  jällegi töötama.

* Kas kasutatav server toetab GetImageSize() funktsiooni 'http://'-ga algavatele 
  pildifaili aadressidele? Kui toetab, siis võiks failist tf.conf.php ära muuta
  konstandi 'get_img_size', nii et see oleks selline:
  
	define('get_img_size', true);

  Nii saavad kasutajad lisada avatare nt oma veebilehelt. Vaikimisi on see väärtus
  false ning avatare on võimalik valida ainult kohalikus serverist avataride 
  kataloogist (./tf.img/avatars/) NB. Sinna kataloogi võib pildifaile juurde lisada.

* Kategooriat defineerides saab määrata kas kõik kasutajad saavad teha postitusi ja
  lugeda või ainult registreeritud kasutajad. Võimalik on ka määrata et ainult admin
  saab alustada uut teemat.

* Moderaatori lisamiseks logi administraatorina sisse ning mine liikmete nimekirja
 (forum.php?action=members) ja määra soovitud kasutaja kasutajagrupp moderaatoriks.

* Kui soovid oma veebilehe mõnele teisele lehele nimekirja viimati postitatud 
  foorumiteemadest siis lisa sellele lehele soovitud kohta sellised read:

	<?php
		include('tf.func.php');
		print last_postings(10);
	?>

  Argumendina antud number määrab mitut teemat näidatakse.

* Administraatori paneelil on funktsioon vigastatud kategooriafaili parandamiseks:
  Admin Control Panel -> Categories settings -> Repair Categories File. See eemaldab
  mittevajalikud read ning arvutab postituste/teemade üldarvu iga kategooria jaoks.

* tf.conf.php sisaldab paljusid parameetreid, mida võib muuta: failiteed, sessioonide 
  aegumine, avatari failitüübid & max suurus, mitut teemat näidatakse lehel jpm.

* Smailide lisamise soovi korral piisab kui need kopeerida smailide kataloogi --
  ./tf.img/smileys -- Foorum leiab need automaatselt.

* Kasutaja-staatused (kasutajakirjeldus vastavalt postituste arvule) on vaikimisi
  ingliskeelsed (kuna massiivis ei olnud muutujate kasutamine võimalik). Nende
  staatuste muutmiseks ava tf.conf.php, liigu enam-vähem selle lõppu ning seal on
  massiiv $poster_status. See sisaldab sõnumite vahemikke ning vastavat staatust.
  Neid väärtusi võib tõlkida/muuta kui ka juurde lisada ning eemaldada.

* Vaikimisi määratud smailide muutmiseks tuleb avada tf.conf.php ning otsida sellest
  '$static_smileys'. See massiiv sisaldab emotikone ";-)" koos asendatavate 
  pildifialidega (nt. "wink.gif"). Loomulikult, need vaikimisi smailid võib
  sama nime kandvate failidega üle kopeerida (./tf.img/smileys kataloogist).

* Uute teemaikoonide lisamiseks (või eemaldamiseks) tuleb lisada pildid 
  ./tf.img/topic_icons kataloogi. Foorum leiab need automaatselt.

* Foorum võrdleb registreerimata kasutaja brauseri vaikimisi keelt keelefailide 
  kataloogis olevatega ning kui selles kataloogis kattub mõni fail brauseri vaikimisi
  keelega siis laaditakse see automaatselt. Kui te ei ole sellisest võimalusest 
  huvitatud siis võite failist tf.conf.php muuta check_default_language = false

* Info mallide kohta on toodud failis ./tf.doc/template_howto_et.txt

* Fail ./tf.doc/tech.doc.txt sisaldab infot kõigi 
  txtForumis kasutatud failide formaatide kohta (kasutajatefail, postitustefail, 
  kategooriatefail jne).


5. Kontakt
==========
Küsimused, kommentaarid, bugid - kõik need saada meilile:


Call me!