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

Livestream plugin 1.1.0 / Getting started

Install and set up

Admin

This page is for admins: how to install Livestream, what you find right after installing, the first steps to take before members start using it, how to upgrade from Livestream 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 Livestream 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, the feature is on and the Livestream menu items are visible, but nobody can go live until you connect Agora. Streaming is free for hosts and the site keeps nothing from paid lives until you change the role values. Follow Set up Livestream.

WhereWhat you findRight after installing
AdminCP → Site Settings → General Configuration → LivestreamEnable and six more settingson; see The settings
AdminCP → Plugins → LivestreamLivestream Dashboard, Livestream PPV Packages, Livestream Providersno join prices; Agora chosen but empty
AdminCP → Users → Manage User Roles → Permissions of a member role, box LivestreamAllow LIVE, Site Profit, Livestream Cost per Minuteon, 0, 0 for every member role
AdminCP → Users → Manage User Roles → Permissions of a moderator role, box Manage SiteManage Livestreamoff
AdminCP → Membership → Manage Packages → Plans → a planAward Livestream Minutes per Billing Cycle0
AdminCP → Design → Manage Menusa Livestream item in the main menu and in the mobile app menuactive
AdminCP → Design → Layout Editorthe pages "Livestream" and "Livestream Detail", and the block "Following — Live Now"the block placed beside the livestream list

Upgrading from Livestream 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, Agora details, join prices, permissions and livestreams stay as they were. What changes:

  • Manage Livestream is taken away from member roles. Version 1.0.0 had also switched it on for member roles, so a moderator role created from Member got it automatically. After the upgrade only moderator roles keep it. Check your moderator roles afterwards and switch it on again where it is needed (see Permissions).
  • The livestream pages, the create page, the profile, search and Lists tabs use the site's standard look and follow dark mode.
  • A host who schedules a live can choose the front or back camera; it is used again when they press Start LIVE, and it can be changed under Edit Schedule.
  • A live started before its scheduled time is shown as happening, no longer as upcoming.
  • Reminders before a scheduled live arrive at the right time on every server.
  • Hashtag search finds every livestream with that hashtag.

Set up Livestream#

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

After installing, the feature is on, every member role may go live, streaming is free and the site keeps nothing from paid lives. The only thing missing is the video service. Do these steps once:

  1. Create a project in your Agora account and copy its App ID and App Certificate into AdminCP → Plugins → Livestream → Livestream Providers (see Connect the streaming service).

    What you should see: on the site, Go Live opens the form with a camera preview instead of "Live streaming has not been configured yet. Please contact the administrator."

  2. Decide which member roles may go live, what a minute of streaming costs them and what share of paid lives the site keeps (see Permissions, and Payments, fees and earnings for the exact money rules).
  3. If hosts may sell paid lives, create the join prices they can choose (see Join prices for paid lives). Without at least one active price, members can only start free lives.
  4. Check the settings (see The settings): the number of viewers per live, the reminder, the automatic end of lives that were never started, the default cover, and gifts in the live room.
  5. Optional: give free streaming minutes with a membership plan (see Free streaming minutes in a membership plan).

Switching it off or removing it#

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

  • To stop livestreams for a while, switch off Enable (see The settings) or click Disable in the plugin manager. The livestreams, join prices and settings are kept. Money already moved stays where it is.
  • Uninstall in the plugin manager deletes every livestream with its viewers and invitations, the join prices, the settings, the permissions, the menu items and the layout pages. Money already moved stays in members' eWallets. 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 Livestream" (from the former page "Set up and manage Livestream").
2026-11-19installFirst version for Livestream 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 Livestream 1.1.0, written from the 1.1.0 code. No live was started and no payment was made while writing: the provider check, the limits and the messages were read from the code, not run. Screenshots from a demo site running Livestream 1.1.0 with Agora already connected; the Agora fields were emptied in the picture.
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.