Getting started guide for Sociable

From CjWiki
Revision as of 03:06, 17 February 2020 by Corejoomla (talk | contribs)
Jump to navigation Jump to search

Introduction and setup

This guide allows you to set up a Sociable extension on your website. Before starting, make sure you have the necessary packages, such as Sociable package and CjLib package, downloaded from the website. To know more about how to install an extension, please read the following guide:



Sociable comes with many configuration options to customize the look and feel, features support and so on. After installing the extension, go to Components -> Sociable and click on the Options button the toolbar. Now you will be shown with a list of configurable options. Each option is documented on its label for easy reference. Make sure to review all the options and customize them according to your needs.

  • Profile: These options allow you to customize how the profile page looks and allow you to enable/disable Sociable core features of profiles.
  • List Layouts: These settings apply to the list layouts such as group topics listing etc.
  • Media settings: These settings allow you to customize the behavior of user uploads and how the photos/videos are displayed on the wall etc.
  • Shared options: These are the common settings that apply to the component.
  • Integration: Using these settings, you can integrate the extension with third-party extensions, customize the default layout according to your template's Bootstrap version, customize the color theme, etc.
  • Permissions: These are permissions that you can configure to allow your users to authorize the functions available in the component.


In the options page, you can customize the component permissions in the Permissions tab. Every user group has certain permissions that you can allow. For example which user group can create posts etc. Configure the permissions according to your needs.

Menu items setup

Once you setup the options and permissions, the next step is configuring the menu items. Apart from allowing your user's access to the component, menu items define your component URLs. So they are very important in setting up search engine friendly URLs and easy access to your extension pages. Sociable provides the menu item for each supported feature. You need not show all menu items on your front-end site. Simply add a new Menus, let's say Sociable Menu, and add all available menu items of Sociable to these Menus. You can create a Menu Alias type menu item to link to one of these Menus in your Main Menu. This way, your users will be shown only one Menu item which is needed to access the site and other menu items are used to render the URLs. You can set up one of the Sociable menu items as your home page menu item if you would like to use Sociable as a default home page.

To learn more about Joomla menu creation, please read the following documentation.

Multi-profile setup

Sociable allows you to configure multiple profiles according to your user groups. You will need to set up at least one profile that will act as a default/favorite profile and apply it to the user automatically when the user registers on your site. Any other profiles that you create can be assigned manually to the users (feature available from v1.0.3). To learn more about how to set up multiple profiles, read the following documentation.

Initial user sync

When Sociable installed for the first time, it will not have any information about your users. It needs to be synced up with your existing users in order to allow them integrated with the Sociable profile system. To do this, go to Components -> Sociable -> Users and click on the Sync button on the toolbar. The process will show the progress and may take a while depending on the number of users existing on your site. Once the sync is completed, your user profiles are created and assigned default profile according to the profiles that you created.

Setting up the points system

Sociable has a built-in points system that allows you to award points for the actions done on your site. To learn more about how to set up the points system, read the following documentation.