পণ্যের অংশে চলে যান
LCPanelলাইসেন্স সেন্টার প্যানেল
BXP BoxPuff টি অধ্যায়

BoxPuff ডকুমেন্টেশন

নিউজলেটার

নিউজলেটার বা সার্ভিস ই-মেইল লিখুন, পাঠকদল বাছুন, ক্রন ব্যাচে পাঠায়; সাবস্ক্রাইব ও আনসাবস্ক্রাইব পেজ; মেম্বারের তথ্য CSV-তে রপ্তানি। ফ্রি।

প্লাগইন হালনাগাদ ৬ নভে ২০২৬ ২৫ / ৫০

The Newsletters plugin lets you write to your members: a marketing newsletter to those who want one, or a service e-mail (a maintenance notice, a change of terms) to everybody. You pick the audience, press Send, and the cron works through the list in batches so a shared host never chokes on ten thousand mails at once. A public subscribe page collects addresses from people who are not members, every mail carries an unsubscribe link, and a CSV export gives you member data for other tools. Since version 1.1.0 a campaign can go by e-mail, by SMS, on WhatsApp or by all three, to members whose phone number is confirmed and who have not asked to stop.

Who it is for

Any site with more than a handful of members. A yearly "what's new" mail, a premium offer before a holiday, or a warning that the server moves on Sunday night.

Switching it on

Newsletters is free and works with every licence; a fresh install switches it on. Otherwise open Admin → Extensions → Plugins (Manage Plugins) and switch it on. Three pages appear under Extensions:

  • Manage Newsletters (/admin/plugin/newsletters)
  • Create Newsletter (/admin/plugin/newsletters/create)
  • Export User Data (/admin/plugin/newsletters/export)

The three pages are grouped under one Newsletters entry of the menu, and a fourth, the campaign Report, opens from a button on the list. The plugin also adds a Newsletter link to the site footer, the public pages /newsletter_subscribe, /newsletter_unsubscribe and /newsletter_phone_stop, the tables bp_newsletters, bp_newsletter_queue and bp_newsletter_subscribers, a Text messages tab in the member's account settings, and the cron job Newsletters: send queue (newsletters_send, every minute). On a site updated from 1.0.0 the columns it needs for phone sending (channel, phone_body, phone, and phone_marketing on users) are added the first time the plugin loads.

Mail goes out through the site's own sending method (Configuration → E-mail & Templates → Sending, PHP mail or SMTP), wrapped in the site's e-mail frame. Test that first. SMS and WhatsApp go out through the gateways of SMS & WhatsApp; a way that is not ready there is skipped, and the page tells you so when you press Send.

Writing one

Create Newsletter (or Create Service Email on the list page, which preselects the type):

  • Type - Newsletter (marketing) goes only to members who have marketing e-mails ticked in their account, plus the subscribers; Service e-mail (everyone) goes to every active member, including those who opted out.
  • Title (internal) - for your list.
  • Subject - placeholders {name} and {site_name} work.
  • Send to - All registered accounts, Free accounts only, Paid accounts only, Newsletter subscribers (non-members too), or one package by name (Premium accounts only and so on). The help line shows about how many recipients "all" means right now.
  • Send by - E-mail (the default), SMS, WhatsApp or E-mail, SMS and WhatsApp. The help line counts the people each way reaches right now.
  • Message (HTML) - the body, with {name}, {email}, {site_name}, {site_url} and {unsubscribe}. The site's header and footer are added around it.
  • Text for SMS / WhatsApp (plain text) (phone_body) - used for the phone ways. Empty takes the e-mail text without its HTML. {name}, {site_name} and {site_url} work. Under the box a count says how many characters it is now and how many SMS parts that makes (160 plain letters a part, 70 when it holds Bengali or other non-Latin letters), before the frame below adds the site name and the stop link.

Save it as a draft. Temporary (trial) accounts and accounts without an e-mail address are never written to by e-mail.

By phone

A phone message is the text above put into the message template Newsletter by SMS / WhatsApp (newsletter, under SMS & WhatsApp → Templates; by default {site_name}: {body} and, on its next line, Stop these messages: {unsubscribe}). Edit that template to change the frame for every campaign (SMS & WhatsApp). Here {unsubscribe} is the member's own one-click stop link.

A member is written to by SMS or WhatsApp only when all of these hold: the account is active and not temporary; it belongs to the Send to audience (All, Free, Paid or one package - Newsletter subscribers are e-mail only and are not reached by phone); a phone number is saved and confirmed (the number was verified by a code and has not been changed since); and, for a Newsletter, the member has not stopped text messages. A Service e-mail goes to the confirmed numbers of everyone, opted out or not. A number shared by two accounts gets the message once.

