MessageGlobe for WordPress

The official WordPress & WooCommerce plugin for MessageGlobe — send SMS, sync your users into MessageGlobe lists, and deliver every WordPress email over SMTP.

English · Italiano

MessageGlobe for WordPress connects your site to the MessageGlobe messaging platform and does three jobs, each optional:

• Reliable email — route every wp_mail() (password resets, WooCommerce receipts, form notifications) through MessageGlobe SMTP for better deliverability.
• SMS notifications — text customers and staff on the events that matter, with a built-in WooCommerce integration.
• Contact sync — add your users (email + phone) to a MessageGlobe list, filtered by role.

A single API token from the developers dashboard powers everything. The plugin is built on the official MessageGlobe PHP SDK, talks to the API through WordPress' own HTTP layer (no raw cURL), and queues outgoing messages so the checkout and registration flows never block on the network.

Table of contents

• Features
• Requirements
• Installation
• Configuration
• Email deliverability (SMTP)
• SMS notifications
• WooCommerce
• User → list sync
• Settings & logs
• Security & privacy
• How it works
• Development
• FAQ
• License

Features

Requirements

• WordPress 5.8+
• PHP 7.4+
• A MessageGlobe account and an API token
• WooCommerce is optional — its features activate automatically when it is present

Installation

From a release (recommended)

1. Download messageglobe-x.y.z.zip from the latest release — not the "Source code" archive (that one excludes bundled dependencies and won't run).
2. In WP Admin go to Plugins → Add New → Upload Plugin, choose the zip, click Install Now, then Activate.

The release zip bundles all dependencies (vendor/), so nothing needs Composer on the server.

From source (developers)

git clone https://github.com/Message-Globe/messageglobe-wp.git wp-content/plugins/messageglobe
cd wp-content/plugins/messageglobe
composer install

Then activate MessageGlobe for WordPress from the Plugins screen.

Configuration

Open the MessageGlobe menu in wp-admin and paste your API token from the developers dashboard. One token authorises every REST feature (SMS, contacts, lists, sender IDs).

For production you can keep the token out of the database entirely by defining it in wp-config.php — it then takes precedence and is shown read-only in the UI:

define( 'MESSAGEGLOBE_API_TOKEN', 'XX|your-api-token' );

Email deliverability (SMTP)

Enable Email in settings to route every wp_mail() through MessageGlobe. The plugin configures WordPress' own mailer via the phpmailer_init hook — it never loads a second mail library — and can either use the MessageGlobe preset (host, port and the API token as the SMTP password) or your own SMTP host with TLS/SSL/none encryption. A Test connection button connects and authenticates without sending, a Send test email button confirms end-to-end delivery, and failures are recorded in the activity log.

SMS notifications

Enable SMS and pick a default sender ID (loaded live from your account) and gateway:

• HQ — custom sender ID and delivery reports.
• LQ — no custom sender, no delivery report.

Messages are handed to the async queue, so nothing you trigger during a page request waits on the API. Non-GSM characters (emoji, Cyrillic, …) are detected and sent as Unicode automatically. A Send test SMS button is available in settings.

WooCommerce

When WooCommerce is active, two extra features appear:

• Customer order SMS — a message per order status (processing, completed, on-hold, cancelled, refunded), each with its own on/off switch and template. Works with both classic and block checkout.
• New-order admin alert — an SMS to one or more staff numbers when an order is placed.

Templates support these tags:

User → list sync

Enable Sync, choose a target MessageGlobe list (loaded live from your account), and tick the user roles to sync. Matching users are added to the list — with their email, phone and name — on registration, role change, and profile update.

• The phone number is read from a configurable user-meta key, defaulting to billing_phone (where WooCommerce stores it).
• Every sync is queued on WP-Cron and is idempotent per list: a user is added once, not on every profile save.
• Sync all existing users now — a one-click bulk action on the Sync tab adds every in-scope user to the list with a live progress bar, skipping anyone already synced.

Settings & logs

Everything lives under one MessageGlobe admin page with tabs for Connection, SMS, Email, WooCommerce, Sync and Logs. Each messaging tab has a one-click test button, and the Logs tab shows recent SMS/email/sync activity with statuses so you can see exactly what was sent and why anything failed. A separate Recent background runs table summarises each async SMS-queue drain (processed / sent / failed / remaining).

Security & privacy

• The API token is stored in a single option, or — more securely — in the MESSAGEGLOBE_API_TOKEN constant, which is never written to the database.
• All admin forms and AJAX actions are nonce-protected and capability-checked (manage_options); all output is escaped and all input sanitised.
• The plugin only sends the data you configure (message text, recipient numbers, and the contact fields you choose to sync) to MessageGlobe. Nothing is shared with any other third party.

How it works

• PHP SDK, WordPress transport. REST calls go through the bundled MessageGlobe PHP SDK, wired to a transport that uses wp_remote_request() — so requests honour your site's proxy settings and HTTP filters instead of raw cURL.
• Async by default. Outgoing SMS and contact syncs are written to a small custom table and drained by a WP-Cron worker with retry/backoff, so page requests return immediately.
• Modular. Each feature (Email, SMS, WooCommerce, Sync, Admin) is an isolated module wired together at a single composition root.

Development

composer install          # install dependencies
php -l messageglobe.php    # lint (repeat per file, or use a linter)

Releases are automated: pushing a vX.Y.Z tag runs .github/workflows/release.yml, which installs production dependencies, builds the natively-installable messageglobe-X.Y.Z.zip (a messageglobe/-rooted tree with vendor/ bundled) and attaches it to the GitHub Release. A manual run of the workflow uploads the same zip as an artifact for testing, and an optional input drops the bundled PHPMailer (WordPress core already provides it) to avoid class collisions.

FAQ

Do I need a MessageGlobe account? Yes — create one and copy your API token from the developers dashboard.

Does it work without WooCommerce? Yes. SMTP email, SMS and user sync work on any WordPress site; the WooCommerce features simply appear when WooCommerce is active.

Where is my API token stored? In a WordPress option, or in the MESSAGEGLOBE_API_TOKEN constant in wp-config.php (recommended for production), which is never written to the database.

My SMS/emails aren't sending immediately. They are queued and processed by WP-Cron. On low-traffic sites you may want a real system cron calling wp-cron.php for prompt delivery.

License

Released under the GPL-2.0-or-later license. Built on the MIT-licensed MessageGlobe PHP SDK.