Gift plugin 1.1.0 / Getting started
Install and set up
This page is for admins: how to install Gift, what you find right after installing, the first steps to take before members start using it, how to upgrade from Gift 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 Gift 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: the feature is off and the catalogue is empty. Gift does not switch receiving on for any member role by itself: you choose the roles that may receive gifts. Follow Set up Gift.
| Where | What you find | Right after installing |
|---|---|---|
| AdminCP → Site Settings → General Configuration → Gift | Enable and Platform fee (%) | off, 0 |
| AdminCP → Plugins → Gift → Manage Gifts | the gift catalogue | empty |
| AdminCP → Users → Manage User Roles → Permissions of a member role, box Gift | Allow gift receiving | off until you choose the roles that may receive gifts |
| AdminCP → Users → Manage User Roles → Permissions of a moderator role, box Gift | Manage Gifts | off |
| On the site: Settings → Privacy | the View my gifts switch | on for every member |
Upgrading from Gift 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, gifts, permissions and the gifts already sent stay as they were.
- The platform fee is now taken from the receiver's share. The sender pays the gift's price; the receiver gets the price minus the fee, and the site gets the fee. For example, a 20-token gift with a 10% fee gives the receiver 18 and the site 2. Check your fee after upgrading, because receivers now get less than the price when it is not 0.
- The gift count sits on the profile's line of posts, following and followers ("3 gifts received").
- Sending from a post is now in the post's options menu, and the send window, the gift list and the received-gifts list follow the site's look and dark mode.
- A received gift whose sender deleted their account now shows under "Deleted user".
Set up Gift#
Last updated: 2026-11-19 · v1.1.0
After installing, the feature is off and the catalogue is empty, and you decide which members may receive gifts. Do these steps once:
- Make sure members can add funds to their eWallet (see Wallet settings and Payment gateways in the ShaunSocial guide).
- Add some gifts in AdminCP → Plugins → Gift → Manage Gifts (see Manage the gift catalogue).
- Choose the Platform fee (%) the site keeps, or leave it at 0 (see Who pays, who receives, and the fee).
- Choose the member roles that may receive gifts: switch on Allow gift receiving for each of them (see Permissions). Gift does not switch receiving on for any member role by itself.
- Switch on Enable in AdminCP → Site Settings → General Configuration → Gift.
What you should see: after reloading the site, a gift button on the profiles of members who may receive gifts.
Switching it off or removing it#
Last updated: 2026-11-19 · v1.1.0
- To stop gifts for a while, switch off Enable (see The settings) or click Disable in the plugin manager. The gift catalogue and the record of gifts sent are kept. Money already moved stays where it is.
- Uninstall in the plugin manager deletes the catalogue, the record of gifts sent and received, the settings and the permissions. The eWallet payments made for gifts 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) | 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 Gift" (from the former page "Set up and use Gift"). |
| 2026-11-19 | install | First version for Gift 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 | install | Clearer wording: choosing which member roles may receive gifts is the admin's decision after installing. |
| 2026-11-19 | set-up | First version for Gift 1.1.0, written from the 1.1.0 code. No gift was sent while writing: the payments, the fee and the messages were read from the code, not run. Screenshots from a demo site running Gift 1.1.0 where the feature and the receiving permission were already switched on. |
| 2026-11-19 | set-up, permissions | Clearer wording: choosing which member roles may receive gifts is the admin's decision; Gift does not switch it on for any role by itself. |
| 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. |