Skip to main content

​
Overview

social.plus SDK delivers real-time event updates for social and chat data models (communities, posts, comments, channels, messages, and user profiles) across all connected devices without manual polling.
Real-time events work with Live Objects & Collections to provide automatic UI updates without manual data fetching.

​
Supported Data Models

Social Features

Communities, Posts, Comments, User profiles, Follow relationships

Chat Features

Channels, Subchannels, Messages, Member activities

​
Event Types by Model

ModelAvailable Events
CommunityCreated, Updated, Deleted, Joined, Left, Member management
PostCreated, Updated, Deleted, Approved, Flagged, Reactions
CommentCreated, Updated, Deleted, Flagged, Reactions
UserProfile updates, Follow/Unfollow activities
ChannelMessages, Member activities, Status changes
SubchannelThread-specific updates

​
How It Works

​
1. Subscription Topics

Create subscription topics to define which events you want to receive:

​
2. Event Delivery

Events are delivered through Live Objects and Collections that you’re already observing:
  • Automatic Updates: No manual refresh needed
  • Real-time Synchronization: Changes appear instantly
  • Efficient: Only subscribed events are processed

​
Managing Subscriptions

​
Subscription Limits

The SDK has a maximum limit of 20 active subscriptions per session. Manage your subscriptions carefully to stay within this limit.

​
Best Practices for Subscription Management

Instead of subscribing to individual posts or comments, subscribe to community-level topics with POST_AND_COMMENT level to cover all content in that community.
// ✅ Better: One subscription covers all posts and comments
const topic = getCommunityTopic(community, SubscriptionLevels.POST_AND_COMMENT);

// ❌ Avoid: Multiple subscriptions for the same data
const postTopic = getPostTopic(post1, SubscriptionLevels.POST);
const commentTopic = getPostTopic(post1, SubscriptionLevels.COMMENT);
Manage subscriptions based on UI state to optimize performance and stay within limits.
// React example
useEffect(() => {
  const topic = getCommunityTopic(community, SubscriptionLevels.POST);
  
  // Subscribe when component mounts
  EventSubscriberRepository.subscribe(topic);
  
  return () => {
    // Unsubscribe when component unmounts
    EventSubscriberRepository.unsubscribe(topic);
  };
}, [community.communityId]);
All subscriptions are automatically removed when logout() is called, helping prevent memory leaks and unwanted data consumption.

​
Next Steps

Social Real-time Events

Explore social platform event subscriptions

Chat Real-time Events

Learn about chat and messaging events