Detta dokument beskriver hur du installerar/uppdaterar GTChat.

Mera information på http://www.gtchat.de.

Översikt
Systemkrav
Första installationen
Uppdatera äldre versioner
Ändra forwarding adress
Ändra färger och fonter
Modifiera templates
JavaScript options


Översikt

Vad är GTChat?
GTChat ett snabbt och enkelt webchat program. På grund av användandet av server push teknologi och arbetar utan databas som mySQL används mycket lite server resurser, vilket givetvis inte påverkar snabbheten. Vissa användare har problem med server push p.g.a att dom använder proxy servrar. För dessa användare finns också client pull mode.

Hur mycket kostar GTChat?
GTChat är freeware, och får användas på icke-kommersiella websidor. Däremot är det förbkudet att ändra programkoden (besides JavaScript) (undantaget JavaScript). för mera info läs license.txt.

Hur installerar jag GTChat?
Eftersom du kan läsa denna filen så har du packat upp program- filerna. Nästa steg är:
  • Ersätt filerna i språkpaketet för det språk du vill installera, standardspråket är tyska
  • ladda upp filerna till servern
  • kör programmet install.pl
  • redigera filen index.html så att länken pekar rätt
  • redigera filerna login.html och register.html som anpassning till din hemsida
  • login med användarnamn/lösenord admin, ändra lösenordet meddetsamma, ändra inställningarna, konfigurera rum och chat news
De flesta stegen av ovanstående är förklarade nedan. I denna filen finns även förklaring hur man ändrar utseende på chatten. Du bör använda en editor som kan spara med UNIX radbrytning (d.v.s inte Notepad).

Systemkrav

Krav på servern:
  • UNIX eller UNIX-likt operativsystem
  • Perl 5.005 eller högre
  • Vid körning av chatten i server push mode: ingen time limit för Perl processer (om en process dör, måste användaren logga in igen)
  • Ungefär 2 MB för varje användare (endast en uppskattning för att inte belasta servern)
Krav på klienten:
  • Internet Explorer 4.x eller högre, Netscape Communicator 4.x eller högre.
  • JavaScript aktiverad
  • Vid körning av chatten i server push mode: forwarding av data genom proxy server utan försening. Speciellt AOL proxy servrar som i standard standardläge inte gör detta.
  • Ingen tidsbegränsning för uppkopplingen. Proxy servrar från Mannesmann Arcor har en tidsbegränsning för uppkopplingen, att använda client pull mode rekommenderas.
Första installationen

Skapa katalogen gtchat i din HTML katalog. Kopiera innehållet i katalogen www till katalogen med en FTP klient.

Skapa katalogen gtchat i din cgi-bin katalog. Kopiera innehållet i katalogen cgi-bin till katalogen. Ställ in rättigheterna på filen install.pl med en FTP klient och kör filen från en webbläsare. Programmet ställer in katalogträd och filerättigheter. På vissa servrar går det inte att ställa in dessa automatiskt, följ isåfall anvisningarna i programmet.

Uppdatera äldre versioner

Gör en backup på din chat innan uppdatering.

Följande filer behöver uppdateras:
  • cgi-bin/Sources (hela katalogen)
  • cgi-bin/chat.pl
  • cgi-bin/install.pl (gör den körbar)
  • cgi-bin/english.descr (eller andra språkfiler beroende på språkval)
  • cgi-bin/Ditt valda språk.lng
  • cgi-bin/Templates (hela katalogen, de flesta templates har ändrats sedan version 0.92)
  • www/chat.js
  • www/images/at.gif
  • www/images/msg.gif
  • www/images/question.gif (vid uppdatering från GTChat 0.91)
  • www/commands.html och www/faq.html
Gör install.pl körbar och starta den med en webbläsare, datafilerna kommer då att uppdateras.

Ändra forwarding adress

Varför forwarding? Det rekommenderas att sätta länken till chatten att peka på index.html i din GTChat HTML katalog. denna filen skickar användaren till ett JavaScript. Detta är en kontroll om användaren har JavaScript aktiverad. Om inte stanna användaren på index.html och får ett felmeddelande.

Användaren ska skickas till chat.pl i CGI katalogen. Du bör ändra denna länk i JavaScript delen och i meddelandet.

Ändra färger och fonter

GTChat tillåter modifiering av färger och fonter i filen style.css. här är en lista över CSS-classerna och deras funktioner:
A
A:active
A:hover
Definition av länkar i tabeller (aktiv - aktiv länk, hover - Länk under muspekaren). Icke definierade attribut uppdateras från innehållet på länken. A:besökt bör definieras, men har ingen funktion i chatten?
#stdlink
A#stdlink:active
A#stdlink:hover
Dessa definitioner är för the länkar utanför tabbellerna (aktiv - aktiv länk, hover - Länk under muspekaren). När en template ändras bör taggen id=stdlink till länkar utanför tabellerna ändras enligt detta:

   <a href="fil.html" id=stdlink>

