Difference between revisions of "Integrating Your Component"

Revision as of 15:25, 17 January 2013

3rd party component can easily integrate JomSocial features into their component. Among other things, 3rd party other component can

Support JomSocial build-in personal messaging system
Use JomSocial avatar
Use JomSocial user object, CUser
Link to user personal profile page
Include user action to JomSocial activity stream, and reward user with points
Extends JomSocial via new plugin

Support JomSocial build-in personal messaging system

To support private messaging within your component, you will have to use this code.

$jspath = JPATH_ROOT.DS.'components'.DS.'com_community';
include_once($jspath.DS.'libraries'.DS.'core.php');
include_once($jspath.DS.'libraries'.DS.'messaging.php');
// Add a onclick action to any link to send a message
// Here, we assume $usrid contain the id of the user we want to send message to
$onclick = CMessaging::getPopup($userid);
echo '<a onclick="'.$onclick.'" href="#">Send message</a>';

Use JomSocial Avatar

To get path to JS avatar, you can simply request a CUser object and call a simple getThumbAvatar function to retrieve the avatar url.

$jspath = JPATH_ROOT.DS.'components'.DS.'com_community';
include_once($jspath.DS.'libraries'.DS.'core.php');
// Get CUser object
$user = CFactory::getUser($userid);
$avatarUrl = $user->getThumbAvatar();
echo '<img src="/.%20$avatarUrl%20.%20" mce_src="http://www.jomsocial.com/. $avatarUrl .">';