Proxy Web Chat v2.76 (c) Averell 2003-2006

=====================================

0) INSTALLATION

Dzipper le fichier dans un dossier contenant une version rcente de mirc (au moins 6.01). Taper /load -rs webchat.mrc .

Voil, c'en est fini pour l'installation!

1) CE QUE C'EST:

P.W.C. n'est ni plus ni moins qu'un service proposant  tout un chacun la possibilit de chatter sur l'irc, sur le ou les serveurs de ton choix, par le biais d'un mini-site web dont tu es l'administrateur. A la diffrence de SmilesView, l'excellent addon de Bub325, ce n'est pas mirc qui visualise la page web: il faut passer par un navigateur.

1B) CE QUE CE *N'EST PAS*

Ce script n'est pas un ircd. Si vous souhaitez inviter des personnes sur votre propre serveur irc hberg sur votre machine, tlchargez-en un. Beaucoup de serveurs tournant sous Windows sont disponibles sur le net: unrealircd, wircd, ircplus, bircd pour ne citer que les plus connus. Si vous ne souhaitez pas vous casser la tte  configurer un ircd, vous pouvez utiliser mon produit le plus connu: mirc script server. Cclui-ci est disponible sur http://mircscriptsfrfm.com/msserver . C'est un serveur irc tournant sous mirc.

Ce script n'est pas non plus un serveur web. Il a t crit spcialement pour le petit site web ddi au tchat disponible dans le dossier Webchat. Si vous voulez avoir un *vrai* serveur web, allez faire un tour sur http://www.apache.org . De la mme manire, on trouve aussi des serveurs web tournant sous mirc sur des sites web ddis au scripting.

2) A QUOI CA SERT

A rien :) Bah nan, je charrie, a a forcment quelque utilit. Par exemple:

- Changer de client irc tout en ne changeant pas de client irc (c'est profond :)

- Permettre aux gens de venir sur ton serveur irc  toi  travers une belle page web qui a un look super-professionnel.

- Te permettre  toi mme de surfer sur irc depuis un poste situ derrire un proxy et n'ayant accs qu'au web. Il faudra alors connecter ton navigateur sur l'ip de ta machine, celle qui tourne chez toi  la maison. Ton PC a alors un rle de bouncer.

3) COMMENT ON S'EN SERT

C'est tout simple: d'abord, tu cherches "Proxy Web Chat" dans le menu commande de mirc, et tu slectionnes "ouvrir serveur".

Ensuite, tu ouvres ton beau Internet Explorer, et tu tapes "http://localhost" ou "http://ton_adresse_ip". Surtout tu ne connectes pas ton mirc, ce n'est pas utile, sauf si tu dsires chatter aussi avec ce logiciel.

Voila: il y a une page d'accueil qui s'affiche, le tchat peut commencer!

4) UNE PAGE WEB SUR MON PC? MAIS D'OU VIENT-ELLE?

Ton mirc s'est transform en serveur web. Serveur d'un genre un peu particulier, certes: un VRAI serveur web ne permettrait pas ce genre de chose; en effet, la caractristique du systeme est que le tchat n'est pas rafrachi toutes les 30s ou toutes les minutes: il fonctionne de manire continue. On obtiendrait un rsultat quivalent avec une applette java, sauf qu'ici, il n'y a pas d'applette java!

5) C'EST QUOI CES SERVEURS IRC ET CES CANAUX POURRIS QU'IL Y A PAR DEFAUT SUR LA PAGE D'ACCUEIL? COMMENT JE PEUX LES CHANGER?

Il vaut mieux aller faire un tour dans la config avant toute chose. Slectionne "Configuration" depuis le menu Commande/WebChat.

La configuration est un fichier texte (config.ini), comme un ircd.conf, qui te permet de changer tout un tas de paramtres:

- La liste des serveurs irc sur lesquels tu souhaites chatter (ou sur lequels tu souhaites faire chatter tes visiteurs)
- La liste des canaux souhaits
- Une liste de slaps rigolos. Je ne sais pas si on peut y mettre des couleurs...
- Une liste de variables (toutes sont configures par dfaut, avec un commentaire dessous). En particulier, tu peux interdire  tes utilisateurs de joindre d'autres canaux que le canal d'accueil (recommand), ou de changer de nick. Tu peux aussi changer le port d'accs web (par dfaut, j'ai videmment mis le port 80).

