ShaunSocial docs Calling plugin
Version 1.1.0
  • 1.1.0 (this version)

Calling plugin 1.1.0 / Getting started

Install and set up

Admin

This page is for admins: how to install Calling, what you find right after installing, the first steps to take before members start using it, how to upgrade from Calling 1.0.0, and how to switch it off or remove it.

Install and switch it on#

Last updated: 2026-11-19 · v1.1.0

You install Calling like every other plugin: upload its zip in AdminCP → Plugins → Manage. The steps, the messages you may see, and how to switch a plugin off or remove it are in Install a plugin in the ShaunSocial guide.

After installing, members see nothing yet: calls are switched off and the call service is not connected. Follow Set up Calling.

WhereWhat you findRight after installing
AdminCP → Site Settings → General Configuration → CallingEnable, Voice Calls, Video Calls and three more settingsall three switches off
AdminCP → Plugins → Calling → Provider Settingsthe Agora App ID and App Certificateempty
AdminCP → Plugins → Calling → Calling Dashboardtotals and the list of callsempty
AdminCP → Users → Manage User Roles → Permissions of a member role, box Callingwho may call, and the price per minutecalls allowed for every member role, price 0 (free)
AdminCP → Membership → Manage Packages → Plans of a paid packageVoice Free Minutes and Video Free Minutes on each plan0

Upgrading from Calling 1.0.0#

Upgrade ShaunSocial to 1.5.6 first, then upload the 1.1.0 zip as described in Upgrade a plugin. Your settings, prices, free minutes, provider details and call history stay as they were.

  • The call buttons, the ringing window, the call screen, the small floating call, the call summary and the call cards in chat follow the site's look and dark mode.
  • A missed call notification now reads "… tried to call you." or "… tried to call you on video." and opens Chat.
  • The member who pays now sees what the call cost in the summary at the end of the call.
  • A call charges only the whole minutes the member's eWallet covers, and free minutes already used in a call are not charged again when it ends.
  • Free call minutes start again with each renewal of the member's membership.
  • The two calling screens of the AdminCP now need the Manage Calling permission (see Permissions and prices per role).

Set up Calling#

Last updated: 2026-11-19 · v1.1.0

After installing, calls are switched off and the call service is not connected. Every member role may call and every price is 0, so once you switch calls on they are free until you set prices. Do these steps once:

  1. Create an account with Agora and a project, and copy its App ID and App Certificate into AdminCP → Plugins → Calling → Provider Settings (see Connect the call service).
  2. Decide whether calls are free or paid. For paid calls, set Payment Responsibility (see The settings) and the price per minute of each member role (see Permissions and prices per role). Make sure members can add funds to their eWallet (see Wallet settings and Payment gateways in the ShaunSocial guide).
  3. Optional: give membership plans free minutes (see Free minutes in membership plans).
  4. Switch on Enable and at least one of Voice Calls and Video Calls in AdminCP → Site Settings → General Configuration → Calling.

    What you should see: after reloading the site, a phone button (voice) and a camera button (video) at the top of a chat with another member.

Members can call only someone they already chat with, once both have accepted the conversation (see Call a member).

Switching it off or removing it#

Last updated: 2026-11-19 · v1.1.0

  • To stop calls for a while, switch off Enable (see The settings) or click Disable in the plugin manager. The call history and the call cards in chats are kept. Money already paid for calls stays where it is.
  • Uninstall in the plugin manager deletes the call history, the free minutes of the plans, the settings and the permissions, and removes the call cards from members' chats. The eWallet payments made for calls stay in members' eWallet history. It cannot be undone (see Uninstall a plugin).

Change log#

Last updated: 2026-11-19 · v1.1.0

Date (GMT+7)SectionWhat changed
2026-11-19install, set-upNew page. Its sections were moved here unchanged, with links to other pages updated: "Install and switch it on" (from the home page); "Set up Calling" (from the former page "Set up Calling").
2026-11-19installFirst version for Calling 1.1.0, written from the 1.1.0 code. The install, upgrade and uninstall steps were read from the code, not run.
2026-11-19set-upFirst version for Calling 1.1.0, written from the 1.1.0 code. No call was made while writing: the charges, the free minutes and the messages were read from the code, not run.
2026-11-19screenshotsScreenshots from a demo site running Calling 1.1.0 where calls were switched on and the Member role had prices of 2 and 3; the member screens (call buttons, ringing window, call screen, call cards) were not captured because no call can be made on the demo site.
2026-11-19allPages reorganised: AdminCP content now has its own pages.
2026-11-19install, set-up, removeSection order: setting up now comes before switching off.