Before you begin
1. Sign-up for a Free Trial
You can select a suitable plan from AtomChat's pricing page and sign up for a 14-day free trial!
2. Note Your API Keys
- Sign in to your Dashboard and click on the Manage button
- You will see API Keys on the top right. You can copy your keys from here!
3. Secure your environment
For successful integration, please ensure your domain or local environment is SSL certified and secure.
Choose a Layout
AtomChat offers 2 Layouts
1. Docked Layout creates a floating chat widget at the bottom right/left corner of your website.
2. Embedded Layout embeds a chat interface inside any page of your website
And please remember!
AtomChat layouts are not designed to be used together on the same page. If you add both layouts on the same page, please expect erratic behavior from the software.
Setting up the Docked Layout
Where to add the code?
- Login to your Joomla Administrator Panel
- Click on Extensions -> Templates
- Select the active/default template
- Find index.php from the left side navigation
- Paste the code below before the tag in the index.php file
NOTE: Please replace the "APP_ID" and "AUTH_KEY" values in the code with your own Keys from your AtomChat Admin Panel -> API Keys
<script> var chat_appid = 'APP_ID'; var chat_auth = 'AUTH_KEY'; </script> <?php $chat_id = $chat_name = $chat_avatar = $chat_link = $chat_displayname = $chat_role = ""; $chat_friends = ''; $user = JFactory::getUser(); if (!$user->guest) { $chat_id = $user->id; $chat_name = $user->username; $chat_displayname = $user->name; if(class_exists('JAccess')) { $user = JFactory::getUser(); $groups = JAccess::getGroupsByUser($user->id, false); $groups_list = "(" . implode(",", $groups) . ")"; $db = JFactory::getDbo(); $query = $db->getQuery(true) ->select($db->qn("title")) ->from("#__usergroups") ->where($db->qn("id") . " IN " . $groups_list); $db->setQuery($query); $rows = $db->loadObjectList(); if(!empty($rows) && is_object($rows[0]) && property_exists($rows[0], "title")){ $chat_role = $rows[0]->title; } } } ?> <script> var chat_id = '<?php echo $chat_id;?>'; var chat_name = '<?php echo $chat_displayname;?>'; var chat_avatar = '<?php echo $chat_avatar;?>'; var chat_link = '<?php echo $chat_link;?>'; var chat_role = '<?php echo $chat_role;?>'; var chat_friends = '<?php echo $chat_friends;?>'; </script> <script> (function() { var chat_css = document.createElement('link'); chat_css.rel = 'stylesheet'; chat_css.type = 'text/css'; chat_css.href = 'https://fast.cometondemand.net/'+chat_appid+'x_xchat.css'; document.getElementsByTagName("head")[0].appendChild(chat_css); var chat_js = document.createElement('script'); chat_js.type = 'text/javascript'; chat_js.src = 'https://fast.cometondemand.net/'+chat_appid+'x_xchat.js'; var chat_script = document.getElementsByTagName('script')[0]; chat_script.parentNode.insertBefore(chat_js, chat_script); })(); </script>
Setting up the Embedded Layout
Where to add the code?
- Login to your Joomla Administrator Panel
- Click on Extensions -> Templates
- Select the active/default template
- Find index.php from the left side navigation
- Paste the code below before the tag in the index.php file
NOTE: Please replace the "APP_ID" and "AUTH_KEY" values in the code with your own Keys from your AtomChat Admin Panel -> API Keys
<script>
var chat_appid = 'APP_ID';
var chat_auth = 'AUTH_KEY';
</script>
<?php
$chat_id = $chat_name = $chat_avatar = $chat_link = $chat_displayname = $chat_role = "";
$chat_friends = '';
$user = JFactory::getUser();
if (!$user->guest) {
$chat_id = $user->id;
$chat_name = $user->username;
$chat_displayname = $user->name;
if(class_exists('JAccess')) {
$user = JFactory::getUser();
$groups = JAccess::getGroupsByUser($user->id, false);
$groups_list = "(" . implode(",", $groups) . ")";
$db = JFactory::getDbo();
$query = $db->getQuery(true) ->select($db->qn("title")) ->from("#__usergroups") ->where($db->qn("id") . " IN " .
$groups_list); $db->setQuery($query);
$rows = $db->loadObjectList();
if(!empty($rows) && is_object($rows[0]) && property_exists($rows[0], "title")){
$chat_role = $rows[0]->title;
}
}
}
?>
<script>
var chat_id = '<?php echo $chat_id;?>';
var chat_name = '<?php echo $chat_displayname;?>';
var chat_avatar = '<?php echo $chat_avatar;?>';
var chat_link = '<?php echo $chat_link;?>';
var chat_role = '<?php echo $chat_role;?>';
var chat_friends = '<?php echo $chat_friends;?>';
</script>
<script>
var chat_height = '600px';
var chat_width = '990px';
document.write('<div id="cometchat_embed_synergy_container" style="width:'+chat_width+';height:'+chat_height+';max-width:100%;border:1px solid #CCCCCC;border-radius:5px;overflow:hidden;"></div>');
var chat_js = document.createElement('script'); chat_js.type = 'text/javascript'; chat_js.src = 'https://fast.cometondemand.net/'+chat_appid+'x_xchatx_xcorex_xembedcode.js';
chat_js.onload = function() {
var chat_iframe = {};chat_iframe.module="synergy";chat_iframe.style="min-height:"+chat_height+";min-width:"+chat_width+";";chat_iframe.width=chat_width.replace('px','');chat_iframe.height=chat_height.replace('px','');chat_iframe.src='https://'+chat_appid+'.cometondemand.net/cometchat_embedded.php'; if(typeof(addEmbedIframe)=="function"){addEmbedIframe(chat_iframe);}
}
var chat_script = document.getElementsByTagName('script')[0];chat_script.parentNode.insertBefore(chat_js, chat_script);
</script>
Contact Sync
Your user list on AtomChat will get populated and they will be visible in the Chat Contact list once they log in to your EasySocial website after integrating AtomChat. So, users are added on-the-fly as they login.
Need help Integrating?
We've got you! Please Contact Us if you need any help or have questions. You can also schedule a remote Integration Assistance meeting with our team of experts!
Happy to help :)
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article