Integration of WBOSS into CommuniGate Pro

An overview of using WBOSS in conjunction with CommuniGate Pro's built in cgi handler.


Joshua Cantara
Chriss Hobbs
Adam Sleight

Last Revised: Febuary 22, 2002


Summary

This will instruct you in how to integrate WBOSS into CommuniGate Pro, running it from communigate, as opposed to from a separate Apache/mod_perl based web server.

Index

  1. Setting Up CommuniGate Pro
  2. Installing WBOSS
  3. Configuring compose.wssp
  4. Conclusion

Setting Up CommuniGate Pro

Log in as root.  Execute the following commands at a root prompt:

Log into CommuniGate's administration port, and follow the below instructions

Installing WBOSS

For Redhat 7.2 I had to install the following rpms (libtool-libs, pspell, aspell) which can be found on Redhat 7.2 disc one, or on www.rpmfind.net.
You may already have them. Verify if you do or not by running the following at a root prompt:

If you have perl 5.6.0 or above you should have IPC::Open3; already installed. Verify by running the following at a root prompt: If that returns you to a command prompt without any @INC errors, it is installed correctly. Alternatively you can find the module installed in /usr/lib/perl5/5.6.0/IPC/Open3.pm

Now download the WBOSS script, and execute the following at a root prompt:

Configuring compose.wssp

In compose.wssp make the following changes:

Add the text that is in bold:
<BODY BGCOLOR="#ffffff" LINK="#330099 ALINK="#330099" VLINK="#330099" onLoad="document.mail.Body.focus()">
<FORM action="Compose.wssp" method="post" enctype="multipart/form-data" name="mail">

Add your SpellCheck button somewhere on your compose page...location is up to you:

<input type="button" name="SpellCheck" value="SpellCheck" onclick="sendtext()">

Near the bottom of compose.wssp html between the lines:
</FORM><!--%%INCLUDE "Navigation.wssi"-->
and
</BODY>

Insert the following: (You should first copy this into a plain text editor, otherwise the html will be scrambled)


<form id="spell" name="spell">
   <script>
   function sendtext() {
   var semi = new RegExp("\;","g");
   document.send.checkme.value = (document.mail.Body.value.replace(semi,"\;"));
   document.send.form.value = "mail";
   document.send.field.value = "Body";
   window.open('','SpellChecker','width=480,height=360,top=150,left=150,scrollbars=1,location=true');
   document.send.submit();
   }
   </script>
   </form>
   <form id="send" name="send" action="/cgi-bin/spell.pl" method="POST" target="SpellChecker">
   <input type="hidden" id="checkme" name="checkme" value="">
   <input type="hidden" id="form" name="form" value="">
   <input type="hidden" id="field" name="field" value="">
   <input type="hidden" id="spell" name="spell" value="check">
   </form>

Conclusion

After the previous steps have been completed, log in and flush the web skins cache for the all domain names. Log in and try out your new spell checker, if all has gone as planned, everything should work perfectly.