_____________________________________________
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!