Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alagu/hummingbird
Hummingbird is a opensource embeddable chat system. One line embed in your website with adium/pidgin support
https://github.com/alagu/hummingbird
Last synced: about 1 month ago
JSON representation
Hummingbird is a opensource embeddable chat system. One line embed in your website with adium/pidgin support
- Host: GitHub
- URL: https://github.com/alagu/hummingbird
- Owner: alagu
- License: mit
- Created: 2012-12-15T07:50:19.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2014-10-01T10:21:42.000Z (about 10 years ago)
- Last Synced: 2024-08-01T22:53:48.873Z (4 months ago)
- Language: JavaScript
- Homepage: alagu.github.com/hummingbird/
- Size: 322 KB
- Stars: 122
- Watchers: 17
- Forks: 23
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-starred - alagu/hummingbird - Hummingbird is a opensource embeddable chat system. One line embed in your website with adium/pidgin support (others)
README
Hummingbird
================
Tried building my own version of Olark. Jabber and Strophe.js helped me. ( **Previously known as Opensource Olark** )
This can add popup on any window and admins can chat using Jabber clients (adium, etc).
It doesn't have any auth mechanism built it, but it can be added easily using the auth.py file.
[**TRY DEMO**](http://alagu.github.io/hummingbird/)
=============
**Warning: There is no ACL added here. But it is easy to add**
Installation
=============
Requirements
------------
Works in Ubuntu 11.04+
Install eJabberd
----------------
```
sudo apt-get install ejabberd
git clone git://github.com/alagu/hummingbird.git
cd hummingbird
sudo -s
cp server/setup/auth.py /etc/ejabberd/
```
Edit Ejabberd Config
--------------------
```
cd /etc/ejabberd
vim ejabberd.cfg
```
Remove:
```
{auth_method, internal}.
```
Change:
```
{acl, admin, {user, "alagu", "localhost"}}.
{auth_method, external}.
{extauth_program, "/etc/ejabberd/auth.py"}.
{extauth_cache, 600}.
{extauth_instances, 5}.
```
Also add hosts.
```
{hosts, ["localhost", "chat.alagu.net"]}
```
Add mod_http_bind module
```
{modules ,
[
...
{mod_http_bind, []},
...
]
}
```
(Save and Quit vim)
Here is a sample ejabberd cfg which works for me: [ejabberd.cfg](https://github.com/alagu/hummingbird/blob/master/server/setup/ejabberd.cfg.sample)
Create admin user in commandline:
```
sudo ejabberdctl register alagu localhost mypassword
```
Create SRV Record
------------------
This is bit tricky. You have to configure your DNS to add SRV records. (Example http://library.linode.com/communications/xmpp/ejabberd/ubuntu-8.04-hardy#sph_xmpp-jabber-basics)
Try logging into the jabber server. Use pidgin/adium.
Any username(Say joe@localhost), any password should connect to your machine.
Here is my linode configuration:
Single item entry:
Test Jabber Installation
-------------------------
```
apt-get install sendxmpp
echo "someguy@localhost uselesspassword" > ~/.sendxmpprc
chmod 600 ~/.sendxmpprc
echo "Testing goyaka chat" | sendxmpp [email protected]
```
Get the chat widget
-------------------
Go to the (client folder)[https://github.com/alagu/hummingbird/tree/master/client].
Edit chat-client.js and configure (in client/static):
```
var BOSH_SERVICE = 'http://olark.alagu.net:5280/http-bind';
var JABBER_HOST = 'olark.alagu.net';
var ADMIN_USER = '[email protected]';
```
Set them to right variables and build chat.js
```
bash compile.sh
```
This compiles all javascript files to single chat.js. Copy following files to your assets directory.
```
client/
static/
chat-0.1.css
chat.js
```
Now, insert these two lines in your product html.
```
```
Try the DEMO.
Adium configuration
--------------------
Once this is done, get your admin account logged in Adium. (Note: None of this is ACL protected)
Username should be [email protected] and password could be anything.
ACL
---
The auth.py defines the acl for each account. You could tie up a sqlite/mysql db which holds the auth mechanism.