SurfCoinsChat Community is an independent extension for the free\/community edition of Better Messages.<\/p>\n\n
It keeps Better Messages responsible for conversations and message storage while adding:<\/p>\n\n
\/chat\/<\/code> page.<\/li>\n- Per-user chat background images for users with the standard WordPress
upload_files<\/code> capability.<\/li>\n- Installable PWA manifest and Service Worker support.<\/li>\n
- Explicit opt-in browser Web Push notifications.<\/li>\n
- Adaptive\/event-driven synchronization that reduces background REST traffic and duplicate work across multiple browser tabs.<\/li>\n<\/ul>\n\n
Better Messages is required. The dependency slug is bp-better-messages<\/code>.<\/p>\n\nSurfCoinsChat Community is an independent project and is not affiliated with or endorsed by Better Messages or its developer.<\/p>\n\n
PWA and activation behavior<\/h4>\n\n
The plugin serves \/surfcoins-manifest.webmanifest<\/code> and \/surfcoins-sw.js<\/code>.<\/p>\n\nOn activation, the plugin may create a local WordPress page named \"SurfCoins Offline\" for the offline PWA experience. It also creates its own database tables and local settings used for presence, calls\/signaling, and opt-in push subscriptions.<\/p>\n\n
If the former SurfCoins PWA plugin is installed, deactivate it before using these integrated PWA features so both plugins do not attempt to own the same Service Worker and manifest URLs.<\/p>\n\n
External services<\/h3>\n\n
SurfCoinsChat Community only contacts external network services in specific features described below.<\/p>\n\n
Google STUN for WebRTC<\/h4>\n\n
By default, one-to-one WebRTC calls use the public endpoints stun:stun.l.google.com:19302<\/code> and stun:stun1.l.google.com:19302<\/code>.<\/p>\n\nThese STUN requests occur when a user starts or receives a WebRTC call. They help browsers discover network addresses for peer-to-peer connectivity and may disclose network information such as the user's public IP address to Google. SurfCoinsChat Community does not send chat messages or stored voice-message files to Google.<\/p>\n\n
Service: https:\/\/www.google.com\/\nPrivacy: https:\/\/policies.google.com\/privacy\nTerms: https:\/\/policies.google.com\/terms<\/p>\n\n
Optional administrator-configured TURN<\/h4>\n\n
A site administrator may configure a TURN relay. If a direct peer-to-peer connection cannot be established, call media may be relayed through that configured TURN service.<\/p>\n\n
SurfCoinsChat Community does not choose a third-party TURN provider. The site administrator is responsible for the selected TURN service and for documenting its privacy policy and terms to site users.<\/p>\n\n
Browser Web Push endpoints<\/h4>\n\n
Web Push is disabled until a signed-in user explicitly enables browser notifications and grants permission.<\/p>\n\n
The browser creates a push subscription whose endpoint is operated by the browser or operating-system vendor. SurfCoinsChat Community stores that subscription on the WordPress site and sends encrypted notification payloads directly to the supplied endpoint when a new Better Messages message is sent. No SurfCoins-operated push gateway is used.<\/p>\n\n
Depending on the browser\/device, the endpoint can be operated by services such as Google\/Firebase, Mozilla, or Apple.<\/p>\n\n
Google\/Firebase:\nService: https:\/\/firebase.google.com\/docs\/cloud-messaging\nPrivacy: https:\/\/policies.google.com\/privacy\nTerms: https:\/\/firebase.google.com\/terms<\/p>\n\n
Mozilla:\nService: https:\/\/support.mozilla.org\/kb\/push-notifications-firefox\nPrivacy: https:\/\/www.mozilla.org\/privacy\/firefox\/\nTerms: https:\/\/www.mozilla.org\/about\/legal\/terms\/firefox\/<\/p>\n\n
Apple:\nService: https:\/\/developer.apple.com\/documentation\/usernotifications\/sending-web-push-notifications-in-web-apps-and-browsers\nPrivacy: https:\/\/www.apple.com\/legal\/privacy\/<\/p>\n\n
Users can disable notifications through the SurfCoinsChat interface or their browser\/device settings.<\/p>\n\n
Privacy<\/h3>\n\n
SurfCoinsChat Community stores plugin data on the WordPress site, including:<\/p>\n\n
\n- Transient presence rows per browser installation\/session, including user ID, a random session identifier, conversation ID, temporary activity, activity expiration, and last-seen time. This lets the same account stay active on more than one device without one device overwriting another.<\/li>\n
- Temporary WebRTC call\/signaling records.<\/li>\n
- Opt-in browser push subscriptions.<\/li>\n
- A per-user chat-background URL when the user selects a custom background.<\/li>\n
- Voice-message media attachments only when the user explicitly records and sends them.<\/li>\n<\/ul>\n\n
The plugin registers with the WordPress personal-data Export and Erase tools for its presence data. Presence and push-subscription records are removed when the corresponding WordPress user is deleted. Plugin-owned tables and plugin settings are removed by uninstall.php<\/code> when the plugin is deleted.<\/p>\n\nSite owners should review these behaviors and adapt their privacy policy to applicable requirements.<\/p>\n\n\n
\n- Install and activate Better Messages.<\/li>\n
- Install and activate SurfCoinsChat Community.<\/li>\n
- Open the site's Better Messages chat while signed in.<\/li>\n
- Customize quick replies under SurfCoinsChat > Quick replies, if desired.<\/li>\n
- Configure optional PWA settings under Settings > SurfCoinsChat PWA & Push.<\/li>\n
- For calls across restrictive networks, optionally configure a TURN server.<\/li>\n<\/ol>\n\n
No external account or API key is required for the default STUN configuration.<\/p>\n\n\n
\nDoes this replace Better Messages?<\/h3><\/dt>\nNo. Better Messages remains responsible for conversations, recipients, messages, and its core interface.<\/p><\/dd>\n
Can I customize the quick replies?<\/h3><\/dt>\nYes. Administrators can add, edit, enable or disable, reorder, and restore the default quick replies under SurfCoinsChat > Quick replies. Custom replies are stored as a single WordPress option and do not add a database table or polling request.<\/p><\/dd>\n
Does it require the paid Better Messages WebSocket edition?<\/h3><\/dt>\nNo. The plugin is designed for the Better Messages Community\/free workflow. SurfCoinsChat uses Better Messages 3.x runtime events when available and an adaptive WordPress REST fallback. When the optional SurfCoins WebSocket transport is connected, presence, typing, message wake-ups, one-to-one delivery\/read receipts, and WebRTC call signaling are event-driven while REST remains a reconciliation fallback.<\/p><\/dd>\n
Are voice messages sent to a third party?<\/h3><\/dt>\nNo. When a user explicitly records and sends a voice message, the audio file is uploaded to the same WordPress site and stored as a WordPress media attachment associated with the conversation.<\/p><\/dd>\n
Are voice or video calls recorded?<\/h3><\/dt>\nNo. SurfCoinsChat Community stores temporary call\/signaling metadata on the WordPress site but does not record call audio or video.<\/p><\/dd>\n
Can a site owner use TURN?<\/h3><\/dt>\nYes. Define SURFCOINSCHAT_TURN_URL<\/code>, SURFCOINSCHAT_TURN_USERNAME<\/code>, and SURFCOINSCHAT_TURN_CREDENTIAL<\/code> in wp-config.php<\/code>, or use the surfcoinschat_webrtc_ice_servers<\/code> filter.<\/p><\/dd>\n\n<\/dl>\n\n\n0.6.43<\/h4>\n\n\n- Defers Web Push network delivery to an immediate one-shot WordPress cron task so remote Push latency does not block chat sends.<\/li>\n
- Shows live percentage progress while a recorded voice message uploads.<\/li>\n
- Preserves synchronous fallback if cron scheduling fails and keeps all Better Messages storage\/moderation behavior intact.<\/li>\n<\/ul>\n\n
0.6.42<\/h4>\n\n\n- Turbo voice-message send path with a lean 32 kbps mono recording target to reduce upload size and mobile transfer time.<\/li>\n
- Stores validated voice uploads directly as private WordPress attachments without waiting for unused synchronous media-library metadata generation.<\/li>\n
- Removes the unused synchronous formatted-message rebuild from the voice upload response and lets SurfCoins WebSocket 0.3.2 reconcile the stored message asynchronously.<\/li>\n
- Avoids a competing presence REST request at the exact start of a voice upload while realtime transport is healthy; the previous fallback remains active when WebSocket is unavailable.<\/li>\n<\/ul>\n\n
0.6.37<\/h4>\n\n\n- Renders SurfCoinsWebSocket typing:start\/typing:stop events immediately in the active conversation and thread list instead of waiting for the REST safety poll.<\/li>\n
- Keeps a short-lived in-memory WebSocket activity overlay on top of the latest REST presence snapshot so slower reconciliation responses cannot erase a just-received typing state.<\/li>\n
- Restores the previous online\/last-seen state immediately after typing stops and falls back to a one-shot REST reconciliation only when no baseline snapshot exists yet.<\/li>\n
- Suppresses redundant REST typing activity writes while the persistent WebSocket transport is connected; REST automatically resumes if the socket disconnects.<\/li>\n
- Adds no new endpoint, database table, background task, or persistent timer beyond a bounded cleanup timeout for lost typing:stop frames.<\/li>\n<\/ul>\n\n
0.6.36<\/h4>\n\n\n- Restores real-time online presence and typing activity with Better Messages 3.0.10 by keeping SurfCoinsChat's live presence query independent from Better Messages' durable last-activity lookup.<\/li>\n
- Uses the official Better Messages thread-opened event as an active-thread fallback during React\/fullscreen remounts.<\/li>\n
- Restores the green online marker on the current conversation header avatar and improves Better Messages 3.x avatar targeting.<\/li>\n
- Adds a short typing grace window so brief typing bursts are not missed by adaptive polling while keeping the existing low-load synchronization model.<\/li>\n
- Preserves the durable last-seen fallback from 0.6.35 without adding REST routes, database tables, external services, or background tasks.<\/li>\n<\/ul>\n\n
0.6.35<\/h4>\n\n\n- Adds compatibility tuning for Better Messages 3.0.10 while retaining fallbacks for older Better Messages 3.x releases.<\/li>\n
- Stops installing SurfCoinsChat's legacy Composer draft-race workaround when Better Messages 3.0.8 or newer is active, because Better Messages now fixes that race natively.<\/li>\n
- Keeps the proven bounded one-tap quick-reply emoji safeguard because that programmatic Composer path is separate from Better Messages' newly fixed phone-keyboard\/paste emoji handling.<\/li>\n
- Fixes the one-to-one header status by reusing Better Messages' visible native online-status line instead of inserting a second line that could be clipped by the compact header.<\/li>\n
- Fixes offline last-seen information by combining SurfCoinsChat's real-time presence timestamp with Better Messages' durable
last_activity<\/code> value in batched queries. Real-time \"online now\" still requires a recent SurfCoinsChat session, so general site activity is not misreported as live chat presence.<\/li>\n- Adds no new REST endpoint, table, polling loop, external service, or background task.<\/li>\n<\/ul>\n\n
0.6.34<\/h4>\n\n\n- Fixes drag-and-drop reordering in the Quick replies admin screen. jQuery UI Sortable ignores drags that start on button elements by default; the accessible drag handle is now explicitly allowed to start sorting while form controls remain protected.<\/li>\n
- Improves the visual feedback while a row is being reordered and keeps the saved field indexes synchronized with the new order.<\/li>\n
- Removes a duplicated Quick replies page heading. No front-end chat, REST, database, Push, PWA, presence, voice, or call behavior changes.<\/li>\n<\/ul>\n\n
0.6.33<\/h4>\n\n\n- Fixes a fatal error on the Quick replies administration page caused by calling a non-existent
hidden()<\/code> helper after the reply rows were rendered.<\/li>\n- Uses the native HTML
hidden<\/code> attribute for the empty-state message, preserving the existing admin JavaScript behavior without adding inline scripts or styles.<\/li>\n- No changes to front-end quick-reply sending, REST routes, database tables, Push, PWA, presence, voice, or calls.<\/li>\n<\/ul>\n\n
0.6.32<\/h4>\n\n\n- Adds SurfCoinsChat > Quick replies so administrators can add, edit, enable\/disable, remove, and reorder the one-tap replies.<\/li>\n
- Adds a live admin preview and Restore defaults action while keeping custom replies in one sanitized WordPress option.<\/li>\n
- Adds no new REST endpoint, database table, polling cycle, or front-end background task.<\/li>\n<\/ul>\n\n
0.6.31<\/h4>\n\n\n- Keeps the mobile software keyboard closed when a quick reply is tapped by no longer focusing the Better Messages contenteditable Composer during programmatic insertion.<\/li>\n
- Normalizes emoji presentation selectors when confirming the selected quick reply, fixing the one-tap path for emoji-only suggestions such as \ud83d\udc4d on mobile browsers.<\/li>\n
- Re-signals the native Better Messages input handler during the short bounded send window when a mobile WebView delays contenteditable bookkeeping.<\/li>\n
- Keeps the existing horizontally scrollable quick-reply chips and introduces no REST endpoint, polling cycle, database table, or server-side message path.<\/li>\n<\/ul>\n\n
0.6.30<\/h4>\n\n\n- Fixes one-tap quick-reply sending with Better Messages 3.x by honoring its
aria-disabled<\/code> \/ data-disabled<\/code> button state instead of relying only on the native disabled<\/code> property.<\/li>\n- Binds quick replies to the Composer immediately adjacent to the visible suggestion strip so a covered fullscreen\/background Composer cannot receive the text instead.<\/li>\n
- Makes quick-reply chips non-shrinking, horizontally scrollable pill buttons even when the active Better Messages fullscreen wrapper is outside
.bp-messages-wrap<\/code>.<\/li>\n- No REST endpoint, database, polling, Push, PWA, presence, voice, or call behavior changes.<\/li>\n<\/ul>\n\n
0.6.29<\/h4>\n\n\n- Fixes quick replies on layouts that expose the legacy Better Messages
.bm-send-message<\/code> control so tapping a suggestion sends it immediately instead of only filling the composer.<\/li>\n- Keeps the Better Messages 3.x accented composer action path and waits for React to switch safely from microphone\/idle state before activating it.<\/li>\n
- Strengthens quick-reply chip styling against theme\/button resets, with visible borders, pill-shaped border radius, spacing, and mobile-friendly touch targets.<\/li>\n
- Adds no REST endpoint, polling cycle, database table, or server-side message path.<\/li>\n<\/ul>\n\n
For releases before 0.6.29, see changelog.txt<\/code>.<\/p>","raw_excerpt":"Adds quick replies, presence, read status, voice messages, WebRTC calls, PWA support, and opt-in Web Push to Better Messages Community.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/362807","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=362807"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/naturalsurf"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=362807"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=362807"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=362807"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=362807"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=362807"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=362807"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}