Integration of WBOSS into CommuniGate Pro

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

Joshua Cantara jcantara@grappone.com
Chriss Hobbs chobbs@silvervalley.k12.ca.us
Adam Sleight adams@linearcorp.com

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

Setting Up CommuniGate Pro
Installing WBOSS
Configuring compose.wssp
Conclusion

Setting Up CommuniGate Pro

mkdir /var/CommuniGate/cgi-bin
chown root:mail /var/CommuniGate/cgi-bin
chmod 770 /var/CommuniGate/cgi-bin

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

Navigate to the following page: Settings
Navigate to the following sub-page: WebUser
CGI Directory: /var/CommuniGate/cgi-bin
File Extension pl
Program to Start: /usr/bin/perl

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:

rpm -qal | grep ispell
rpm -qal | grep aspell (if you wish to use aspell instead of ispell) (recommended)

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:

perl -e "use IPC::Open3;"

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:

mv spell.txt spell.pl
mv spell.pl /var/CommuniGate/cgi-bin

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>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.