/ScriptServ

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

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

0) INSTALLATION

Dézipper le fichier dans un dossier contenant une version récente 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 différence 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 hébergé sur votre machine, téléchargez-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 tête à 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 spécialement pour le petit site web dédié 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 même manière, on trouve aussi des serveurs web tournant sous mirc sur des sites web dédiés au scripting.

2) A QUOI CA SERT

A rien :) Bah nan, je charrie, ça a forcément 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 même de surfer sur irc depuis un poste situé derrière un proxy et n'ayant accès 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 rôle 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 sélectionnes "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 désires 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 caractéristique du systeme est que le tchat n'est pas rafraîchi toutes les 30s ou toutes les minutes: il fonctionne de manière continue. On obtiendrait un résultat é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. Sélectionne "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 paramètres:

- La liste des serveurs irc sur lesquels tu souhaites chatter (ou sur lequels tu souhaites faire chatter tes visiteurs)
- La liste des canaux souhaités
- Une liste de slaps rigolos. Je ne sais pas si on peut y mettre des couleurs...
- Une liste de variables (toutes sont configurées par défaut, 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'accès web (par défaut, j'ai évidemment mis le port 80).

La configuration par défaut 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 démarrage ou au redémarrage 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 sérieux 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 même manière, 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 prévu dans cette version. Lorsque tu joins un canal, tu sors du précédent.

8) COMMENT JE PARLE EN PRIVE A QQN?

Depuis la version 2.0, on peut chatter en privé au moyen d'une fenêtre query, ou avec l'instruction /msg ou /m. Les messages privés vous parviennent au moyen de petites "icônes" sur lesquelles il faut cliquer pour voir les messages. Ce système 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 compliqués. 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 système à un seul canal d'accueil pour le cas où tu souhaiterais rendre ton système accessible au public.

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

En d'autre termes, est-ce que le système est multi-utilisateur? Eh bien oui, il l'est. La restriction est que, tous les utilisateurs connectés à l'irc auront ton host et ton ip. Donc, se méfier 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 sûr! Au cas où ton serveur serait sur la même machine que WCS, l'adresse de serveur à configurer (config.ini) est localhost:6667 (si le port est 6667). Dans un cas différent, il suffit de spécifier 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 implémentées; je n'ai pas mis les commandes d'ircop, par exemple. J'ai mis celles que j'ai jugées 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 utilisée (les descripteurs spéciaux sont précédés d'un signe dollar, comme $nick ou $canal). Si tu arrives à faire un super design qui pète, contacte-moi.

Personnellement, j'ai repris les pages webs de www.chatsystems.com et je les ai modifiées 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 classés 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 adéquates.

15) CA LAGGUE QUAND JE JOINS UN GROS CANAL!

C'est le problème des javascripts qui travaillent beaucoup lorsque la liste des utilisateurs est conséquente. Si tu veux absolument avoir accès à un gros canal (plus de 200 ou 300 personnes) tu peux configurer la variable $listenicks = non (par défaut, elle est égale à oui)

16) PEUT-ON VOIR LES LOGS?

Il y a une fenêtre de log temps réel en icône, 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 privés, notices etc.) Ce dossier gonfle assez rapidement.

Enfin, il y a la possibilité de logguer TOUTES les requêtes 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 déjà 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 système de chat web temps réel sans java.

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

Mon système a été testé avec Internet Explorer 6 en local (connecté à mon ip). Certains navigateurs peuvent répondre différemment. De plus, si votre navigateur est situé derrière un proxy ou un routeur, il peut arriver que les choses ne se passent pas comme prévu: les formulaires ne sont pas postés, ou alors la page "gèle" et on ne peut définitivement plus se connecter au chat. Personnellement ca m'est arrivé; je suis désolé, je n'ai pas les moyens d'avoir un routeur pour tester si le système 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 stockée 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 même 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 fidèlement leur système, sauf que le leur marche aussi sous Netscape grrrmblblblbl...

Dixroue: pour m'avoir fourni des idées, 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 idées

Kotake, alias ati2000, pour ses bonnes idées

|-LiNk-| : pour les bannières de pub de mircscriptsfrfm

Arn0: Beta testeur distant malgré lui :)

L'équipe de www.scriptsdb.org en général, pour leurs critiques positives de la première 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 même bien plus pratique :)