Skip to main content

Legacy API Migration

Use legacy() for gradual migration from old Sociable APIs.

Legacy to Modern Mapping​

Legacy MethodModern Equivalent
SociableApi::getPointsApi()->awardPoints()$sociable->points()->awardByRule()
SociableApi::getProfileApi()->getUserAvatar()$sociable->avatars()->url()
SociableApi::getBadgesApi()->trigger()$sociable->badges()->triggerByRule()
SociableApi::getStreamApi()->push()$sociable->activities()->push()
SociableApi::getNotificationsApi()->push()$sociable->notifications()->send()

Using Legacy Bridge​

$bridge = $sociable->legacy();

$bridge->getPointsApi()->awardPoints('rule.name', $userId);
$bridge->getProfileApi()->getUserAvatar($userId);
$bridge->getBadgesApi()->trigger('rule.name', $userId, $values);
$bridge->getStreamApi()->push($userId, 'post', 'create', 'Description');
$bridge->getNotificationsApi()->push($userId, $actorId, 'type');

Legacy methods trigger deprecation warnings. Migrate to modern methods when possible.