xmpp.chapril.org-conversejs/index.html

146 lines
6.7 KiB
HTML
Raw Normal View History

2013-03-28 16:42:49 +01:00
<!DOCTYPE html>
<html>
2013-03-28 17:52:07 +01:00
<head>
2013-03-28 16:42:49 +01:00
<meta charset='utf-8' />
<meta http-equiv="X-UA-Compatible" content="chrome=1" />
2013-04-14 00:03:43 +02:00
<meta name="description" content="Converse.js: Open Source Browser-Based Instant Messaging" />
2013-03-28 16:42:49 +01:00
<link rel="stylesheet" type="text/css" media="screen" href="stylesheets/stylesheet.css">
2013-04-01 18:41:46 +02:00
<link rel="stylesheet" type="text/css" media="screen" href="converse.css">
<script data-main="main" src="Libraries/require-jquery.js"></script>
2013-03-28 16:42:49 +01:00
<title>Converse.js</title>
2013-03-28 17:52:07 +01:00
</head>
2013-03-28 16:42:49 +01:00
2013-03-28 17:52:07 +01:00
<body>
2013-03-28 16:42:49 +01:00
<!-- HEADER -->
<div id="header_wrap" class="outer">
<header class="inner">
<a id="forkme_banner" href="https://github.com/jcbrand/converse.js">View on GitHub</a>
<h1 id="project_title"><a href="http://conversejs.org">Converse.js</a></h1>
2013-03-28 16:42:49 +01:00
<h2 id="project_tagline">Browser-based Instant Messaging with Strophe.js and Backbone.js</h2>
<section id="downloads">
<a class="zip_download_link" href="https://github.com/jcbrand/converse.js/zipball/master">Download this project as a .zip file</a>
<a class="tar_download_link" href="https://github.com/jcbrand/converse.js/tarball/master">Download this project as a tar.gz file</a>
</section>
</header>
</div>
<!-- MAIN CONTENT -->
<div id="main_content_wrap" class="outer">
2013-04-01 18:41:46 +02:00
<section id="main_content" class="inner">
2013-04-25 00:23:59 +02:00
<p><strong>Converse.js</strong> is an open source, web based, <a href="http://xmpp.org" target="_blank">XMPP/Jabber</a> chat client, similar to
<a href="https://www.facebook.com/sitetour/chat.php" target="_blank">Facebook chat</a>, except for the added support of multi-user chatrooms.</p>
<p>It is a Javascript application that you can include in your
website, thereby providing it with instant messaging functionality.</p>
<p>You will however need access to an XMPP/Jabber server.</p>
<p>You can connect to any public, federated XMPP server, or you could set one up
yourself, thereby maintaining stricter control of the user data (XMPP servers
usually don't archive chat messages).</p>
2013-03-28 16:42:49 +01:00
2013-04-01 18:41:46 +02:00
<h2>Features</h2>
<ul>
2013-04-25 00:23:59 +02:00
<li>Single and multi-user chat</li>
<li>Contact rosters</li>
<li>Manually or automically subscribe to other contacts</li>
<li>Roster item exchange (<a href="http://xmpp.org/extensions/tmp/xep-0144-1.1.html">XEP 144</a>)</li>
2013-04-01 18:41:46 +02:00
<li>Accept or decline contact requests</li>
<li>Chat statuses (online, busy, away, offline)</li>
2013-04-01 18:41:46 +02:00
<li>Custom status messages</li>
<li>Typing notifications</li>
<li>Third person messages (/me )</li>
2013-04-25 00:23:59 +02:00
<li>Multi-user chat in chatrooms (<a href="http://xmpp.org/extensions/xep-0045.html">XEP 45</a>)</li>
2013-04-01 18:41:46 +02:00
<li>Chatroom Topics</li>
2013-04-25 00:23:59 +02:00
<li>vCard support (<a href="http://xmpp.org/extensions/xep-0054.html">XEP 54</a>)</li>
2013-04-01 18:41:46 +02:00
</ul>
2013-03-28 16:42:49 +01:00
2013-04-25 00:23:59 +02:00
<h2>CMS Integration</h2>
<p><strong>Converse.js</strong> is available as an add-on for the <a href="http://plone.org" target="_blank">Plone</a> CMS, called <a href="http://github.com/collective/collective.xmpp.chat" target="_blank">collective.xmpp.chat</a>.</p>
<p>If you have integrated Converse.js into any other CMS or framework,
<a href="http://opkode.com/contact" target="_blank">please let me know</a> and I'll mention it on this page.</p>
<h2>Screencasts</h2>
<ul>
2013-04-19 00:09:04 +02:00
<li><a href="http://opkode.com/media/blog/instant-messaging-for-plone-with-javascript-and-xmpp" target="_blank">Screencast 1</a>:
Integrated into a Plone site via <strong>collective.xmpp.chat</strong>.
</li>
2013-04-19 00:09:04 +02:00
<li><a href="http://opkode.com/media/blog/2013/04/02/converse.js-xmpp-instant-messaging-with-javascript" target="_blank">Screencast 2</a>:
A static HTML page with <em>Converse.js</em>. Here we chat to external XMPP accounts on Jabber.org and Gmail.
</li>
</ul>
2013-03-28 16:42:49 +01:00
2013-04-19 00:09:04 +02:00
<h2>Demo</h2>
<p>
<a href="#" class="chat toggle-online-users">Click this link</a> or
2013-04-25 00:23:59 +02:00
click the link on the bottom right corner of this page.
2013-04-19 00:09:04 +02:00
</a>
</p>
<p>
2013-04-25 00:23:59 +02:00
You can log in with any existing federated Jabber/XMPP account, or create a new one at any of these providers:
2013-04-19 00:09:04 +02:00
<ul>
2013-04-25 00:23:59 +02:00
<li><a href="http://jabber.org" target="_blank">jabber.org</a></li>
<li><a href="https://jappix.com" target="_blank">jappix.com</a></li>
<li><a href="https://gmail.com" target="_blank">gmail.com</a></li>
2013-04-19 00:09:04 +02:00
</ul>
</p>
2013-04-25 00:23:59 +02:00
<p>
The chat client will disconnect whenever you reload the page. If you
want the user's session to persist across page reloads, you can
establish an authenticated connection on the server side and then attach to
this connection in your browser.
</p>
<p><strong>Converse.js</strong> already supports this usecase, but you'll have to
do more manual work yourself.
</p>
2013-04-19 00:09:04 +02:00
2013-04-19 00:39:40 +02:00
<h2>Tests</h2>
</p>
We use the <a href="http://pivotal.github.io/jasmine"
target="_blank">Jasmine</a> testing framework to write tests.
The tests can be run in the browser and can be viewed <a href="http://conversejs.org/tests.html" target="_blank">here</a>.
</p>
2013-04-01 18:41:46 +02:00
<h2>Dependencies</h2>
<p><strong>Converse.js</strong> depends on a few third party libraries, including:
<ul>
2013-04-19 00:09:04 +02:00
<li><a href="http://strophe.im/strophejs" target="_blank">strophe.js</a></li>
2013-04-19 17:12:35 +02:00
<li><a href="http://backbonejs.org" target="_blank">backbone.js</a></li>
<li><a href="http://requirejs.org" target="_blank">require.js</a></li>
2013-04-01 18:41:46 +02:00
</ul>
</p>
2013-03-28 16:42:49 +01:00
2013-04-01 18:41:46 +02:00
<h2>Licence</h2>
2013-04-19 00:09:04 +02:00
<p><strong>Converse.js</strong> is released under both the <a href="http://opensource.org/licenses/mit-license.php" target="_blank">MIT</a>
and <a href="http://opensource.org/licenses/GPL-2.0" target="_blank">GPL</a> licenses.</p>
2013-04-18 23:05:25 +02:00
</section>
</div>
<!-- FOOTER -->
<div id="footer_wrap" class="outer">
<footer class="inner">
<p class="copyright">Converse.js created by <a href="http://opkode.com" target="_blank">jcbrand</a></p>
2013-04-18 23:05:25 +02:00
</footer>
</div>
2013-03-28 16:42:49 +01:00
2013-04-18 23:05:25 +02:00
<div id="chatpanel">
<div id="collective-xmpp-chat-data"></div>
<div id="toggle-controlbox">
2013-04-19 00:09:04 +02:00
<a href="#" class="chat toggle-online-users">
<strong class="conn-feedback">Click here to chat</strong> <strong style="display: none" id="online-count">(0)</strong>
2013-04-18 23:05:25 +02:00
</a>
2013-03-28 16:42:49 +01:00
</div>
2013-04-18 23:05:25 +02:00
</div>
2013-04-01 23:44:49 +02:00
<script type="text/javascript">
var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
</script>
<script type="text/javascript">try { var pageTracker = _gat._getTracker("UA-2128260-8"); pageTracker._trackPageview(); } catch(err) {}</script>
</body>
2013-03-28 16:42:49 +01:00
</html>