Vous avez besoin de :
safe_mode=On
semble poser des problèmes dans certains
cas)Par défaut, vous n'avez pas besoin d'une base de donnée Mysql car des simples fichiers sont utilisés pour stoquer les informations.
Pour les feignants (ne fonctionne pas avec les versions 1.x) :
Astuce : supprimez le scripte d'installation une fois terminé pour des raisons de sécurité.
Pour les utilisateurs avancés ou pour ceux qui n'ont pas gzip installé sur leur serveur:
Astuce: si vous avez un accès SSH, je vous conseil d'uploader
l'archive tar.gz puis de la décompresser directement sur le serveur avec
la commande tar xzf phpfreechat-x.x.tar.gz
phpfreechat-x.x/data/public
et
phpfreechat-x.x/data/private
Si vous utilisez FTP, voici les commandes:
CHMOD 777 phpfreechat-x.x/data/private CHMOD 777 phpfreechat-x.x/data/public
Si vous utilisez SSH, voici les commandes:
chmod a+w phpfreechat-x.x/data/*
phpfreechat-x.x
sur votre serveur !Vous désirez certainement paramétrer votre propre chat, pour cela prenez
exemple sur les scriptes du répertoire phpfreechat-x.x/demo
.
Voila le script minimum pour que le chat fonctionne (inspiré de demo1) :
<?php require_once "src/phpfreechat.class.php"; // pensez à ajuster le chemin $params["serverid"] = md5(__FILE__); // permet d'identifier ce chat $chat = new phpFreeChat($params); ?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <title>phpFreeChat demo</title> <?php $chat->printJavascript(); ?> <?php $chat->printStyle(); ?> </head> <body> <?php $chat->printChat(); ?> </body> </html>
Le chat fonctionne très bien en laissant les paramètres par défaut mais de nombreuses options peuvent être réglées. Par exemple, pour changer le temps de rafraichissement à 2 secondes (par défaut c'est 5 secondes), voila ce qu'il faut faire :
<?php require_once "src/phpfreechat.class.php"; // ajustez le chemin $params["serverid"] = md5(__FILE__); $params["refresh_delay"] = 2000; // 2000ms = 2s $chat = new phpFreeChat($params); ?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <title>phpFreeChat demo</title> <?php $chat->printJavascript(); ?> <?php $chat->printStyle(); ?> </head> <body> <?php $chat->printChat(); ?> </body> </html>
Un autre exemple : vous souhaitez que vos utilisateur n'entrent pas de pseudonymes à leur arrivé sur le chat et qu'un pseudo "invité" leur oit assigné automatiquement (ceci est très utile pour integrer le chat dans un forum, un portail ou tout autre système où l'utilisateur est déja authentifié), voila ce qu'il faut faire :
<?php require_once "src/phpfreechat.class.php"; // ajustez le chemin $params["serverid"] = md5(__FILE__); $params["nick"] = "guest"; // ce pseudo peut-être récupéré depuis une base de données $chat = new phpFreeChat($params); ?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html> <head> <meta http-equiv="content-type" content="text/html; charset=utf-8" /> <title>phpFreeChat demo</title> <?php $chat->printJavascript(); ?> <?php $chat->printStyle(); ?> </head> <body> <?php $chat->printChat(); ?> </body> </html>
Ces deux exemples ont permis de comprendre l'utilisation du tableau de paramètres, maintenant voyons la liste exaustive des paramètres que vous pouvez utiliser :
serverid
serverid
différents. Si vous ne savez pas quoi mettre,
ceci fonctionnera dans la majorité des cas :
$params["serverid"] = md5(__FILE__);
nick
$params["nick"] = iconv("ISO-8859-1",
"UTF-8", $bdd_nickname);
(bien sur changez la variable
$bdd_nickname à votre convenance)Remarque : Cette
option peut-être utilisée conjointement à l'option
frozen_nick
pour empêcher l'utilisateur de changer de
nom.
(""
par défaut, signifie que les utilisateurs doivent
choisir leur pseudonymes quand ils se connectent)
title
("My phpFreeChat"
est la valeur par défaut)
channel
(par défaut, il est calculé automatiquement à partir du
title
)
frozen_nick
true
va tout simplement empêcher
les utilisateurs de changer leur pseudonymes. Cela sous entends que le
pseudonyme à été automatiquement assigné (voir l'option
nick
)
(false
par défaut)
max_nick_len
(15de
caractères par défaut)
max_text_len
( 250
caractères par défaut)
refresh_delay
( 5000
ms = 5s par défaut)
timeout
( 20000
ms = 20s par défaut)
max_msg
(20
lignes par défaut)
quit_on_closedwindow
/quit
lorsque l'utilisateur ferme sa fenêtre (ne
fonctionne pas sour Firefox). Ce paramètre n'est pas a true par
défaut car sous IE, Safari et Konqueror : lorsque l'utilisateur
recharge sa fenêtre le même évenement est envoyé ce qui surcharge
de messages le chat.
(false
par défaut)
focus_on_connect
true
permet de placer le curseur
directement dans la zone de saisie du chat après la connexion. Il peut
être intéressant de passer ce paramètre à false lorsque l'on
intégre le chat dans un site Web car lorsque le focus change, la vue
de l'utilisateur dans la fenêtre change aussi, elle suit le focus.
Lorsque la page est grande la bar de scroll peut alors se déplacer de
façon involontaire.
(true
par défaut)
connect_at_startup
false
obligera les utilisateurs
à cliquer sur l'icone de connexion pour tchater.
(true
par défaut, signifie que les utilisateurs sont
automatiquement connectés lorsque la page du chat est ouverte)
start_minimized
true
minimizera le chat au
premier chargement de la page.
(false
par défaut)
height
(440px
par défaut)
width
(""
par défaut, signifie que la valeur est assignées
dans les CSS)
shownotice
(3
par défaut)
nickmarker
false
désactivera la
colorisation des pseudonymes.
(true
par défaut)
clock
false
désactivera l'affichage de
la date et de l'heure.
(true
par défaut)
openlinknewwindow
true
permettra d'ouvrire les
liens des convertations dans une nouvelle fenêtre. Techniquement cela
rajoute l'attribut target="_blank"
dans la balise du lien.
(true
par défaut)
showwhosonline
Utilisez btn_sh_whosonline
pour désactiver
complètement la possibilité de voir la liste des pseudonymes.
(true
par défaut)
showsmileys
Utilisez btn_sh_smileys
pour désactiver complètement
la possibilité de voir la liste des smileys.
(true
par défaut)
btn_sh_whosonline
(true
par défaut)
btn_sh_smileys
(true
par défaut)
themeurl
(ce paramètre est automatiquement calculé en fonction de
themepath
themepath
(dirname(__FILE__)."/../themes"
par défaut)
theme
themepath
.
("default"
par défaut)
language
i18n
.
(par défaut la langue est celle du serveur qui héberge le chat)
output_encoding
(par défaut UTF-8, c'est à dire aucun transcodage car les messages sont stoqués en UTF-8 par défaut)
container_type
File
(système de fichier) est disponible
mais dans le future de nombreux conteneurs existerons surrement (mysql,
irc, msn, jabber...).
("File"
par défaut)
server_script_path
et server_script_url
(par défaut on utilise le même scripte que le script client pour les communications)
client_script_path
et client_script_url
useie7
false
désactivera l'ajout des
scripts IE7 permettant un
meilleur affichage dans Internet Explorer.
(true
par défaut)
ie7path
(dirname(__FILE__)."/../lib/IE7_X_X"
par défaut)
jspath
(dirname(__FILE__)."/../lib/javascript"
par défaut)
usecsstidy
false
désactivera l'utilisation
de la librairie CSSTidy utilisée pour optimiser (en taille) la
génération des CSS.
(false
par défaut car sur certains serveur la librarie
CSSTidy pose des problèmes)
csstidypath
(dirname(__FILE__)."/../lib/csstidy-X.X"
par
défaut)
xajaxpath
(dirname(__FILE__)."/../lib/xajax_X.X"
par défaut)
data_private_path
(dirname(__FILE__)."/../data/private"
par défaut)
data_public_path
et data_public_url
(dirname(__FILE__)."/../data/public"
par défaut,
data_public_url
lui est calculé automatiquement)
debug
true
va activer les messages de log et la console de debug.
(false
par défaut)
debugxajax
true
va activer les popup javascript de xajax
pour tracer la communication client/serveur.
(false
par défaut)
prefix
("pfc_"
par défaut)