Envolve is a chat system for any web site. You can use Envolve with any site by simply pasting a little snippet of HTML and Javascript into your site style. However, this macro integrates it with WebGUI so that when your user logs in to WebGUI, they automatically log into the chat as well.

1) To use this, install the macro into your /data/WebGUI/lib/WebGUI/Macro folder.

2) Then add the macro to the "macros" section of your config file:

"Envolve" : "Envolve",

3) Then restart mod_perl.

4) Then you can use the macro on your site like this:

^Envolve(api-key-goes-here);

Replace "api-key-goes-here" with the API key that Envolve gives you when you sign up for their service.

I recommend putting the ^Envolve(); macro directly into your style template just before the closing body tag.