Livestream plugin 1.1.0 / Getting started
Install and set up
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.
| Where | What you find | Right after installing |
|---|---|---|
| AdminCP → Site Settings → General Configuration → Livestream | Enable and six more settings | on; see The settings |
| AdminCP → Plugins → Livestream | Livestream Dashboard, Livestream PPV Packages, Livestream Providers | no join prices; Agora chosen but empty |
| AdminCP → Users → Manage User Roles → Permissions of a member role, box Livestream | Allow LIVE, Site Profit, Livestream Cost per Minute | on, 0, 0 for every member role |
| AdminCP → Users → Manage User Roles → Permissions of a moderator role, box Manage Site | Manage Livestream | off |
| AdminCP → Membership → Manage Packages → Plans → a plan | Award Livestream Minutes per Billing Cycle | 0 |
| AdminCP → Design → Manage Menus | a Livestream item in the main menu and in the mobile app menu | active |
| AdminCP → Design → Layout Editor | the 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:
- 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."
- 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).
- 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.
- 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.
- 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) | Section | What changed |
|---|---|---|
| 2026-11-19 | install, set-up | New 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-19 | install | First 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-19 | set-up | First 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-19 | all | Pages reorganised: AdminCP content now has its own pages. |
| 2026-11-19 | install, set-up, remove | Section order: setting up now comes before switching off. |