ShaunSocial docs ShaunSocial user guide
Version 1.5.6
  • 1.5.6 (this version)

ShaunSocial user guide 1.5.6 / Monetisation

Advertising

AdminMember

With Advertising, members and business pages pay to show a post to more people: they create an ad campaign or boost a post they already wrote, choose who should see it and set a daily budget, and the ad appears as a sponsored post in other members' feeds. This page shows admins the settings, prices and the Manage Advertisings screen, and how to sell an ad-free membership; it shows members how to create a campaign, boost a post and read the results.

How this page was checked

Checked against the 1.5.6 code. The AdminCP screens and the member steps (creating, boosting, pausing and completing a campaign) were read from the code, not run; screenshots follow.

What ads are#

Last updated: 2026-11-17 · v1.5.6

An ad is a post marked Sponsored that your site places between the other posts of the home feed, the Discovery and Watch pages and the post search results, after every few posts (every 3 after installing). Members manage their campaigns on the Ads page (https://example.com/advertisings, the Ads entry of the main menu).

  • Who sees an ad: signed-in members who match its targeting (gender, age, hashtags, location) and whose role has Show ads on. Visitors who are not signed in see only ads without any targeting. Nobody sees their own ads in the feed. Ads that were shown least so far come first, so each one gets its turn.
  • What counts: every time the ad is placed in someone's feed counts as a view; a click is counted when someone opens the sponsored post, once per member for the whole campaign (for visitors who are not signed in, once per internet connection).
MoneyHow it works
At launchthe whole budget is paid at once from the eWallet: daily budget × number of days, plus VAT when your site charges it. The member enters their password
Each daythe campaign uses its budget at the price per view and per click your site set when it was created. When it reaches the daily budget, it is not shown again that day
At the endwhat was not used (the budget minus what was spent) goes back to the eWallet. The VAT is not refunded

Ads are paid from the eWallet only (see the eWallet page).

For your server administrator

Daily spending, the daily reports, ending campaigns and refunds are handled by the scheduled task (cron job), which runs every minute. Without it, campaigns keep showing past their budget and are never closed or refunded. See What stops when the cron job does not run.

Ads settings and Manage Advertisings#

Admin

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

Ads settings#

The settings save as soon as you change them (see Settings save themselves).

SettingAfter installingWhat it does
Enableonoff: the Ads menu entries are switched off, members cannot create or manage campaigns, and no ads are shown. Running campaigns are not paid back at once: each one closes on its end date and its unused budget is refunded then
VAT (%)0added on top of the budget when a member pays for a campaign
Min daily budget10the lowest daily budget a member can enter, in your eWallet credits
Price per click0.02what one click costs the advertiser
Price per view0.01what one view costs the advertiser
Position of the active ads will appear on the feed. (Please enter value from 3 to 10).3an ad appears after every this many posts. The last number of the label is your Item per page setting (10 after installing, see The other General Settings). Enter a value from 3 to that number; anything else counts as 3

The VAT and the two prices are fixed for a campaign when it is created: changing them affects new campaigns only.

The Ads campaign card of General Configuration after installing: Enable on, VAT 0, Min daily budget 10, Price per click 0.02, Price per view 0.01 and the feed position 3
AdminCP → General Configuration, the Ads campaign part: Enable, VAT, the minimum daily budget, the two prices and the feed position. Screenshot taken 2026-11-17.

Manage Advertisings#

Super admins see this screen; a moderator role needs Manage Advertisings (see Moderator roles). It lists every campaign, newest first, with Username, Name, Created, Date (start and end) and Status (Active, Stopped, Completed). Filter by status, user name, campaign name, start date and end date, and click Search.

ActionWhat it does
Reportsthe campaign's days with Views, Clicks and Total spent for each finished day
Stoppauses an active campaign, after you confirm. The advertiser gets the notification "stopped your ads." and can switch it back on, so use Complete to end a campaign for good. For a boosted post, use Complete (or ask the advertiser to pause it themselves): after Stop here, the post stays hidden from the feeds as an ordinary post until the campaign is completed
Enablestarts a stopped campaign again
Completeends the campaign now and refunds the unused budget to the advertiser's eWallet; the advertiser gets "completed your ads."

Members report a sponsored post like any other post (see How members report); deleting the post also ends its campaign and refunds the unused budget.

The Advertisings list with the status, user name, name and date filters, and Sofia Rossi's active campaign Autumn menu launch with Reports, Stop and Complete
AdminCP → Core Features → Advertising → Manage Advertisings with the sponsored ad of the demo site and its Reports, Stop and Complete actions. Screenshot taken 2026-11-17.

Creating a campaign#

Member

Last updated: 2026-11-17 · v1.5.6

Click Ads in the main menu, then Create new advertising. A business page creates ads while you are switched to it, paid from the page's eWallet.

  1. The ad: enter the Ads Name (for your own list, up to 255 characters) and the Ads Text, and add photos, one video or attachments if you like. An ad without media needs a text.
  2. Demographics & Targeting features: leave everything open to reach everyone, or narrow it:
    • Gender: All or one gender.
    • Age: Any, or Age Range with From and To (To must be higher).
    • Target hashtags: members interested in these hashtags (the ones they follow and the posts they opened).
    • Location: one or more countries. With a single country you can narrow it to a state, city or ZIP code; with more than one country you cannot.
    Members who did not give their gender, birthday or location never see ads that target it; the more you narrow, the fewer people see the ad.
  3. Budget & Scheduling: the Daily budget (at least your site's minimum) and the Date Range (Start Date and End Date, today or later). The Payment summary shows the number of days, the Total budget, the Estimated VAT and the Total amount.
  4. Payment method: Ewallet, with your balance; Add funds opens your eWallet. Tick the terms when your site shows them and click Launch Campaign, then enter your password.

    What you should see: "Thank you, your payment has been processed and your ad is scheduled to run now. You can manage all your ads in the ads section." With too little balance you see "You don't have enough balance.".

Emma Carter's Create Ads page with the ad name, text and one photo, the targeting, a daily budget of 10 and a seven-day date range, the Ads Preview, the Payment summary of 70.00 shau and the eWallet payment method
The Create Ads page: the ad text and photo, the targeting, the daily budget and dates, and the Payment summary. Screenshot taken 2026-11-17.

Follow and manage your campaigns#

The Ads page lists your campaigns with Views, Clicks and Total spent; filter by Status (All, Active, Stop, Done). Click a campaign to see its Ad Summary (the sponsored post, the dates and the targeting) and one line per day with Views, Clicks and Total spent.

  • Status: the coloured dot on each campaign opens Active (start again), Pause (stop showing it for now) and Complete (end it now and get the unused budget back). Paused days are not spent, and their budget comes back at the end.
  • Edit (the pencil) changes the name, the text and media and the targeting of a campaign that is not completed. The dates and the budget cannot be changed: complete the campaign and create a new one.
  • Notifications: "Your ad campaign is active now." when it starts, "Yesterday your ads led to … view(s) and … click(s)." every day it runs, and "Your ads is completed." when it ends and the unused budget is back in your eWallet.
Sofia Rossi's campaign Autumn menu launch: three finished days with Views, Clicks and Total spent, and the Ad Summary with the sponsored post, dates, targeting and Payment summary
A campaign's page: the Ad Summary with the sponsored post and the daily Views, Clicks and Total spent. Screenshot taken 2026-11-17.

Boosting a post#

Member

Last updated: 2026-11-17 · v1.5.6

Boosting turns a post you already published into an ad, with its likes and comments.

  1. Open the post's … menu and choose Boost Post. For a post of a business page you run, the site switches you to the page first.

    What you should see: the Boost Post page.

  2. Enter the Ads Name, set the targeting and the budget and dates as for a new campaign (see Creating a campaign), tick the terms when shown, click Boost Post and enter your password.

    What you should see: the same "Thank you, your payment has been processed …" message as for a new campaign.

  • Text, photo, link, video and file posts on your own timeline can be boosted; shared posts and posts in groups, events and similar places cannot, and a post can run one campaign at a time.
  • While the campaign runs, the post is shown as a sponsored post instead of as an ordinary post; it is back to normal when you pause or complete the campaign. If a site admin stopped the campaign, the post comes back when the campaign is completed: choose Complete on the Ads page.
  • The campaign is listed and managed on the Ads page like any other.
The Boost Post page for Emma Carter's golden hour photo post: the ad name, the targeting, a daily budget of 10 and a seven-day date range, the Ads Preview and the Payment summary
The Boost Post page for a photo post with the targeting, the budget and the Payment summary. Screenshot taken 2026-11-17.

Ad-free membership#

Admin

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

The role permission Show ads decides whether a member sees ads; it is on for every role after installing. Combine it with a membership package to sell an ad-free experience:

  1. Create a member role for the paying members, for example Premium, with the permissions of your normal member role (see Create a role).
  2. In AdminCP → Users → Manage User Roles → Permissions of that role, under Ads, switch Show ads off (see The permissions of a member role).
  3. Create a membership package that gives this role, with a plan and its price, and show it on the pricing table (see Create a package).

    What you should see: members who subscribe stop seeing ads at once; when their membership ends they fall back to the package's downgrade role and see ads again.

Show ads concerns the ad campaigns described on this page. The Google AdMob ads inside the mobile apps are switched separately and are shown to every app user (see Ads in the apps).

The "Go ad-free with Premium" block#

The ShaunSocial download contains a ready-made invitation block, the file ad-free.html at the top level of the package. It shows the title "Go ad-free with Premium", the line "Upgrade for a completely ad-free, smoother experience" and a Subscribe button.

  1. Open ad-free.html in a text editor and copy its content. Replace href="#" with the address of your Compare plans page, href="/membership", so the button leads there.
  2. In AdminCP → Design → Layout Editor, add an Html Block to the page and column where you want it (for example the right column of the home page), paste the content and save (see Add, change and remove blocks).

    What you should see: the block on that page, with the Subscribe button opening the Compare plans page.

The home page with the Go ad-free with Premium block and its Subscribe button at the top of the right column, above Suggested Users
The Go ad-free with Premium block in the right column of the home page. Screenshot taken 2026-11-17.

Change log#

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

Date (GMT+7)SectionWhat changed
2026-11-17allFirst version for 1.5.6, written from the 1.5.6 code as a guide for members and site admins.
2026-11-17overview, admin, create-campaign, boost-post, ad-free-membershipCorrections after review: how visitors' clicks are counted, state, city and ZIP only with a single country, what an AdminCP Stop does to a boosted post, the menu path of the ad-free section.
2026-11-19admin, ad-free-membershipThe full label of the ad position setting and where its last number comes from; the ads in the mobile apps are not affected by Show ads.