La configuration par dfaut est la plus souple, mais il vaut mieux la changer, sauf si tu penses tre le seul  t'en servir.

On peut aussi changer le /ctcp version. Pour les frimeurs, j'ai mis en commentaire 2 ctcp version de linux, a fait trop classe :)

La prise en compte des modifications se fait au dmarrage ou au redmarrage du serveur.

6) EH EH! ON VOIT LES COULEURS DE MIRC ET IL Y A DES VRAIS SMILEYS EN IMAGE :)) !

Eh oui hein, c'est du srieux tout a! Il n'y a pas autant de smileys que dans l'addon smilesview (je remercie Bub325 d'ailleurs, a qui j'ai emprunt les quelques images de rigolards que j'utilise)

On peut rajouter des smileys (voir le sous-dossier smiles dans le dossier Webchat)

De la mme manire, l'addon permet de visualiser les couleurs de mirc... C'est d'ailleurs un de ses points forts.

7) JE PEUX CHATTER SUR PLUSIEURS CHANNELS EN MEME TEMPS?

Pas encore prvu dans cette version. Lorsque tu joins un canal, tu sors du prcdent.

8) COMMENT JE PARLE EN PRIVE A QQN?

Depuis la version 2.0, on peut chatter en priv au moyen d'une fentre query, ou avec l'instruction /msg ou /m. Les messages privs vous parviennent au moyen de petites "icnes" sur lesquelles il faut cliquer pour voir les messages. Ce systme est directement inspir de mirc.

9) C'EST STABLE TON AFFAIRE? OU Y A DES BUGS?

J'aimerais dire que ca ne plante pas, car j'ai tout fait pour. L'addon a t test en particulier 10 minutes sur le canal #mp3country d'undernet; c'est un canal  flot continu de messages multicolores assez longs et compliqus. Ca passe a priori.

10) EH! MAIS LES CHATTEURS QUI SE CONNECTENT SUR MON SERVEUR DE CHAT ONT MON HOST ET MON ADRESSE IP SUR IRC!!!

Vu que mirc sert de bouncer, c'est ton mirc qui se connecte, avec ton adresse ip  TOI. Aussi, je te recommande de limiter l'utilisation du systme  un seul canal d'accueil pour le cas o tu souhaiterais rendre ton systme accessible au public.

11) EST-CE QUE PLUSIEURS PERSONNES PEUVENT UTILISER LE SERVEUR EN MEME TEMPS?

En d'autre termes, est-ce que le systme est multi-utilisateur? Eh bien oui, il l'est. La restriction est que, tous les utilisateurs connects  l'irc auront ton host et ton ip. Donc, se mfier des serveurs qui n'acceptent pas les clones (Undernet..).

12) J'AI MON PROPRE SERVEUR IRC! EST-CE QUE LES GENS PEUVENT Y VENIR?

Bien sr! Au cas o ton serveur serait sur la mme machine que WCS, l'adresse de serveur  configurer (config.ini) est localhost:6667 (si le port est 6667). Dans un cas diffrent, il suffit de spcifier l'ip ou le host, comme pour un serveur normal, suivi du port.

13) IL MANQUE DES COMMANDES!!

Oui je sais, toutes les commandes d'irc ne sont pas implmentes; je n'ai pas mis les commandes d'ircop, par exemple. J'ai mis celles que j'ai juges les plus utiles, y compris les commandes d'op.

14) LE DESIGN EST TROP POURRAVE!! JE PEUX LE MODIFIER?

Tu peux modifier les pages web  ta convenance, en faisant attention aux variables utilise (les descripteurs spciaux sont prcds d'un signe dollar, comme $nick ou $canal). Si tu arrives  faire un super design qui pte, contacte-moi.

Personnellement, j'ai repris les pages webs de www.chatsystems.com et je les ai modifies juste pour y mettre ma marque personnelle. J'ai aussi modifi les javascripts d'origine que je ne trouvais pas assez performant (les nicks n'taient pas classs dans la nickliste, en particulier).

Enfin dans la version 1.6 j'ai rajout des couleurs dans les menus (listes html) qui sont configurables par les variables adquates.

15) CA LAGGUE QUAND JE JOINS UN GROS CANAL!

