PhoneGap Real Time Chat & Messaging Plugin
Applozic powers real time messaging across any device, any platform & anywhere in the world. Integrate our simple SDK to engage your users with image, file, location sharing and audio/video conversations.
Signup at Applozic to get your application key.
Step 1: Copy applozic folder containing js and css files into your project folder.
Step 2: Add the following under <head>
tag:
<meta http-equiv="Content-Security-Policy" content="script-src 'self' https://apps.applozic.com https://maps.google.com https://maps.googleapis.com 'unsafe-inline' 'unsafe-eval'; style-src 'self' https://apps.applozic.com 'unsafe-inline'">
<link href="applozic/css/mck-combined.min.css" rel="stylesheet">
<link href="applozic/css/app/mck-sidebox-1.0.css" rel="stylesheet">
<!-- Custom JS -->
<script type="text/javascript">
var $original;
if (typeof jQuery !== 'undefined') {
$original = jQuery.noConflict(true);
$ = $original;
jQuery = $original;
}
</script>
<script src="applozic/js/jquery-2.2.2.min.js"></script>
Step 3: Chat UI HTML Copy the following HTML under tag for Chat UI.
<div id="mck-side-panel">
<div id="mck-sidebox" class="mck-sidebox mck-box fade">
<div class="mck-box-dialog mck-box-sm mck-right mck-bg-white">
<div id="mck-sidebox-content" class="mck-sidebox-content mck-box-content">
<div id="mck-conversation-header" class="mck-conversation-header mck-truncate n-vis"></div>
<div class="mck-box-top">
<button type="button" class="mck-minimize-icon mck-box-close mck-close icon n-vis"><span aria-hidden="true">−</span></button>
<div class="blk-lg-2 move-right">
<button type="button" class="mck-box-close mck-close-sidebox" data-dismiss="mckbox" aria-label="Close"><span aria-hidden="true">×</span></button>
</div>
<div class="blk-lg-10">
<div id="mck-tab-individual" class="mck-row n-vis">
<div class="mck-tab-link blk-lg-4"><a href="#" role="link" class="mck-conversation-tab-link"><span class="mck-icon-backward"></span></a></div>
<div class="blk-lg-8 mck-box-title">
<div id="mck-tab-title" class="mck-tab-title mck-truncate">
Conversations
</div>
<div id="mck-tab-status" class="mck-tab-status mck-truncate n-vis"></div>
<div class="mck-typing-box mck-truncate n-vis"><span class="name-text"></span><span>typing...</span></div>
</div>
</div>
<div id="mck-tab-conversation" class="mck-row">
<h4 id="mck-conversation-title" class="mck-box-title mck-truncate">Conversations</h4>
</div>
</div>
</div>
<div id="mck-product-group" class="mck-tab-panel mck-btn-group mck-product-group">
<div id="mck-product-box" class="mck-product-box n-vis mck-dropdown-toggle" data-toggle="mckdropdown" aria-expanded="true">
<div class="mck-row">
<div class="blk-lg-10">
<div class="mck-row">
<div class="blk-lg-3 mck-product-icon"></div>
<div class="blk-lg-9">
<div class="mck-row">
<div class="blk-lg-8 mck-product-title mck-truncate"></div>
<div class="move-right mck-product-rt-up mck-truncate blk-lg-4">
<strong class="mck-product-key"></strong>:<span class="mck-product-value"></span>
</div>
</div>
<div class="mck-row">
<div class="blk-lg-8 mck-truncate mck-product-subtitle"></div>
<div class="move-right mck-product-rt-down mck-truncate blk-lg-4">
<strong class="mck-product-key"></strong>:<span class="mck-product-value"></span>
</div>
</div>
</div>
</div>
</div>
<div class="blk-lg-2">
<span class="mck-caret n-vis"></span>
</div>
</div>
</div>
<ul id="mck-conversation-list" class="mck-dropdown-menu menu-right mck-conversation-list n-vis" role="menu"></ul>
</div>
<div id="mck-tab-option-panel" class="mck-tab-panel mck-top-btn-panel">
<div id="mck-tab-menu-box" class="mck-tab-menu-box vis">
<div class="mck-row">
<div class="blk-lg-10">
<button type="button" id="mck-show-more" class="mck-show-more mck-tab-message-option mck-btn-light mck-btn mck-btn-default" title="Show More">
<span>Show More</span>
</button>
</div>
<div class="blk-lg-2">
<div class="mck-dropdown-toggle" data-toggle="mckdropdown" aria-expanded="true">
<img src="applozic/css/app/images/mck-icon-menu.png" alt="Tab Menu">
</div>
<ul id="mck-tab-menu-list" class="mck-dropdown-menu mck-tab-menu-box menu-right" role="menu">
<li class="mck-tab-message-option">
<a href="#" id="mck-delete-button" class="mck-delete-button menu-item" title="Delete All">
Delete All
</a>
</li>
<li id="li-mck-block-user">
<a href="#" id="mck-block-button" class="menu-item" title="Block User">
Block User
</a>
</li>
</ul>
</div>
</div>
</div>
</div>
<div class="mck-box-body">
<div id="mck-message-cell" class="mck-message-cell">
<div id="mck-price-widget" class="mck-row mck-price-widget mck-top-widget n-vis">
<div class="mck-widget-panel">
<input type="text" id="mck-price-text-box" placeholder="Enter final agreed price">
<button type="button" id="mck-price-submit" class="mck-btn mck-btn-green mck-price-submit" title="Submit">
<span>Submit</span>
</button>
</div>
</div>
<div class="mck-message-inner"></div>
<div id="mck-contact-loading" class="mck-loading">
<span class="mck-icon-loading"></span>
</div>
<div id="mck-show-more-icon" class="mck-show-more-icon n-vis">
<h3>No more conversations!</h3>
</div>
</div>
</div>
<div id="mck-file-menu" class="mck-file-menu">
<div class="mck-row">
<div class="blk-lg-6 mck-left mck-pt10">
<label id="mck-file-up" class="fileinput-button mck-file-upload" title="Files & Photos">
<a href="#">
<div class="mck-menu-icon">
<span class="mck-icon-photo"></span>
</div>
<p class="mck-truncate" title="File & Photos">Files & Photos</p></a>
<input class="mck-file-input" type="file" name="files[]">
</label>
</div>
<div class="blk-lg-6 mck-pt10">
<a id="mck-btn-loc" href="#" class="mck-btn-loc">
<div class="mck-menu-icon">
<span class="mck-icon-marker-blue"></span>
</div>
<p class="mck-truncate" title="Location">Location</p>
</a>
</div>
</div>
</div>
<div id="mck-sidebox-ft" class="mck-box-ft">
<div class="mck-box-form n-vis">
<p id="mck-msg-error" class="mck-sidebox-error n-vis"></p>
<div id="mck-msg-response" class="mck-box-response n-vis">
<div id="mck-response-text" class="response-text"></div>
</div>
<form id="mck-msg-form" class="vertical mck-msg-form">
<div class="mck-form-group n-vis">
<label class="sr-only placeholder-text control-label" for="mck-msg-to">To:</label>
<input class="mck-form-cntrl" id="mck-msg-to" name="mck-msg-to" placeholder="To" required>
</div>
<div class="mck-form-group last last-child">
<label class="sr-only placeholder-text control-label" for="mck-textbox">Message</label>
<div id="mck-textbox-container" class="mck-textbox-container">
<div class="mck-blk-2 mck-text-box-panel move-left">
<div class="mck-blk-12">
<button type="button" id="mck-btn-smiley" class="mck-btn mck-btn-smiley mck-btn-text-panel" title="Smiley"><span class="mck-icon-smiley-blue"></span></button>
</div>
</div>
<div class="mck-blk-2 mck-text-box-panel mck-mid-panel move-left">
<div id="mck-attachmenu-box" class="mck-blk-12">
<button type="button" id="mck-btn-attach" class="mck-btn mck-btn-text-panel mck-btn-attach" aria-expanded="true" title="Attach File"><span class="mck-icon-upload"></span></button>
</div>
<div id="mck-attachfile-box" class="mck-blk-12 n-vis">
<label id="mck-file-up2" class="fileinput-button mck-file-upload move-right" title="Attach File">
<button type="button" class="mck-btn mck-btn-text-panel" title="Attach File"><span class="mck-icon-upload"></span></button>
<input class="mck-file-input" type="file" name="files[]">
</label>
</div>
</div>
<div id="mck-text-box" contenteditable="true" class="mck-blk-8 mck-text-box mck-text required"></div>
<div class="mck-blk-2 mck-text-box-panel move-right">
<div class="mck-blk-12">
<button type="submit" id="mck-msg-sbmt" class="mck-btn mck-btn-text-panel" title="Send Message"><span class="mck-icon-send"></span></button>
</div>
</div>
<div id="mck-file-box" class="mck-file-box row-fluid n-vis">
<div class="mck-file-expr">
<span class="mck-file-content blk-lg-8"><span class="mck-file-lb"></span> <span class="mck-file-sz"></span></span>
<span class="progress progress-striped active blk-lg-3" role="progressbar" aria-valuemin="0" aria-valuemax="100" aria-valuenow="0"><span class="progress-bar progress-bar-success bar"></span></span>
<span class="move-right">
<button type="button" class="mck-box-close mck-remove-file" data-dismiss="div" aria-hidden="true">x</button>
</span>
</div>
</div>
</div>
</div>
</form>
</div>
<div id="mck-contacts-content" class="mck-contacts-content mck-text-center">
<button type="submit" id="mck-msg-new" class="mck-msg-new mck-btn mck-btn-blue" title="new message">
<span>New Message</span>
</button>
</div>
</div>
<div class="mck-running-on n-vis">
<a href="https://www.applozic.com" target="_blank"><strong>Powered by Applozic</strong></a>
</div>
</div>
<div id="mck-sidebox-search" class="mck-sidebox-search mck-sidebox-content mck-box-content n-vis">
<div class="mck-box-top">
<div class="mck-box-title mck-truncate">
<div class="mck-tab-link blk-lg-4">
<a href="#" role="link" class="mck-conversation-tab-link"><span class="mck-icon-backward"></span></a>
</div>
<div class="mck-input-group blk-lg-8">
<input type="text" id="mck-search" data-provide="typeahead" placeholder="Search..." autofocus />
<span class="mck-search-icon"><a href="#" role="link" class="mck-tab-search"><span class="mck-icon-search"></span></a></span>
</div>
</div>
</div>
<div class="mck-box-body">
<div id="mck-search-cell" class="mck-message-cell">
<div class="mck-message-inner">
<ul id="mck-search-list" class="mck-search-list mck-contact-list mck-nav mck-nav-tabs mck-nav-stacked"></ul>
</div>
<div id="mck-search-loading" class="mck-loading n-vis">
<span class="mck-icon-loading"></span>
</div>
</div>
</div>
</div>
</div>
</div>
<div id="mck-loc-box" class="mck-box fade" aria-hidden="false">
<div class="mck-box-dialog mck-box-md">
<div class="mck-box-content">
<div class="mck-box-top">
<button type="button" class="mck-box-close" data-dismiss="mckbox" aria-label="Close"><span aria-hidden="true">ร</span></button>
<h4 class="mck-box-title">Location Sharing</h4>
</div>
<div class="mck-box-body">
<div class="mck-form-group">
<div class="blk-sm-10">
<input id="mck-loc-address" type="text" class="mck-form-control" placeholder="Enter a location" autocomplete="off">
</div>
</div>
<div id="mck-map-content" style="width: 100%; height: 280px;"></div>
<div class="n-vis">
<label class="blk-sm-2 mck-control-label">Lat.:</label>
<div class="blk-sm-3"><input type="text" id="mck-loc-lat" class="mck-form-control"></div>
<label class="blk-sm-2 mck-control-label">Long.:</label>
<div class="blk-sm-3"><input type="text" id="mck-loc-lon" class="mck-form-control"></div>
</div>
</div>
<div class="mck-box-footer">
<button id="mck-my-loc" type="button" class="mck-my-loc mck-btn mck-btn-green" >My Location</button>
<button id="mck-loc-submit" type="button" class="mck-btn mck-btn-blue mck-loc-submit move-right">Send</button>
<button type="button" class="mck-btn mck-btn-default move-right" data-dismiss="mckbox">Close</button>
</div>
</div>
</div>
</div>
</div>
Step 4: Javascript
<script type="text/javascript" src="applozic/js/mck-ui-plugins.min.js"></script>
<script type="text/javascript" src="applozic/js/mck-ui-widget.min.js"></script>
<script type="text/javascript" src="applozic/js/mck-emojis.min.js"></script>
<script type="text/javascript" src="applozic/js/mck-socket.min.js"></script>
<script type="text/javascript" src="applozic/js/locationpicker.jquery.min.js"></script>
<script type="text/javascript" src="applozic/js/app/mck-sidebox-1.0.js"></script>
<script type="text/javascript">
if (typeof $original !== 'undefined') {
$ = $original;
jQuery = $original;
} else {
$ = $applozic;
jQuery = $applozic;
}
</script>
Step 5: Open Chat Interface
//Function to initialize chat plugin
$applozic.fn.applozic({
userId: 'USER_ID', // Replace USER_ID with the user's unique identifier
userName: 'DISPLAY_NAME', // Replace DISPLAY_NAME with the user's name
appId: 'APPLICATION_KEY', // Replace APPLICATION_KEY with the Application key received after Signup from https://www.applozic.com/signup.html
ojq: $original,
maxAttachmentSize: 25, //max attachment size in MB
desktopNotification: true,
locShare: false,
googleApiKey: "AIzaSyDKfWHzu9X7Z2hByeW4RRFJrD9SizOzZt4",
onInit: function() {
$applozic.fn.applozic('loadTab', '');
//Todo: Register your push notification here. registerPushNotifications();
}
});
Step 6: Push notification registration
var userPxy = {
'applicationId': 'APPLICATION_KEY', // Replace APPLICATION_KEY with the Application key received after Signup from https://www.applozic.com/signup.html
'userId': 'USER_ID', // Replace USER_ID with the user's unique identifier
'registrationId': 'GCM_REGISTRATION_ID', //Replace GCM_REGISTRATION_ID with GCM registration id
'pushNotificationFormat' : '1'
};
$.ajax({
url: "https://apps.applozic.com/rest/ws/register/client",
type: 'post',
data: w.JSON.stringify(userPxy),
contentType: 'application/json',
headers: {'Application-Key': 'APPLICATION_KEY'}, // Replace APPLICATION_KEY with the Application key received after Signup from https://www.applozic.com/signup.html
success: function (result) {
//console.log(result);
}
});
More function details are available here: https://www.applozic.com/developers.html#applozic-web-plugin-getting-started (Ignore first 3 steps in the above links).
##Demo page
Demo chat code: https://github.com/AppLozic/Applozic-PhoneGap-Chat-Plugin/blob/master/www/index.html
##Help
We provide support over at [StackOverflow] (http://stackoverflow.com/questions/tagged/applozic) when you tag using applozic, ask us anything.
Applozic is the best ios chat sdk for instant messaging, still not convinced? Write to us at [email protected] and we will be happy to schedule a demo for you.
##Github projects
Android Chat SDK https://github.com/AppLozic/Applozic-Android-SDK
Web Chat Plugin https://github.com/AppLozic/Applozic-Web-Plugin
iOS Chat SDK https://github.com/AppLozic/Applozic-iOS-SDK