{"id":11083,"date":"2026-05-26T02:30:04","date_gmt":"2026-05-25T18:30:04","guid":{"rendered":"https:\/\/aeosub.com\/rafaelmarreca-push-dispatch\/"},"modified":"2026-05-26T02:30:04","modified_gmt":"2026-05-25T18:30:04","slug":"rafaelmarreca-push-dispatch","status":"publish","type":"post","link":"https:\/\/aeosub.com\/zh\/rafaelmarreca-push-dispatch\/","title":{"rendered":"RafaelMarreca Push Dispatch for Firebase Cloud Messaging"},"content":{"rendered":"
\n\n\n\n\n\n\n\n
Developer<\/th>\nrafael145a<\/a><\/td>\n<\/tr>\n
Version<\/th>\nv1.0.1<\/td>\n<\/tr>\n
Active Installs<\/th>\n0 +<\/td>\n<\/tr>\n
Requires \/ Tested<\/th>\n5.8 \/ 7.0<\/td>\n<\/tr>\n
Last Updated<\/th>\n2026-05-25 5:56pm GMT<\/td>\n<\/tr>\n
Official Link<\/th>\nView Details \u2192<\/a><\/td>\n<\/tr>\n<\/table><\/div>\n
Send push notifications to mobile apps via Google's Firebase Cloud Messaging \u2014 on post publish or via a notification composer.<\/div>\n

RafaelMarreca Push Dispatch<\/strong> connects your WordPress site to your mobile app by sending notifications through Google’s Firebase Cloud Messaging (FCM HTTP v1) service. No PHP SDK, no Guzzle, no external PHP dependencies \u2014 just the WordPress HTTP API and the OpenSSL extension.<\/p>\n

How it works<\/h4>\n
    \n
  • Uses topic subscriptions<\/strong> \u2014 your mobile app calls subscribeToTopic()<\/code> for each topic it wants to receive. No device tokens are stored, no PII is collected, no extra database tables are created.<\/li>\n
  • When a post is published, the primary category<\/strong> determines the topic name (configurable via Settings \u2192<\/span> RafaelMarreca Push Dispatch).<\/li>\n
  • A dedicated notification composer<\/strong> (custom post type) lets you send manual push notifications with a custom title, body, topic, and optional deep link \u2014 without creating a real post.<\/li>\n<\/ul>\n

    Features<\/h4>\n
      \n
    • OAuth2 JWT authentication (RS256) for FCM HTTP v1<\/li>\n
    • Automatic push on post publish, mapped by category<\/li>\n
    • Manual notification composer with live phone preview and character counters<\/li>\n
    • Deep link support (any custom URL scheme)<\/li>\n
    • OAuth2 access token cached for 55 minutes to minimise round-trips<\/li>\n
    • Service account JSON stored outside the database with .htaccess<\/code> deny + chmod 600<\/li>\n
    • Idempotent dispatch \u2014 republishing never resends<\/li>\n<\/ul>\n

      Requirements<\/h4>\n
        \n
      • A Firebase project with Cloud Messaging enabled<\/li>\n
      • A Firebase service account JSON (downloaded from the Firebase Console)<\/li>\n
      • PHP openssl<\/code> extension (bundled with most hosts)<\/li>\n
      • Your mobile app must call subscribeToTopic()<\/code> for each topic<\/li>\n<\/ul>\n

        Disclaimer<\/h3>\n

        Firebase, Firebase Cloud Messaging and Google are trademarks of Google LLC. This plugin is an independent, third-party integration and is not affiliated with, endorsed by, or sponsored by Google LLC.<\/p>\n

        Service Account Setup<\/h3>\n

        In the Firebase Console: \u2699 Project settings<\/strong> \u2192<\/span> Service accounts<\/strong> \u2192<\/span> Generate new private key<\/strong> \u2192<\/span> download the JSON \u2192<\/span> upload it in the plugin settings.<\/p>\n

        The file is stored in wp-content\/uploads\/rafaelmarreca-push-private\/<\/code> with .htaccess<\/code> deny rules and chmod 600. It is never stored in the database.<\/p>\n

        Mobile App Setup<\/h3>\n

        Your app needs to call subscribeToTopic(getMessaging(), '<topic-name>')<\/code> to receive notifications for a given topic. The Firebase Cloud Messaging v1 API delivers to zero devices if no device is subscribed.<\/p>\n

        Example (React Native \/ Firebase JS SDK):
        \n await messaging().subscribeToTopic(‘all’);<\/p>\n

        External services<\/h3>\n

        This plugin relies on two external services operated by Google LLC in order to deliver push notifications. Both are part of the Google Cloud \/ Firebase<\/strong> platform. The plugin will not send any data to them until you configure it with a Firebase service account JSON and either publish a post (with auto-send enabled), publish a notification via the composer, or click “Send test” on the settings page.<\/p>\n

        1. Google OAuth2 (oauth2.googleapis.com)<\/h4>\n
          \n
        • What it is and what it is used for:<\/strong> Google’s OAuth2 token service. The plugin needs a short-lived access token to authenticate against Firebase Cloud Messaging. To obtain it, the plugin signs a JWT locally with the private key from your service account JSON and exchanges it for an access token.<\/li>\n
        • When data is sent:<\/strong> Once when the cached access token expires (every 55 minutes) and on the first send action.<\/li>\n
        • What data is sent:<\/strong> A POST request to https:\/\/oauth2.googleapis.com\/token<\/code> containing the OAuth2 urn:ietf:params:oauth:grant-type:jwt-bearer<\/code> grant and a signed JWT. The JWT contains your service account’s client_email<\/code>, the scope https:\/\/www.googleapis.com\/auth\/firebase.messaging<\/code>, the audience URL, and issued-at\/expiration timestamps. No WordPress user data, no post content, and no visitor data is sent.<\/strong><\/li>\n
        • Provider:<\/strong> Google LLC<\/li>\n
        • Terms of service:<\/strong> https:\/\/policies.google.com\/terms<\/li>\n
        • Privacy policy:<\/strong> https:\/\/policies.google.com\/privacy<\/li>\n<\/ul>\n

          2. Firebase Cloud Messaging (fcm.googleapis.com)<\/h4>\n
            \n
          • What it is and what it is used for:<\/strong> Google’s push notification delivery service. The plugin uses the FCM HTTP v1 API to publish a notification to a topic that your mobile app has subscribed to.<\/li>\n
          • When data is sent:<\/strong> Every time a notification is dispatched \u2014 that is, when a post is published (with the auto-send option enabled), when a notification is published via the “Notifications” composer, or when the administrator clicks “Send test” on the settings page.<\/li>\n
          • What data is sent:<\/strong> A POST request to https:\/\/fcm.googleapis.com\/v1\/projects\/{your_project_id}\/messages:send<\/code> containing: the destination topic name (e.g. “news”), the notification title (max 65 chars) and body (max 140 chars) you typed or that were extracted from your post, an optional deep link URL (when set in the composer), and the post ID \/ slug \/ category ID as plain identifiers in the data payload. No WordPress user data, no IP addresses, and no device identifiers are sent.<\/strong><\/li>\n
          • Provider:<\/strong> Google LLC<\/li>\n
          • Terms of service:<\/strong> https:\/\/policies.google.com\/terms<\/li>\n
          • Firebase-specific terms:<\/strong> https:\/\/firebase.google.com\/terms<\/li>\n
          • Privacy policy:<\/strong> https:\/\/policies.google.com\/privacy<\/li>\n<\/ul>\n

            By configuring the plugin with your Firebase service account JSON and publishing posts or notifications, you agree to the Google Terms of Service, the Firebase Terms of Service, and the Google Privacy Policy linked above.<\/p>","protected":false},"excerpt":{"rendered":"

            Send push notifications to mobile apps via Google's Firebase Cloud Messaging \u2014 on post publish or via a notification composer.<\/p>","protected":false},"author":1,"featured_media":9317,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"footnotes":""},"categories":[252],"tags":[2070,2071,1020,1906,2072,555],"class_list":["post-11083","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-trends","tag-cloud-messaging","tag-firebase","tag-mobile","tag-push-notifications","tag-topic","tag-wordpress-plugin"],"_links":{"self":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/posts\/11083","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/comments?post=11083"}],"version-history":[{"count":0,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/posts\/11083\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/media\/9317"}],"wp:attachment":[{"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/media?parent=11083"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/categories?post=11083"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/aeosub.com\/zh\/wp-json\/wp\/v2\/tags?post=11083"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}