[Phpfreechat-svn] SF.net SVN: phpfreechat: [725] trunk
Status: Beta
Brought to you by:
kerphi
Menu
▾
▴
[Phpfreechat-svn] SF.net SVN: phpfreechat: [725] trunk
|
From: <ke...@us...> - 2006-09-02 20:42:36
|
Revision: 725
http://svn.sourceforge.net/phpfreechat/?rev=725&view=rev
Author: kerphi
Date: 2006-09-02 13:42:09 -0700 (Sat, 02 Sep 2006)
Log Message:
-----------
Now the online documentation is automaticaly packaged by the release script (no more documentation misses).
Modified Paths:
--------------
trunk/misc/tarSource
trunk/src/pfcglobalconfig.class.php
Removed Paths:
-------------
trunk/INSTALL.en
trunk/INSTALL.fr
trunk/README.en
trunk/README.fr
Deleted: trunk/INSTALL.en
===================================================================
--- trunk/INSTALL.en 2006-09-02 20:38:40 UTC (rev 724)
+++ trunk/INSTALL.en 2006-09-02 20:42:09 UTC (rev 725)
@@ -1,298 +0,0 @@
- Install
-
- To install phpFreeChat you need:
-
- * A Web server (Apache, IIS, Xitami ...) with PHP (4 or 5)
- * Write access on the Web server (SSH, FTP, or other)
-
- By default, you don't need a Mysql database because the system uses files
- to store messages and nicknames.
-
- * Quick start
- * Advanced configuration
-
- Quick start
-
- Using the setup (the easy way):
-
- 1. Download phpfreechat-x.x-setup.php[21] (lastest version)
- 2. Upload the setup script on your server into a browsable directory
- (public directory)
- 3. Browse the script with your personnal browser, it should launch a
- setup, then follow the steps !
- Tip: remove the setup when the install is finished for security
- reason.
-
- Using the ziped archives (for those who havn't gzip module in their php):
-
- 1. Download phpfreechat-x.x.zip (or .tar.gz for linux users)[22]
- (lastest version)
- 2. Unzip the archive localy then upload the phpfreechat-x.x directory
- on your server into a browsable directory (public directory).
- Tip: if you have a SSH access I suggesto to untar the archives
- directly on the server usign tar xzf phpfreechat-x.x.tar.gz command.
- 3. Give the write rights to phpfreechat-x.x/data/public and
- phpfreechat-x.x/data/private directories.
- If you are using FTP:
- CHMOD 777 phpfreechat-x.x/data/private
- CHMOD 777 phpfreechat-x.x/data/public
-
- If you are using SSH:
- chmod a+w phpfreechat-x.x/data/*
-
- 4. Browse the phpfreechat-x.x directory with your browser and enjoy !
-
- Now you need surely to customize your chat. You can take a look at the
- example scripts in the phpfreechat-x.x/demo directory.
-
- Here is the minimum script required for your chat to work (inspired from
- demo1):
-
- <?php
-
- require_once "src/phpfreechat.class.php"; // adjust to your own path
- $params["serverid"] = md5(__FILE__); // used to identify the 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>
- <title>phpFreeChat demo</title>
- <?php $chat->printJavascript(); ?>
- <?php $chat->printStyle(); ?>
- </head>
- <body>
- <?php $chat->printChat(); ?>
- </body>
- </html>
-
- Advanced configuration
-
- The chat is usable using the default configuration but a lot of options
- can be tweaked to customize the chat. For exemple, to change the refresh
- speed to 2 seconds, copy/paste this piece of code:
-
- <?php
-
- require_once "src/phpfreechat.class.php"; // adjust to your own path
- $params["serverid"] = md5(__FILE__);
- $params["refresh_delay"] = 2000; // 2000ms = 2s
- $chat = new phpFreeChat($params);
-
- ?>
- [... copy/paste here the above HTML codes ...]
-
- Another example, to set the initial nickname to "guest" (this can be
- useful when the chat is integrated into a portal or a forum which
- provides the login/password), copy/paste this piece of code:
-
- <?php
-
- require_once "src/phpfreechat.class.php"; // adjust to your own path
- $params["serverid"] = md5(__FILE__);
- $params["nick"] = "guest"; // it can be useful to take nicks from a database
- $chat = new phpFreeChat($params);
-
- ?>
- [... copy/paste here the above HTML codes ...]
-
- Now for the full parameters list:
-
- serverid
- This is the only mandatory parameter. It is the chat server id, "its
- IP" (comparable to the server host in IRC) used to identify the
- chat. Two chat must have different serverid. If you don't know what
- to write, just try : $params["serverid"] = md5(__FILE__);
- nick
- If you have already identified the user (forum, portal...) you can
- force the user's nickname here, this will skip the "Please enter
- your nickname" popup.
- Warning : Nicknames must be encoded in UTF-8. For example, if you
- get nicks from a databases where they are ISO-8859-1 encoded, you
- must ocnvert it: $params["nick"] = iconv("ISO-8859-1", "UTF-8",
- $bdd_nickname); (of course, change the $bdd_nickname parameter for
- your needs)
- ("" value by default, means users must choose a nickname when s/he
- connect)
- title
- Used to change the chat title that is visible just above the
- messages list.
- ("My phpFreeChat" by default)
- channel
- Used to create a room. Technicaly this parameter is used to choose
- the data (messages + nicknames) storage destination. For a better
- explaination, see this FAQ entry[23].
- (auto-generated string based on the title parameter by default)
- frozen_nick
- Setting this to true will forbid the user to change his nickname
- later.
- (false value by default)
- max_nick_len
- This is the maximum nickname length, a longer nickname is forbidden.
- ( 15 caracteres by default)
- max_text_len
- This is the maximum message length, a longer message is forbidden.
- ( 250 characters by default)
- refresh_delay
- This is the time to wait between two refreshes. A refresh is a HTTP
- request which asks the server if there are new messages to display.
- If there are no new messages, then a empty HTTP response is returned.
- ( 5000ms = 5s by default)
- timeout
- This is the time of inactivity to wait before to considere to
- disconnecte user (in milliseconds).
- ( 20000ms = 20s by default)
- max_msg
- This is the message history length. When a user connects, he can see
- the history. The number of messages s/he can see is defined by this
- (20 lines by default)
- connect_at_startup
- Setting this to false will oblige user to click on the connect
- button if s/he wants to chat.
- (true value by default, means when the chat web page is open, a
- connection to the chat is automaticaly performed)
- start_minimized
- Setting it to true will start the chat minimized.
- (false value by default)
- height
- Height of the chat area.
- (440px by default)
- width
- Width of the chat area.
- ("" by default, means it's given by the CSS)
- shownotice
- Setting this to 0 will disable nickname change notices and
- connect/disconnect notices. Setting it to 1 will only disable
- connect/disconnect notices. Setting it to 2 will show all notice
- types.
- (2 by default)
- nickmarker
- Setting it to false will disable nickname colorization.
- (true value by default)
- clock
- Setting it to false will hide the date/hour column.
- (true value by default)
- openlinknewwindow
- Setting it to true will add the target="_blank" into parsed links.
- This attribute is used to open the followed link in a new window.
- (true value by default)
- showwhosonline
- Used to show/hide online users at startup.
- (true value by default)
- showsmileys
- Used to show/hide the smiley list at startup.
- (true value by default)
- btn_sh_whosonline
- Used to display or not the showwhosonline button.
- (true value by default)
- btn_sh_smileys
- Used to display or not the showsmileys button.
- (true value by default)
- themeurl
- Used to specify the theme root url (useful for url rewriting)
- (this parameter is automaticaly calculated by default)
- themepath
- The absolute theme directory path. Sub directories must contains
- themes directories.
- (dirname(__FILE__)."/../themes" by default)
- theme
- This parameter specifies which theme this chat will use.
- ("default" by default)
- language
- Used to specify the chat labels language. Accepted values are i18n/*
- sub directories names.
- (by default this is the local server language)
- output_encoding
- Useful to set a sepcific encoding for chat labels. This is really
- useful when the Web page embedding the chat is not UTF-8 encoded.
- This parameter should be the same as the chat web page.
- (UTF-8 by default )
- container_type
- Used to specify the used container. For the moment, only a file
- container has been written but in the future several containers
- (mysql, irc, msn, jabber...) will surely be available.
- ("File" by default)
- server_script_path and server_script_url
- Used to specify the script which will handle asynchronous request.
- Very useful when the chat (client) script is resource consuming (ex:
- forum or portal chat integration). server_script_url must point to
- the server script browable url (useful when using url rewriting).
- (by default these parameters are auto-calculated)
- client_script_path and client_script_url
- Used to specify the script path which display the chat and load
- every JavaScript libraries (the client side). Useful when the php
- configuration is uncommon, this option can be used to force the
- automatic detection process. client_script_url must point to the
- client script browable url (useful when using url rewriting).
- (by default these parameters are auto-detected)
- useie7
- Setting this to false will disable IE7[24] scripts used to improve
- display for the crappy Internet Explorer.
- (true value by default)
- ie7path
- Specify the IE7 path. It's useful if you allready have a IE7 library
- installed and you want to save bytes on your server.
- (dirname(__FILE__)."/../lib/IE7_0_9" by default)
- jspath
- Specify the javascript libraries path (md5, cookie ...).
- (dirname(__FILE__)."/../lib/javascript" by default)
- smartypath
- Specify the Smarty[25] path. It's useful if you allready have a
- Smarty library installed and you want to save bytes on your server.
- (dirname(__FILE__)."/../lib/Smarty-2.6.7" by default)
- usecsstidy
- Setting this to false will disable CSSTidy library, css optimisation
- (output size) will be disabled.
- (false value by default because it make problems on strange server
- configurations)
- csstidypath
- Specify the CSS Tidy[26] library path. It's useful if you allready
- have a Smarty library installed and you want to save bytes on your
- server.
- (dirname(__FILE__)."/../lib/csstidy-1.1" by default)
- xajaxpath
- Specify the xajax[27] path. It's useful if you allready have a xajax
- library installed and you want to save bytes on your server.
- (dirname(__FILE__)."/../lib/xajax_0.2_stable" by default);
- data_private_path
- Used by the filesystem container to store chat data. Used by smarty
- to store compiled templates. Tip: you can optimize your chat
- performances, see this FAQ entry[28].
- (dirname(__FILE__)."/../data/private" by default)
- data_public_path and data_public_url
- This path must be reachable by your web server. IE7 scripts and
- xajax JS compiled scripts will be stored here. data_public_url
- parameter can be specified to help when url rewriting is used.
- (dirname(__FILE__)."/../data/public" by default)
- debug
- For developers, setting it to true will activate logging and
- debuging console.
- (false value by default)
- debugxajax
- For developers, setting it to true will activate xajax js popup used
- to trace communication between client and server during ajax
- requests. Useful to discover hidden bugs like php warnings on a ajax
- request.
- (false value by default)
- prefix
- Used to prefix all javascript functions, css ids and css class in
- order to avoid variables overlaps.
- ("phpfreechat_" by default)
-
- \xA92006 phpFreeChat
-
-
-
---------------------------------------------------------------
-List of References
-
-Document's URL: http://www.phpfreechat.net/install.en.html
-[23] faq.en.html#multiple-channels
-[24] http://dean.edwards.name/IE7/
-[25] http://smarty.php.net/
-[26] http://csstidy.sourceforge.net/index.php
-[27] http://www.xajaxproject.org/
-[28] faq.en.html#tmpfs
-
Deleted: trunk/INSTALL.fr
===================================================================
--- trunk/INSTALL.fr 2006-09-02 20:38:40 UTC (rev 724)
+++ trunk/INSTALL.fr 2006-09-02 20:42:09 UTC (rev 725)
@@ -1,345 +0,0 @@
- Installation
-
- Vous avez besoin de :
-
- * Un serveur Web (apache, IIS ...) avec le module php (4 ou 5)
- * Un acces en \xE9criture sur ce serveur Web (ssh, FTP ou autre)
-
- Par d\xE9faut, vous n'avez pas besoin d'une base de donn\xE9e Mysql car des
- simples fichiers sont utilis\xE9s pour stoquer les informations.
-
- * En avant!
- * Configuration avanc\xE9e
-
- En avant!
-
- Pour les feignants:
-
- 1. T\xE9l\xE9chargez le script d'installation auto-extractible :
- phpfreechat-x.x-setup.php[21] (la derni\xE8re version de pr\xE9f\xE9rence)
- 2. Uploadez le script dans un r\xE9pertoire accessible par votre
- navigateur (r\xE9pertoire publique)
- 3. Lancez votre navigateur et ex\xE9cutez le script d'installation que
- vous venez d'uploader, ceci devrait lancer une interface
- d'installation, suivez alors les \xE9tapes !
- Astuce : supprimez le scripte d'installation une fois termin\xE9 pour
- des raisons de s\xE9curit\xE9.
-
- Pour les utilisateurs avanc\xE9s ou pour ceux qui n'ont pas gzip install\xE9
- sur leur serveur:
-
- 1. T\xE9l\xE9chargez l'archive zip (ou tag.gz pour les utilisateurs linux) :
- phpfreechat-x.x.zip[22] (la derni\xE8re version de pr\xE9f\xE9rence)
- 2. D\xE9compressez l'archive localement et uploadez le r\xE9sultat sur votre
- serveur dans un r\xE9pertoire accessible par votre navigateur.
- Astuce: si vous avez un acc\xE8s SSH, je vous conseil d'uploader
- l'archive tar.gz puis de la d\xE9compresser directement sur le serveur
- avec la commande tar xzf phpfreechat-x.x.tar.gz
- 3. Donnez les droits en \xE9criture aux r\xE9pertoires
- 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/*
-
- 4. Pour terminer : lancez votre navigateur et ouvrez le r\xE9pertoire
- phpfreechat-x.x sur votre serveur !
-
- Vous d\xE9sirez certainement param\xE9trer votre propre chat, pour cela prenez
- exemple sur les scriptes du r\xE9pertoire phpfreechat-x.x/demo.
-
- Voila le script minimum pour que le chat fonctionne (inspir\xE9 de demo1) :
-
- <?php
-
- require_once "src/phpfreechat.class.php"; // pensez \xE0 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>
- <title>phpFreeChat demo</title>
- <?php $chat->printJavascript(); ?>
- <?php $chat->printStyle(); ?>
- </head>
- <body>
- <?php $chat->printChat(); ?>
- </body>
- </html>
-
- Configuration avanc\xE9e
-
- Le chat fonctionne tr\xE8s bien en laissant les param\xE8tres par d\xE9faut mais
- de nombreuses options peuvent \xEAtre r\xE9gl\xE9es. Par exemple, pour changer le
- temps de rafraichissement \xE0 2 secondes (par d\xE9faut 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);
-
- ?>
- [... copiez/coller le code HTML vu plus haut ...]
-
- Un autre exemple: vous souhaitez que vos utilisateur n'entrent pas de
- pseudonymes \xE0 leur arriv\xE9 sur le chat et qu'un pseudo "invit\xE9" leur oit
- assign\xE9 automatiquement (ceci est tr\xE8s utile pour integrer le chat dans
- un forum, un portail ou tout autre syst\xE8me o\xF9 l'utilisateur est d\xE9ja
- authentifi\xE9), 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-\xEAtre r\xE9cup\xE9r\xE9 depuis une base de donn\xE9es
- $chat = new phpFreeChat($params);
-
- ?>
- [... copiez/coller le code HTML vu plus haut ...]
-
- Maintenant voyons la liste exaustive des param\xE8tres :
-
- serverid
- C'est leur seule param\xE8tre obligatoire. C'est l'identifiant du chat,
- "son IP" (comparable \xE0 l'adresse (host) d'un serveur IRC) utilis\xE9
- pour diff\xE9rencer ce chat d'un autre. Deux chats doivent avoir des
- serverid diff\xE9rents. Si vous ne savez pas quoi mettre, ceci
- fonctionnera dans la majorit\xE9 des cas : $params["serverid"] =
- md5(__FILE__);
- nick
- Ce param\xE8tre est tr\xE8s utile si vous connaissez \xE0 l'avance les
- pseudonymes des utilisateurs, par exemple si vous souhaitez int\xE9grer
- le chat \xE0 un forum ou a un portail qui poss\xE8de d\xE9j\xE0 un syst\xE8me
- d'authentification. Il suffit de renseigner le pseudonyme de
- l'utilisateur concern\xE9 dans cette option et l'utilisateur sera alors
- automatiquement connect\xE9 avec son pseudonyme, il n'aura pas \xE0
- choisir son pseudo lors de la premi\xE8re connexion.
- Attention : Les pseudonymes doivent \xEAtre encod\xE9s en UTF-8. Si par
- exemple vos pseudo viennent d'une base de donn\xE9e o\xF9 ils sont encod\xE9s
- en ISO-8859-1, vous devez les convertir : $params["nick"] =
- iconv("ISO-8859-1", "UTF-8", $bdd_nickname); (bien sur changez la
- variable $bdd_nickname \xE0 votre convenance)
- Remarque : Cette option peut-\xEAtre utilis\xE9e conjointement \xE0 l'option
- frozen_nick pour emp\xEAcher l'utilisateur de changer de nom.
- ("" par d\xE9faut, signifie que les utilisateurs doivent choisir leur
- pseudonymes quand ils se connectent)
- title
- Permet de changer le titre du chat, c'est \xE0 dire le texte qui
- s'affiche en haut.
- ("My phpFreeChat" est la valeur par d\xE9faut)
- channel
- Permet de cr\xE9er un salon. Techniquement, ce param\xE8tre permet de
- choisir o\xF9 vont \xEAtre stock\xE9s les messages et les pseudonymes du
- chat. Pour une explication plus d\xE9taill\xE9es voyez le paragraphe
- suivant[23] dans la FAQ.
- (par d\xE9faut, il est calcul\xE9 automatiquement \xE0 partir du title)
- frozen_nick
- Mettre cette option \xE0 true va tout simplement emp\xEAcher les
- utilisateurs de changer leur pseudonymes. Cela sous entends que le
- pseudonyme \xE0 \xE9t\xE9 automatiquement assign\xE9 (voir l'option nick)
- (false par d\xE9faut)
- max_nick_len
- C'est la longeur maximale que peut avoir un pseudonyme
- (15de caract\xE8res par d\xE9faut)
- max_text_len
- C'est la longeur maximale que peut avoir un message.
- ( 250 caract\xE8res par d\xE9faut)
- refresh_delay
- Ceci est le temps \xE0 attendre entre chaque rafrechissements. Un
- rafrechissement correspond \xE0 une requete HTTP demandant au serveur
- si il y a quelque chose de nouveau \xE0 afficher ou pas. S'il n'y a
- rien de nouveau alors la r\xE9ponse HTTP est vide.
- ( 5000ms = 5s par d\xE9faut)
- timeout
- Ceci est le temps d'inactivit\xE9 \xE0 attendre avant de d\xE9connecter un
- utilisateur (en millisecondes).
- ( 20000ms = 20s par d\xE9faut)
- max_msg
- Ceci est la taille de l'historique, c'est \xE0 dire le nombre de
- messages gard\xE9s en m\xE9moire. Quand un utilisateur se connect, il voit
- automatiquement les messages de l'historique. Le nombre de messages
- qu'il voit est d\xE9finit par ce param\xE8tre
- (20 lignes par d\xE9faut)
- connect_at_startup
- Mettre cette option \xE0 false obligera les utilisateurs \xE0 cliquer sur
- l'icone de connexion pour tchater.
- (true par d\xE9faut, signifie que les utilisateurs sont automatiquement
- connect\xE9s lorsque la page du chat est ouverte)
- start_minimized
- Mettre cette option \xE0 true minimizera le chat au premier chargement
- de la page.
- (false par d\xE9faut)
- height
- Hauteur de la zone de chat
- (440px par d\xE9faut)
- width
- Largeur de la zone de chat
- ("" par d\xE9faut, signifie que la valeur est assign\xE9es dans les CSS)
- shownotice
- Trois valeurs sont possibles : 0 pour ne rien afficher (ni les
- notices de connexion/deconnexion, ni les changements de pseudo), 1
- pour afficher seulement les changements de pseudo, 2 pour afficher
- les changements de pseudo et les connexions/deconnexions.
- (2 par d\xE9faut)
- nickmarker
- Mettre cette option \xE0 false d\xE9sactivera la colorisation des
- pseudonymes.
- (true par d\xE9faut)
- clock
- Mettre cette option \xE0 false d\xE9sactivera l'affichage de la date et de
- l'heure.
- (true par d\xE9faut)
- openlinknewwindow
- Mettre cette option \xE0 true permettra d'ouvrire les liens des
- convertations dans une nouvelle fen\xEAtre. Techniquement cela rajoute
- l'attribut target="_blank" dans la balise du lien.
- (true par d\xE9faut)
- showwhosonline
- Permet de cacher/montrer la liste des utilisateurs connect\xE9s lors du
- premier affichage du chat.
- Utilisez btn_sh_whosonline pour d\xE9sactiver compl\xE8tement la
- possibilit\xE9 de voir la liste des pseudonymes.
- (true par d\xE9faut)
- showsmileys
- Permet de cacher/montrer la liste des smileys lors du premier
- affichage du chat.
- Utilisez btn_sh_smileys pour d\xE9sactiver compl\xE8tement la possibilit\xE9
- de voir la liste des smileys.
- (true par d\xE9faut)
- btn_sh_whosonline
- Permet de cacher ou montrer le bouton showwhosonline (celui qui
- permet de cacher/montrer la liste des pseudonymes)
- (true par d\xE9faut)
- btn_sh_smileys
- Permet de cacher ou montrer le bouton showsmileys (celui qui permet
- de cacher/montrer la liste des smileys)
- (true par d\xE9faut)
- themeurl
- Permet de sp\xE9cifier l'url \xE0 utiliser pour acceder aux themes (tr\xE8s
- utile pour la r\xE9\xE9criture d'url)
- (ce param\xE8tre est automatiquement calcul\xE9 en fonction de themepath
- themepath
- Le chemin vers les themes. Les sous r\xE9pertoires sont les diff\xE9rents
- thems disponibles.
- (dirname(__FILE__)."/../themes" par d\xE9faut)
- theme
- Ce peram\xE8tre permet de sp\xE9cifier quelle theme utiliser. La liste des
- themes possible sont les nom des sous r\xE9pertoires de themepath.
- ("default" par d\xE9faut)
- language
- Permet d'afficher le chat dans une langue donn\xE9e. Les valeurs
- possibles sont les nom des sous r\xE9pertoires de i18n.
- (par d\xE9faut la langue est celle du serveur qui h\xE9berge le chat)
- output_encoding
- Permet de sp\xE9cifier l'encodage \xE0 utiliser pour afficher les labels.
- Concretement ce param\xE8tre doit correspondre \xE0 l'encodage de la page
- Web contenant le chat.
- (par d\xE9faut UTF-8, c'est \xE0 dire aucun transcodage car les messages
- sont stoqu\xE9s en UTF-8 par d\xE9faut)
- container_type
- Permet de sp\xE9ficier le conteneur \xE0 utiliser. Pour le moment, seul le
- conteneur File (syst\xE8me de fichier) est disponible mais dans le
- future de nombreux conteneurs existerons surrement (mysql, irc, msn,
- jabber...).
- ("File" par d\xE9faut)
- server_script_path et server_script_url
- Ces param\xE8tres permettent de sp\xE9cifier un script externe qui sera
- charg\xE9 des communication client/serveur du chat. Ce param\xE8tre est
- tr\xE8s utile lorsque le script du chat (client) consomme beaucoup de
- ressources (voyez la demo3 pour un exemple concret). Le premier
- param\xE8tre sp\xE9cifie l'endroit du fichier lui m\xEAme, le second
- param\xE8tre indique l'url o\xF9 est situ\xE9 le fichier (utile pour la
- r\xE9\xE9criture d'url)
- (par d\xE9faut on utilise le m\xEAme scripte que le script client pour les
- communications)
- client_script_path et client_script_url
- Ces param\xE8tres sont utilis\xE9s pour sp\xE9cifier le chemin du script qui
- va afficher le chat (script client). Ces options peuvent \xEAtre utile
- lorsque la configuration du serveur est peu commune. Le premier
- param\xE8tre sp\xE9cifie l'endroit du fichier lui m\xEAme, le second
- param\xE8tre indique l'url o\xF9 est situ\xE9 le fichier (utile pour la
- r\xE9\xE9criture d'url)
- (par d\xE9faut pfc va essayer d'auto-detecter le script client en
- fonction des variables globales du serveur)
- useie7
- Mettre ce param\xE8tre \xE0 false d\xE9sactivera l'ajout des scripts IE7[24]
- permettant un meilleur affichage dans Internet Explorer.
- (true par d\xE9faut)
- ie7path
- Sp\xE9cifie le r\xE9pertoire vers la librairie IE7. Ce param\xE8tre est utile
- si vous avez d\xE9j\xE0 install\xE9 une librairie smarty et que vous voulez
- \xE9conomiser des octets sur votre serveur.
- (dirname(__FILE__)."/../lib/IE7_0_9" par d\xE9faut)
- jspath
- Sp\xE9cifie le r\xE9pertoire vers les librairies javascript (md5, cookie
- ...).
- (dirname(__FILE__)."/../lib/javascript" par d\xE9faut)
- usecsstidy
- Mettre ce param\xE8tre \xE0 false d\xE9sactivera l'utilisation de la
- librairie CSSTidy utilis\xE9e pour optimiser (en taille) la g\xE9n\xE9ration
- des CSS.
- (false par d\xE9faut car sur certains serveur la librarie CSSTidy pose
- des probl\xE8mes)
- csstidypath
- Sp\xE9cifie le r\xE9pertoire vers la librairie CSS Tidy[25]. Ce param\xE8tre
- est utile si vous avez d\xE9j\xE0 install\xE9 une librairie csstidy et que
- vous voulez \xE9conomiser des octets sur votre serveur.
- (dirname(__FILE__)."/../lib/csstidy-1.1" par d\xE9faut)
- xajaxpath
- Sp\xE9cifie le r\xE9pertoire vers la librairie xajax[26]. Ce param\xE8tre est
- utile si vous avez d\xE9j\xE0 install\xE9 une librairie xajax et que vous
- voulez \xE9conomiser des octets sur votre serveur.
- (dirname(__FILE__)."/../lib/xajax_0.2_stable" par d\xE9faut)
- data_private_path
- Ce r\xE9pertoire est utilis\xE9 pour stoqu\xE9 les donn\xE9es du chat ainsi que
- les templates compil\xE9s de smarty. Astuce: vous pouvez optimisez les
- performances cot\xE9 serveur en sp\xE9cifiant un r\xE9pertoire en m\xE9moire
- vive (RAM disk, tmpfs), voyez cette section dans la FAQ[27].
- (dirname(__FILE__)."/../data/private" par d\xE9faut)
- data_public_path et data_public_url
- Ce r\xE9pertoire doit \xEAtre imp\xE9rativement accessible par votre serveur
- Web. Les scripts IE7 et xajax necessaires au chat y seront stock\xE9s.
- Le premier param\xE8tre indique le r\xE9pertoire absolue au niveau syst\xE8me
- de fichier, et le second indique l'url pour y acceder depuis le
- navigateur (utile pour la r\xE9\xE9critude d'url)
- (dirname(__FILE__)."/../data/public" par d\xE9faut, data_public_url lui
- est calcul\xE9 automatiquement)
- debug
- Cette option est tr\xE8s utile pour les d\xE9veloppeurs. La mettre \xE0 true
- va activer les messages de log et la console de debug.
- (false par d\xE9faut)
- debugxajax
- Cette option est tr\xE8s utile pour d\xE9couvrire les bug cach\xE9s (warning
- php lors d'une requete xajax par exemple) . Mettre cette option \xE0
- true va activer les popup javascript de xajax pour tracer la
- communication client/serveur.
- (false par d\xE9faut)
- prefix
- Ce prefix est utilis\xE9 pour chaques fonctions javascript, chaque id
- CSS et chaques classes CSS de fa\xE7on \xE0 \xE9viter les recouvrements de
- variables entre phpfreechat et votre site web.
- ("phpfreechat_" par d\xE9faut)
-
-
-
- \xA92006 phpFreeChat
-
-
-
---------------------------------------------------------------
-List of References
-
-Document's URL: http://www.phpfreechat.net/install.fr.html
-[23] faq.fr.html#multiple-channels
-[24] http://dean.edwards.name/IE7/
-[25] http://csstidy.sourceforge.net/index.php
-[26] http://www.xajaxproject.org/
-[27] faq.fr.html#tmpfs
Deleted: trunk/README.en
===================================================================
--- trunk/README.en 2006-09-02 20:38:40 UTC (rev 724)
+++ trunk/README.en 2006-09-02 20:42:09 UTC (rev 725)
@@ -1,64 +0,0 @@
-phpFreeChat, a free, simple, fast and customizable chat server
-
- Simple
- You only have to copy/paste 3 lines of code[21] to have a nice
- working chat.
- No need to configure a database (Mysql), messages and nicknames are
- stored in files.
- No problems with firewalls, this script is based on HTTP so you only
- need a web browser and an internet connection. (everyone can easily
- chat!)
- No problems with none-latin characteres ! Are you Russian, Japanese,
- Turk, Chinese, or Arabic? Whatever language you speak, phpfreechat
- will nicely display your characters because it uses XML with UTF8 to
- encode characters.
- Fast
- AJAX technology is used to smoothly refresh (no flicker) and display
- the chat and nickname zone.
- Messages and nicknames are stored into a simple filesystem, so that
- server resources are saved as much as possible.
- Bandwidth is preserved because the server never transmits the same
- data twice, only new messages are transmitted.
- Customizable
- You can write your own customized CSS stylesheets, to completely
- change the appearance[22] of your chat.
- All chat functionalities are customizable. For example, you can
- change the messages refresh time, you can ban users for changing
- their usernames, etc.
- The plugin system[23] allows you to write your own storage routines.
- For example, you can write a plugin to store the conversations into
- your database.
- Opensource
- phpFreeChat is an opensource (LGPL) program, so that you can freely
- use it and modify it.
- I just ask, by gratitude, to keep the linkback logo on the pages of
- your chat.
-
- All phpFreeChat commands are inspired by the irc[24] protocol, and its
- interface is inspired by mIRC[25] and XChat[26], so that users won't be
- disoriented.
-
- Techonologies used by phpFreeChat are:
-
- * PHP[27] : on the server side : conversations are simply stored in
- filesystems.
- * XAJAX[28] : for the asynchronous communication between the client
- and the server
-
- (phpFreeChat does NOT require MySQL, or any SQL database)
-
- \xA92006 phpFreeChat
-
-
---------------------------------------------------------------
-List of References
-
-Document's URL: http://www.phpfreechat.net/overview.en.html
-[22] customize.en.html#cust-css
-[23] customize.en.html#container-plug
-[24] http://www.irc.org
-[25] http://www.mirc.com/
-[26] http://www.xchat.org/
-[27] http://www.php.net/
-[28] http://www.xajaxproject.org/
-
Deleted: trunk/README.fr
===================================================================
--- trunk/README.fr 2006-09-02 20:38:40 UTC (rev 724)
+++ trunk/README.fr 2006-09-02 20:42:09 UTC (rev 725)
@@ -1,67 +0,0 @@
-
-phpFreeChat un serveur de chat libre, simple, rapide et param\xE9trable
-
- Simple
- Vous avez seulement 3 lignes de php \xE0 copier/coller[21] dans la page
- de votre choix pour obtenir un chat fonctionnel.
- En effet, pas besoin de param\xE9trer une base de donn\xE9e Mysql, les
- conversations sont stock\xE9es simplement dans des fichiers.
- Le chat fontionnera chez tout le monde car il est bas\xE9 sur HTTP, il
- vous suffit donc d'avoir un navigateur Web connect\xE9 \xE0 internet pour
- pouvoir chatter.
- Tous les jeux de caract\xE8res sont support\xE9s ! Que vous soyez Russe,
- Japonais, Turque, Chinois, ou Arabe, tous les caract\xE8res
- s'afficheront car phpfreechat utilise XML coupl\xE9 \xE0 UTF8 pour encoder
- les caract\xE8res.
- Rapide
- La technologie AJAX est utilis\xE9e pour afficher p\xE9riodiquement et
- sans effets de clignotement les nouveaux messages et les nouvelles
- personnes connect\xE9es.
- Les conversations sont stock\xE9es dans des fichiers, les ressources du
- serveur sont donc \xE9conomis\xE9es au maximum.
- La bande passante est \xE9conomis\xE9e car le serveur ne transmettra
- jamais deux fois les m\xEAmes informations : seulement les nouveaux
- messages sont transmis.
- Param\xE9trable
- Vous pouvez \xE9crire vos feuilles de style (CSS) personnalis\xE9es pour
- changer compl\xE8tement l'apparence[22] de votre chat.
- Toutes les fonctionnalit\xE9s du chat ont \xE9t\xE9 rendues param\xE9trables.
- Par exemple, vous pouvez changer le temps de mise \xE0 jour des
- messages, vous pouvez interdire aux utilisateurs de changer leur
- pseudo...
- Vous pouvez \xE9galement, gr\xE2ce au syst\xE8me de plugin[23], \xE9crire vos
- propres routines de stockage si vous pr\xE9f\xE9rez stocker les
- conversations dans votre base de donn\xE9es.
- Libre
- phpFreeChat est d\xE9velopp\xE9 en opensource (LGPL), vous pouvez donc
- librement utiliser le programme et le modifier.
- Je demande juste, par gratitude, de ne pas enlever la signature logo
- sur les pages de votre chat.
-
- Toutes les commandes de phpFreeChat sont inspir\xE9es du protocole irc[24],
- et son interface est inspir\xE9e de mIRC[25] et XChat[26], vos utilisateurs
- ne seront donc pas d\xE9pays\xE9s.
-
- Les technologies utilis\xE9es par phpFreeChat sont :
-
- * php[27] : pour le cot\xE9 serveur, les conversations sont simplement
- enregistr\xE9es dans des fichiers
- * xajax[28] : pour la communication asynchrone entre le client et le
- serveur
-
- (phpFreeChat n'utilise PAS mysql)
-
- \xA92006 phpFreeChat
-
-
---------------------------------------------------------------
-List of References
-
-Document's URL: http://www.phpfreechat.net/overview.fr.html
-[22] customize.fr.html#custo-css
-[23] customize.fr.html#container-plug
-[24] http://www.irc.org
-[25] http://www.mirc.com/
-[26] http://www.xchat.org/
-[27] http://www.php.net/
-[28] http://www.xajaxproject.org/
Modified: trunk/misc/tarSource
===================================================================
--- trunk/misc/tarSource 2006-09-02 20:38:40 UTC (rev 724)
+++ trunk/misc/tarSource 2006-09-02 20:42:09 UTC (rev 725)
@@ -8,6 +8,20 @@
rm -rf ./$NAME
svn export .. ./$NAME
rm -rf ./$NAME/contrib
+echo "-> downloading documentation"
+wget http://www.phpfreechat.net/pages/fr/install.html -q -O ./$NAME/INSTALL.fr.html
+wget http://www.phpfreechat.net/pages/en/install.html -q -O ./$NAME/INSTALL.en.html
+wget http://www.phpfreechat.net/pages/fr/faq.html -q -O ./$NAME/FAQ.fr.html
+wget http://www.phpfreechat.net/pages/en/faq.html -q -O ./$NAME/FAQ.en.html
+wget http://www.phpfreechat.net/pages/fr/overview.html -q -O ./$NAME/OVERVIEW.fr.html
+wget http://www.phpfreechat.net/pages/en/overview.html -q -O ./$NAME/OVERVIEW.en.html
+wget http://www.phpfreechat.net/pages/ar/overview.html -q -O ./$NAME/OVERVIEW.ar.html
+wget http://www.phpfreechat.net/pages/es/overview.html -q -O ./$NAME/OVERVIEW.es.html
+wget http://www.phpfreechat.net/pages/zh/overview.html -q -O ./$NAME/OVERVIEW.zh.html
+wget http://www.phpfreechat.net/pages/fr/customize.html -q -O ./$NAME/CUSTOMIZE.fr.html
+wget http://www.phpfreechat.net/pages/en/customize.html -q -O ./$NAME/CUSTOMIZE.en.html
+wget http://www.phpfreechat.net/pages/fr/changelog.html -q -O ./$NAME/CHANGELOG.fr.html
+wget http://www.phpfreechat.net/pages/en/changelog.html -q -O ./$NAME/CHANGELOG.en.html
echo "-> creating checkmd5.php file"
./checkmd5 ./$NAME ./$NAME/checkmd5.php
Modified: trunk/src/pfcglobalconfig.class.php
===================================================================
--- trunk/src/pfcglobalconfig.class.php 2006-09-02 20:38:40 UTC (rev 724)
+++ trunk/src/pfcglobalconfig.class.php 2006-09-02 20:42:09 UTC (rev 725)
@@ -391,24 +391,25 @@
$this->errors[] = _pfc("'%s' parameter is not valid. Available values are : '%s'", "language", implode(", ", $lg_list));
// install the proxy file
- $proxyfile = $this->_getProxyFile();
- $allowedpath_string = "";
- $allowedpath_string .= "\$allowedpath[] = '".realpath(dirname(__FILE__)."/../lib")."';\n";
- $allowedpath_string .= "\$allowedpath[] = '".realpath(dirname(__FILE__)."/../src/client")."';\n";
- $allowedpath_string .= "\$allowedpath[] = '".realpath($this->themepath_default)."/..';\n";
- $allowedpath_string .= "\$allowedpath[] = '".realpath($this->themepath_default)."';\n";
- $allowedpath_string .= "\$allowedpath[] = '".realpath($this->themepath)."/..';\n";
- $allowedpath_string .= "\$allowedpath[] = '".realpath($this->themepath)."';\n";
- $proxycontent = file_get_contents(dirname(__FILE__)."/client/proxy.php.tpl");
- $proxycontent = str_replace("//%allowedpath%", $allowedpath_string, $proxycontent);
- if (!file_exists(dirname($proxyfile)))
- mkdir(dirname($proxyfile));
- if (file_exists($proxyfile) &&
- !is_writable($proxyfile))
- $this->errors[] = _pfc("'%s' must be writable", $proxyfile);
- else
+ if (count($this->errors) == 0)
{
- file_put_contents($proxyfile, $proxycontent);
+ $proxyfile = $this->_getProxyFile();
+ $allowedpath_string = "";
+ $allowedpath_string .= "\$allowedpath[] = '".realpath(dirname(__FILE__)."/../lib")."';\n";
+ $allowedpath_string .= "\$allowedpath[] = '".realpath(dirname(__FILE__)."/../src/client")."';\n";
+ $allowedpath_string .= "\$allowedpath[] = '".realpath($this->themepath_default)."/..';\n";
+ $allowedpath_string .= "\$allowedpath[] = '".realpath($this->themepath_default)."';\n";
+ $allowedpath_string .= "\$allowedpath[] = '".realpath($this->themepath)."/..';\n";
+ $allowedpath_string .= "\$allowedpath[] = '".realpath($this->themepath)."';\n";
+ $proxycontent = file_get_contents(dirname(__FILE__)."/client/proxy.php.tpl");
+ $proxycontent = str_replace("//%allowedpath%", $allowedpath_string, $proxycontent);
+ if (!file_exists(dirname($proxyfile)))
+ @mkdir(dirname($proxyfile));
+ if (file_exists($proxyfile) &&
+ !is_writable($proxyfile))
+ $this->errors[] = _pfc("'%s' must be writable", $proxyfile);
+ else
+ @file_put_contents($proxyfile, $proxycontent);
}
// load smileys from file
This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.
|
