Chat::Envolve - A Perl API for the Envolve web chat system.
version 1.0007
my $chat = Chat::Envolve->new( api_key => $key, ); my $html = $chat->get_tags('Joe'); my $command = $chat->get_login_command('Joe');
This is a Perl API for the Envolve http://www.envolve.com chat system. If you'd like to see it in use, check out The Lacuna Expanse http://www.lacunaexpanse.com. Currently Envolve has not exposed much functionality, but using this API will allow you to have your users automatically logged in/out of the chat based upon their web site logins.
Constructor. Requires both params.
The API key provided by Envolve.
Returns a signed login command string that can be used to log a user into a chat by calling some javascript.
<script type="text/javascript"> env_executeCommand(command_string_goes_here); </script>
If you prefer you can just inline it into the web page using the get_tags method.
get_tags
A string, either the first name of the user, or their alias.
A hash of optional parameters.
A string, the last name of the user.
A url of a picture or avatar for the user.
If set to 1, the user will gain admin privileges, which currently means that if enabled in the Envolve settings they'll be able to create and close chats administratively.
Returns a signed logout command string that can be used to log a user out of a chat by calling some javascript.
If you prefer you can just inline it into the web page using the get_tags method and pass no params to it.
Returns some HTML tags that can be inlined into your web page to start the chat. If no parameters are passed in, then the user will be anonymous. If first_name is passed in then the user will be authenticated.
first_name
See get_login_command
get_login_command
Currently this module doesn't throw any exceptions.
Nothing is planned until Envolve releases more functionality.
Moose MIME::Base64 Digest::HMAC_SHA1 Encode
http://github.com/rizen/Chat-Envolve
http://github.com/rizen/Chat-Envolve/issues
If you want to see this module in use, check out The Lacuna Expanse http://www.lacunaexpanse.com. If you want to learn more about Envolve visit their web site http://www.envolve.com.
JT Smith <jt_at_plainblack_dot_com>
Chat::Envolve is Copyright 2010 Plain Black Corporation (http://www.plainblack.com) and is licensed under the same terms as Perl itself. Envolve and its copyrights and trademarks are the property of Envolve, Inc.
To install Chat::Envolve, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Chat::Envolve
CPAN shell
perl -MCPAN -e shell install Chat::Envolve
For more information on module installation, please visit the detailed CPAN module installation guide.