PinPress Messaging Plugin

Real-Time Direct Messages for Your Community

A complete DM system for WordPress. Private conversations with read receipts, typing indicators, online status, and instant delivery via Pusher — with a graceful polling fallback.

How It Works

Instant Delivery, Always

Pusher delivers messages in milliseconds. When Pusher isn't configured, PinPress automatically falls back to efficient polling — your users never notice.

User sendsREST API call
Server triggersPusher event
Recipient getsInstant delivery
Read receiptAuto-tracked

Pusher Transport

RECOMMENDED

WebSocket-based real-time delivery. Messages arrive in milliseconds.

  • Sub-second delivery
  • Typing indicators (Pusher-only)
  • Private channels per user
  • Auto-reconnect
  • Scales to thousands of users

Polling Fallback

NO CONFIG NEEDED

Works out of the box. Efficient delta-polling (only new messages since last check).

  • Zero external dependencies
  • Configurable interval (default 10s)
  • Delta queries (no redundant data)
  • Batches read receipts + messages
  • Works on shared hosting
Features

Everything You Expect from a Modern Messenger

Built for community platforms, creator networks, and marketplaces. Every feature is production-ready.

Private Conversations

Two-person direct messages with implicit conversation creation on first message. Every participant is securely scoped to their own messages.

Real-Time Delivery

Pusher-powered instant delivery with private channels per user. Automatic polling fallback ensures messages always arrive, even without Pusher.

Read Receipts

Automatic read tracking with last-read timestamps. Recipients see exactly when their messages were read — delivered in real-time.

Typing Indicators

See when the other person is typing. Lightweight (no DB writes), rate-limited to 20/min, and delivered via Pusher private channels.

Online Status

Track user online status with a 5-minute activity window. Users appear online, away, or offline based on their last heartbeat.

Pin Sharing

Share PinPress pins directly inside messages. The receiver sees a rich preview with thumbnail, title, and a link back to the pin.

Unread Badges

Per-conversation and aggregated unread counts. Sidebar badge updates in real-time as new messages arrive.

Edit & Delete

Senders can edit messages within 5 minutes or soft-delete at any time. Deleted messages show a placeholder, preserving conversation flow.

Native Notifications

Integrates with the core PinPress notification system. Duplicate prevention (60-second window) stops notification spam.

Safety & Moderation

Keep Your Community Safe

Built-in tools for users to protect themselves and for admins to moderate abuse — without a single extra plugin.

Per-Conversation Blocking

Users can block bad actors in one conversation without affecting their other chats. Blocks prevent message sending via REST permission checks.

Message Reporting

One-click report with reason selection. Reports queue up in the admin panel. 60-second duplicate prevention stops spam reports.

Admin Moderation Queue

Dedicated moderation submenu. Admins can review pending reports, dismiss false flags, or soft-delete offending messages.

Strict Permission Checks

Every REST endpoint requires login + conversation participation. Users can't read or write messages in conversations they're not part of.

Built Right

Developer-Friendly REST API

Every messaging feature is exposed via a clean, documented REST API. Build mobile apps, custom integrations, or extend the UI.

11+ REST EndpointsFull CRUD + actions
Nonce ProtectedCSRF-safe by default
Paginated ResponsesEfficient at scale
ConfigurableAdmin settings panel
Clean CleanupAuto-purge on user delete
Rate LimitingTransient-based throttle
WordPress HooksExtend via actions/filters
Zero DependenciesPusher optional via CDN

Add Real-Time Messaging in Minutes

PinPress Messaging is included in every ThemeForest purchase. No extra fees, no per-message costs, no vendor lock-in.