Embedding SpellChecker Support into UltraBoard
Revision 05-30-2000

 Download these instructions as PDF Document


The SpellChecker.net system provides powerful web based spell and grammar checking with easy set up and integration. Follow the steps to add the specified code into UltraBoard and you will begin reaping the benefits our SpellChecker offers!

To add SpellChecker support to your website, please follow four steps:

  1. Register and receive a Customer ID
  2. Download the customized JavaScript file
  3. Download the SPROXY.CGI script file
  4. Modify the Bulletin Board code


Register and receive a customerID

To register, please go to the
Sign Up page and fill out our short form. We will send you an e-mail containing your customerID. Please save this ID, as it will be required for the rest of the installation.
Top of page



Download the Customized JavaScript File

To download JavaScript file please login to "My Account" Section of the SpellChecker.net site using customerid and password sent to you in the registration email. Click on the "Download JavaScript file" link. In the page opened click "Download" button to download the spch.js JavaScript file (please select "save to Disk" if prompted). 
The JavaScript file contains information that is specific to each customer's web site, so it should not be used on or obtained from another site.

Top of page



Download the SPROXY.CGI Script File

The sproxy.cgi script file is used to return the data corrected by SpellChecker to the text-box on your web page.
Top of page


STEP 1
Download the file "sproxy.cgi". Please login to "My Account" Section of the SpellChecker.net site using customerid and password sent to you in the registration email. Please open "Download SPROXY.CGI script" page for currently supported versions of the file. Click on the "Download SPROXY script" link.
Top of page


STEP 2
Copy the file sproxy.cgi to the directory on your web site that has permissions for script execution (for example /cgi-bin or /scripts). If you downloaded Perl version of sproxy.cgi, open the file in edit mode and change its first line according to your perl interpreter location. This file is created to run on UNIX systems and the first line will be "#!/usr/bin/perl". Windows users should alter this line to reflect the perl location, for example "#!c:/perl/bin/perl.exe" (note the forward slashes).
Top of page



Can I use FTP to upload the sproxy.cgi file to my web site?
(If you have a perl script as the sproxy.cgi file then this information pertains to you.)
If you do choose this method, be sure the entire process is carried out and completed in ASCII Mode.
Top of page



What if my web site is hosted by Linux (Unix)?
No problem, just don't forget to set the files for the attributes of the sproxy.cgi to 755 (chmod 755 sproxy.cgi).

Top of page


Modify the Bulletin Board code

To embed SpellChecker support for the cgi file, please use the following steps:

1  Go to the /cgi-bin directory of your UB and find the files named "ForwardTopic.pl", "NewPost.pl" and "NewReply.pl"

Please create copies of the files before making any changes. You should then open it for editing.

1.1 - ForwardTopic.pl file:

1.1.1

- Go to line #58 and replace it with:

$HTML.="<p>".'<script src="http://your_url/spch.js"></script>' .&Form("UltraBoard.$Ext","POST","","").

your_url should be replaced with the actual url of the folder on your server where you uploaded the spch.js file.

1.1.2

- Go to line #149 and replace it with:

&Table("100%","CENTER","0","0","","").

(Check that this added line is #149)

"<tr>".

(Check that this added line is #150)

&Td("50%","","","","","","","","").

(Check that this added line is #151)

&Button("", "SPELL CHECK", "width:$IETextBoxSize", "onclick=\"var f = document.forms[0]; doSpell( 'LANGUAGE', f.Message, document.location.protocol + '//' + document.location.host + '/CGI_BIN/sproxy.cgi', true);\"").

Here and further replace the following parameters within the code:

LANGUAGE defines the language which will be used by SpellCheck engine. Change this parameter to one of the following values:
"en" - American English
"uk" - British English
"fr" - French
"ge" - German
"it" - Italian
"sp" - Spanish
"dk" - Danish
"br" - Brazilian Portuguese
"nl" -- Dutch
"no" -- Norwegian
"pt" - Portuguese
"se" - Swedish

CGIBIN is the name of your virtual directory that will contain the file sproxy.cgi. Replace this string with your virtual directory name.

(Check that this added line is #152)

"</td>".

(Check that this added line is #153)

&Td("50%","","","","","","","","").

(Check that this added line is #154)

"<center>".&Submit("","FORWARD MESSAGE TO YOUR FRIEND","width:$IETextBoxSize")."</center>".

(Check that this added line is #155)

"</td>".

(Check that this added line is #156)

"</tr></table>".

(Check that this added line is #157)

1.2 - NewPost.pl file:

1.2.1 - Go to line #55 and replace it with:

$HTML.="<p>".'<script src="http://your_url/spch.js"></script>' . &Form("UltraBoard.$Ext","POST","","").

your_url should be replaced with the actual url of the folder on your server where you uploaded the spch.js file.

1.2.2 - Insert the following code AFTER line #226:

&Td("33%","","2","","","","","","").

(Check that this added line is #227)

"<center>".&Button("", "SPELL CHECK", "width:$IETextBoxSize", "onclick=\"var f = document.forms[0]; doSpell( 'LANGUAGE', f.Message, document.location.protocol + '//' + document.location.host + '/ CGIBIN/sproxy.cgi', true);\"")."</center>".

(Check that this added line is #228)

"</td>".

(Check that this added line is #229)

1.2.3 - Go to line #230 and replace it with:

&Td("33%","","2","","","","","","").

1.2.4 - Go to line #233 and replace it with:

&Td("33%","","2","","","","","","").

1.3 - NewReply.pl file:

1.3.1 - Go to line #68 and reply it with:

$HTML.="<p>".'<script src="http://your_url/spch.js"></script>' .&Form("UltraBoard.$Ext","POST","","").

your_url should be replaced with the actual url of the folder on your server where you uploaded the spch.js file.

1.3.2 - Insert the following code AFTER line #198:

&Td("33%","","2","","","","","","").

(Check that this added line is #199)

"<center>".&Button("", "SPELL CHECK", "width:$IETextBoxSize", "onclick=\"var f = document.forms[0]; doSpell( 'LANGUAGE', f.Message, document.location.protocol + '//' + document.location.host + '/ CGIBIN/sproxy.cgi', true);\"")."</center>".

< /FONT >
(Check that this added line is #200)

"</td>".

(Check that this added line is #201)

1.3.3 - Go to line #202 and replace it with:

&Td("33%","","2","","","","","","").

1.3.4 - Go to line #205 and replace it with:

&Td("33%","","2","","","","","","").



Top of page

SpellChecker.net, PO Box 641697, Los Angeles, CA 90064 USA, Tel +1(310) 287-2001 x801, Fax +1(310) 287-2347
© 1999-2007 SpellChecker.net, Inc. All Rights Reserved.