Icke definierade attribut uppdateras från innehållet på länken..
TD
#normaltext
Standard inställningar för länkar i tabeller. #normaltext ska vara samma som TD, används för att forcera formattering av texten om det inte görs automatiskt.
#smalltext Mindre version av TD, använd t.ex för att visa datum i listan för IP-spärrade. Icke definierade attribut tas från TD.
TH Definerar text och bakgrundsfärg på tabellhuvuden.
#table1 Definerar text och bakgrundsfärg i tabeller som behöver ha en framtoning t.ex rumsnamnen på login sidan.
#table2 Standard text och bakgrundsfärg i tabeller.
#lines Ramfärg i tabeller. OBS, attributet Som ställs in är inte färg på ramen utan bakgrundsfärg!
#body Här styrs standardinställningarna för färger och fonter. Alla chatmeddelanden visas i denna färg. Bakgrundsfärgen används i hela chatten. Fungerar endast om du har taggen id=body i alla BODY taggar.
#headertext Standard utseende för all text utanför tabeller. Om du ändrar templates och lägger till text utanför tabellerna skriv enl detta <div id=headertext> </div>.
#bigheadertext Större version av #headertext. Används t.ex. i chat-hjälp filen.

Modifiera templates

Chat templates är vanliga HTML filer, men innehåller vissa taggar som ersätts av chatten. Fyra taggar är universiella och används i alla templates:
{CHATNAME} Ersätts av namnet på chatten anligt definitionen $chatname i Settings.dat (eller allmänna inställningar i Administratörs inställningar), används normalt till namnet på HTML-filerna.
{CGI} Ersätts med URL-adressen till chat.pl, där parametern id redan är inkluderad. Om andra parametrar läggs till måste det skrivas enl:

   {CGI}&action=allusers
{HTMLURL} Ersätts med $htmlurl från Directories.dat. Denna taggen is används i de flesta templates för definition av basadressen enl:

   <base href="{HTMLURL}">

Därför behövs inte den kompletta sökvägen användas i HTMLfilen när den används i en template.
{PULLMODE} Ersätts med 1 om användaren använder client pull läge eller med 0 om användaren valt server push läge.

Alla andra taggar används bara i vissa templates.
VARNING: Alla taggar utom de universiella måste skrivas på samma linje utan mellanslag före eller efter taggen.

Vid installationen av chatten, ska modifiering göras i templates login.html och register.html (logo, välkommen meddelande mm). Om du justerar ramarna i chat.html, ska namnen på ramarna behållas. En detaljerad information av templates och taggar som används kommer kommer snart att publiceras, för uppdaterad information besök http://www.gtchat.de.

JavaScript options

Vid starten av chat.js finns följande variabler definierade:
roomlistdelay
Default: 10000
Fördröjning (i millisekunder) vid visning av rumslistan. Standard templaten visar chatlogon under tiden. Om du inte har någon logo eller vill använda ytterligare en ram sätt denna variabel till 0.
scrolldelay
Default: 150
Intervall (i millisekunder) för scrollningen av text ramen (om den inte blivit avaktiverad av användaren).
aliveinterval
Default: 50000
Endast relevant vid server push mode. Intervall (i millisekunder) vid sändning av /alive kommando för att visa att användaren fortfarande är i chatten. Om servern inte tar emot något från användaren inom $alive_test_rate sekunder, förutsätts att ukopplingen är bruten och användaren kastas ut.
refreshdelay
Default: 6000
Endast relevant för client pull mode. Sätter intervall (i millisekunder) för kontroll efter nya meddelanden. Om servern inte tar emot något från användaren inom $alive_test_rate sekunder, förutsätts att ukopplingen är bruten och användaren kastas ut.

OBS: Nya meddelanden uppdateras när användaren skickar ett inlägg.
logoutpage
Default: ""
Definition av logoutsida istället för login sidan.
autokick
Default: 0
Sätter tiden för hur länge användare är tillåtna att vara inaktiva. Efter denna tid loggas användaren ut automatiskt.
send_blocking_timeout
Default: 15000
För att undvika att inlägg försvinner sänder chat blocks från start till slut (nya inlägg skrivs till en buffert istället för att direkt sändas). Ibland kan läsaren ge error och hindra sändning för att förhindra detta skickas den alltid efter inställd intervall (i millisekunder).
flooding_***
Default:
..._maxnum: 5
..._interval: 5000
..._warnings: 1
..._expireinterval: 600000
Spamm säkring: varje gång en användare sänder flooding_maxnum text i flooding_interval millisekunder, ges en varning. efter flooding_warnings warnings kastas han ur chatten. Efter tiden definierad i flooding_expireinterval (i millisekunders) återställs räknaren till 0. flooding_maxnum=0 eller flooding_interval=0 avaktiverar spamm säkringen, flooding_expireinterval=0 avaktiverar återställningen av räknaren.

Funktionen av chatten är helt beroende av korrekt funktion av dess JavaScript del. Därfö bör ändringar i JavaScripten endast om man har god kunskap om scriptningen. Support finns inte att få för felaktig modifiering av scripten En detaljerad beskrivning av JavaScript functionerna kan komma inom en snar framtid, för mera information besök gärna: http://www.gtchat.de.