C'est le problme des javascripts qui travaillent beaucoup lorsque la liste des utilisateurs est consquente. Si tu veux absolument avoir accs  un gros canal (plus de 200 ou 300 personnes) tu peux configurer la variable $listenicks = non (par dfaut, elle est gale  oui)

16) PEUT-ON VOIR LES LOGS?

Il y a une fentre de log temps rel en icne, qu'il ne faut pas fermer. Ce log n'est pas stock dans un fichier. En revanche, il y a un dossier contenant les logs de toutes les conversations (y compris messages privs, notices etc.) Ce dossier gonfle assez rapidement.

Enfin, il y a la possibilit de logguer TOUTES les requtes web dans un fichier log.txt  condition de configurer la variable $logs = oui dans le config.ini . Vala :)

17) C'EST QUOI CE MESSAGE: PAge 404: /default.ida ( xx.xx.xx.xx ) AVEC UNE LIGNE TRES TRES LONGUE DESSOUS?

Ah tu as a aussi toi :) C'est un virus appel Code Red II qui inspecte les adresses ip au hasard et recherche les serveurs web microsoft IIS pour les infecter. N'aie crainte, ce serveur-l n'est pas microsoft, et tu ne risques rien.

18) JE N'AI PAS VU DE DLLs. OU SONT ILS?

Il n'y en a pas. Je sais pas faire les dlls :)

19) POURQUOI NE PAS AVOIR FAIT UNE VRAIE APPLETTE JAVA PLUTOT QUE CE TRUC COMPLIQUE?

Le java n'est pas ma tasse de th, et je ne voulais pas ripper une applette dj existante (j'en ai quelques exemplaires qui marchent). De plus, je m'tais donn comme challenge de trouver le "truc" d' Internet Chat Systems (www.chatsystems.com), lequels me narguent depuis 1998:  ma connaissance ce sont les seuls  faire, jusqu' ce jour, ce systme de chat web temps rel sans java.

20) POURQUOI CERTAINS CHATTEURS ONT ILS DES PROBLEMES AVEC LE SYSTEME?

Mon systme a t test avec Internet Explorer 6 en local (connect  mon ip). Certains navigateurs peuvent rpondre diffremment. De plus, si votre navigateur est situ derrire un proxy ou un routeur, il peut arriver que les choses ne se passent pas comme prvu: les formulaires ne sont pas posts, ou alors la page "gle" et on ne peut dfinitivement plus se connecter au chat. Personnellement ca m'est arriv; je suis dsol, je n'ai pas les moyens d'avoir un routeur pour tester si le systme fonctionne dans tous les cas.

21) J'AIME PAS LES MESSAGES DU CHAT. JE PEUX LES CHANGER?

Oui tu le peux, la totalit des messages du tchat est stocke dans un fichier messages.ini que tu peux modifier,  condition de respecter l'ordre des messages et la syntaxe (j'utilise des quantificateurs $1, $2-, etc. qui ont la mme fonction que les quantificateurs de mirc).

22) CE SERAIT PAS MIEUX UNE VERSION CONFIGURABLE EN DIALOG PLUTOT QUE DE MODIFIER UN FICHIER TEXTE COMME ON FAISAIT AVANT AU 20 SIECLE?

Oui surement. Mais moi et les dialogs, ca fait deux :)

Support technique: Averell ( webmaster@mircscriptsfrfm.com )

REMERCIEMENTS A
===============

Internet Chat Systems tout d'abord: accessible en http://www.chatsystems.com, l'addon que tu as entre les mains reproduit assez fidlement leur systme, sauf que le leur marche aussi sous Netscape grrrmblblblbl...

Dixroue: pour m'avoir fourni des ides, le code de l'identd et le code du transfert de fichier binaire

Armaggedon: cyberpote que j'ai foutrement emmerd, et qui m'a aussi donn des ides

Kotake, alias ati2000, pour ses bonnes ides

|-LiNk-| : pour les bannires de pub de mircscriptsfrfm

Arn0: Beta testeur distant malgr lui :)

L'quipe de www.scriptsdb.org en gnral, pour leurs critiques positives de la premire version de ce travail

et ....


a Toi, cher utilisateur de cette chose bizarre dont on peut bien se demander  quoi cela pourra bien servir, vu que mirc est quand mme bien plus pratique :)