Every phone message costs money, so read the help line before you press Send, and try the campaign on yourself first.

Sending

On Manage Newsletters every mail has its date, title, subject, type, audience and status. The buttons:

  • Test to me - sends the rendered mail to your own address, marked [TEST].
  • Test to my phone (on a campaign that goes by SMS, WhatsApp or all) - sends the phone text, marked [TEST], to the number saved in your own account, on each phone way the campaign uses. It works even while sending is switched off. The editor has the same as Save & test to my phone, next to Save draft and Save & send. If your account has no phone number it says so.
  • Send - works out the recipient list, queues one row per address or number and sets the status to sending. The cron then sends E-mails per cron run (50 by default) and Text messages per cron run (20 by default, SMS and WhatsApp together) every minute until the queue is empty and the status becomes complete. The status column counts sent / total and any failures, and for a phone campaign adds a line per way (E-mail 40/40 · SMS 12/15 (3 failed)). A way that is not ready under Messaging queues nothing, and the message after you press Send says which.
  • Report - the campaign's own page, below.
  • Pause and Resume - stop and restart a mail that is going out.
  • Send again - re-queue a finished mail.
  • Delete - removes the mail and anything still queued for it.

A member who unsubscribed never gets a newsletter again; service e-mails still reach them.

The Report page

Report (/admin/plugin/newsletters/campaign?id=<number>) shows the campaign's title, status and way, a table By way with Queued, Waiting, Sent and Failed for e-mail, SMS and WhatsApp, then the SMS log and WhatsApp log (the last fifty messages of this campaign, with the number masked, the text, any error and the status) and a Failed table - way, address or number, and the reason - for the thirty latest failures. A wrong number, an empty gateway balance and an unapproved sender show up here first.

Stopping text messages

Phone news is opt-out, and every member can stop it in two ways:

  • Account settings → Text messages (/account/edit?tab=phone-news, shown when SMS or WhatsApp is ready) shows the masked number with Verified or Not verified and one box, Send me news and offers by SMS and WhatsApp. It is on until the member unticks it and saves.
  • Every phone newsletter carries a link, /newsletter_phone_stop?u=…&t=…, signed for that member. One tap switches it off, and the page says that messages about the account (codes, payments) are not affected.

The choice is the column phone_marketing on the user. It stops Newsletters, not Service e-mails, and it never affects sign-in codes.

Subscribers

/newsletter_subscribe is a small form (name, e-mail) anyone may use; a honeypot field turns bots away quietly. Subscribing while signed in also ticks the member's marketing switch. /newsletter_unsubscribe takes an address (and the signed token the mail carries) and marks it unsubscribed. The list page shows how many are subscribed and unsubscribed.

Export User Data

Choose the Included columns (Email Address, Title, First Name, Last Name, Username, Account Type, Account Status, Date Created, Paid Expiry Date, Last Payment Date), the group By account type (all, free, paid, moderator, admin) and whether to Include unsubscribed. Export CSV downloads users-<date>.csv, UTF-8 with a BOM so Excel opens Bengali names correctly.

Settings

The plugin's own options:

  • E-mails per cron run (50) - how many go out each minute. Keep it under your host's hourly sending limit (50 a minute is 3,000 an hour).
  • Text messages per cron run (phone_batch_size, 20) - SMS and WhatsApp together, each one a paid message, so this keeps a big campaign from going out in a burst and from spending the gateway's balance in one minute.
  • From name - empty = the site name.
  • Footer text - added under every mail; the default is You receive this because you have an account on {site_name}. {unsubscribe}. If you leave {unsubscribe} out, an unsubscribe line is added anyway.

Tips

  • Send yourself a test first; it is the only way to see the mail inside the frame. For a phone campaign press Test to my phone too, and read the SMS part count.
  • Keep a phone text short and in one script: a single Bengali letter turns an SMS into the 70-letter kind, and each part is a message you pay for.
  • Use a Service e-mail only for things members must know. Sending marketing as a service mail is what gets a domain blacklisted.
  • The cron line must be in place for anything to go out (Scheduled jobs); the page heartbeat alone is too slow for a mailing.
  • SMTP through a real mail service (with SPF and DKIM set for your domain) lands in inboxes; PHP mail() from a shared host often lands in spam.
  • The export is for your own tools; keep the file private, it is personal data.
এটি কি কাজে লেগেছে?
এই অধ্যায়টি শেয়ার করুন