Rizwan Abbasi

<p>Topic-Based Push Notifications for Firebase enables you to send push notifications from your WordPress admin panel directly to Android mobile applications using Firebase Cloud Messaging (FCM). Perfect for apps that need to notify users about new content, updates, or important announcements.</p>
<h3>Key Features</h3>
<ul>
<li><strong>Topic-Based Targeting</strong>: Send notifications to specific user groups by topic subscription</li>
<li><strong>Rich Notifications</strong>: Support for images, custom links, and detailed messaging</li>
<li><strong>Complete Analytics</strong>: Track delivery rates, engagement, and notification performance</li>
<li><strong>Engagement Tracking</strong>: Monitor when users open notifications with detailed metrics</li>
<li><strong>History Management</strong>: View all sent notifications with filtering and search capabilities</li>
<li><strong>Modern Interface</strong>: Clean, responsive admin interface that works on all devices</li>
<li><strong>Secure Implementation</strong>: Built with WordPress security best practices</li>
</ul>
<h3>How It Works</h3>
<ol>
<li><strong>Setup</strong>: Upload your Firebase service account JSON file and configure topics</li>
<li><strong>Create</strong>: Compose notifications with title, message, optional image, and link</li>
<li><strong>Target</strong>: Select which topics (user groups) should receive the notification</li>
<li><strong>Send</strong>: Deliver notifications instantly to all subscribed Android devices</li>
<li><strong>Track</strong>: Monitor delivery success rates and user engagement in real-time</li>
</ol>
<h3>Perfect For</h3>
<ul>
<li>News and blog websites with mobile apps</li>
<li>E-commerce stores with Android applications</li>
<li>Educational platforms with student mobile apps</li>
<li>Community websites with member applications</li>
<li>Any WordPress site with an Android companion app</li>
</ul>
<h3>What You Need</h3>
<ul>
<li>Firebase project with FCM enabled</li>
<li>Service account JSON file from Firebase Console</li>
<li>Android app configured to receive FCM notifications (topic based). This version doesn’t handle token based notifications.</li>
<li>WordPress 5.0+ and PHP 7.4+</li>
</ul>
<h3>External Services</h3>
<p>This plugin connects to Google’s Firebase services to send push notifications to mobile applications. External service connections are required for the plugin’s core functionality.</p>
<p><strong>Google OAuth API (oauth2.googleapis.com)</strong><br />
* Purpose: Authentication with Firebase Cloud Messaging service<br />
* Data sent: Service account credentials (from your uploaded JSON file), authentication tokens<br />
* When: Every time notifications are sent (to obtain access tokens)<br />
* Terms of Service: https://developers.google.com/terms<br />
* Privacy Policy: https://policies.google.com/privacy</p>
<p><strong>Firebase Cloud Messaging API (fcm.googleapis.com)</strong><br />
* Purpose: Sending push notifications to Android mobile applications<br />
* Data sent: Notification content (title, message, image URLs, links), target topics, FCM project ID<br />
* When: When you send notifications through the plugin interface<br />
* Terms of Service: https://firebase.google.com/terms<br />
* Privacy Policy: https://policies.google.com/privacy</p>
<h3>Privacy & Data</h3>
<p>This plugin processes notification data locally on your WordPress installation. Notifications are sent directly to Google’s Firebase Cloud Messaging service.</p>
<p>No user data is collected or sent to services other than Google/Firebase for notification delivery. Your Firebase service account credentials are stored securely on your server.</p>
<h3>Developers</h3>
<p>The plugin includes hooks and filters for developers to extend functionality:</p>
<ul>
<li><code>tbpn_before_send_notification</code> – Filter notification data before sending</li>
<li><code>tbpn_after_send_notification</code> – Action after notification is sent</li>
<li><code>tbpn_notification_response</code> – Filter FCM response data</li>
<li>REST API endpoint for mobile apps to report engagement</li>
</ul>
<h3>Technical Details</h3>
<h3>System Requirements</h3>
<ul>
<li>WordPress 5.0 or higher</li>
<li>PHP 7.4 or higher</li>
<li>MySQL 5.6 or MariaDB 10.0</li>
<li>SSL certificate (recommended for production)</li>
</ul>
<h3>File Permissions</h3>
<p>The plugin creates a secure upload directory for Firebase service account files. Ensure your WordPress uploads directory is writable.</p>
<h3>Database Tables</h3>
<p>The plugin creates two tables:<br />
* <code>wp_tbpn_notifications</code> – Stores notification history and analytics<br />
* <code>wp_tbpn_engagements</code> – Tracks user engagement with notifications</p>
<h3>REST API Endpoints</h3>
<ul>
<li><code>POST /wp-json/mn/v1/engage</code> – Report notification engagement (for mobile apps)</li>
</ul>
<h3>Hooks for Developers</h3>
<p><strong>Actions:</strong><br />
* <code>tbpn_notification_sent</code> – Triggered after notification is sent<br />
* <code>tbpn_notification_failed</code> – Triggered when notification sending fails<br />
* <code>tbpn_engagement_recorded</code> – Triggered when engagement is recorded</p>
<p><strong>Filters:</strong><br />
* <code>tbpn_notification_data</code> – Filter notification data before sending<br />
* <code>tbpn_topics_list</code> – Filter available topics<br />
* <code>tbpn_max_notifications_per_hour</code> – Filter rate limiting</p>
<h3>Security Features</h3>
<ul>
<li>Nonce verification for all forms</li>
<li>Capability checks for admin actions</li>
<li>SQL injection prevention with prepared statements</li>
<li>XSS prevention with proper output escaping</li>
<li>Secure file upload handling</li>
<li>Rate limiting for notification sending</li>
</ul>
<h3>Support</h3>
<p>For support, feature requests, or bug reports, please use the WordPress.org support forums.</p>
<p>For documentation and updates, visit the plugin homepage.</p>
<h3>Contributing</h3>
<p>This plugin is open source. Contributions, bug reports, and feature requests are welcome on the plugin’s development repository.</p>


Topic-Based Push Notifications for Firebase

Professional WordPress plugin for sending Firebase Cloud Messaging (FCM) push notifications to Android apps with advanced targeting and analytics.

Ivijan-Stefan Stipic

INFINITUM FORM

<p>This FCM Plugin for WordPress is designed to simplify the integration of push notifications to all Android and iOS devices. With ease of use in mind, here’s what you can achieve:</p>
<ol>
<li>
<p><strong>Easy Integration</strong>:</p>
<ul>
<li><strong>Installation</strong>: Simply install the plugin.</li>
<li><strong>Configuration</strong>: Enter your Firebase Server (API) key, generate a site key, and select the post types for notifications.</li>
<li><strong>Compatibility</strong>: Works with both Android and iOS devices and the latest version of WordPress.</li>
</ul>
</li>
<li>
<p><strong>REST API Endpoints for Device Management</strong>:</p>
<ul>
<li><strong>Subscribe Device</strong>: Register devices when the mobile application is launched.</li>
<li><strong>Unsubscribe Device</strong>: Deregister devices when the application is deleted.</li>
<li><strong>Example</strong>: Use the provided endpoints with parameters like <code>rest_api_key</code>, <code>device_uuid</code>, <code>device_token</code>, etc., to manage subscriptions.</li>
</ul>
</li>
<li>
<p><strong>Customizable Notifications</strong>:</p>
<ul>
<li><strong>Categories</strong>: Register devices under specific categories. If a category doesn’t exist, it’ll be created automatically.</li>
<li><strong>Content Types</strong>: Select specific post types for triggering notifications.</li>
</ul>
</li>
<li>
<p><strong>Open Source & Free</strong>: Modify and use without any cost.</p>
</li>
</ol>
<p>Make sure to have a Firebase project and your Firebase Server (API) key before using the plugin. Don’t miss out on important updates, try our FCM push notification plugin today!</p>
<h3>REST API Endpoints</h3>
<h3>Subscribe Device</h3>
<pre><code>https://example.domain/wp-json/fcm/pn/subscribe
</code></pre>
<p>Parameters:<br />
– <code>rest_api_key</code> (required): Unique site key from plugin settings.<br />
– <code>device_uuid</code> (required): Device’s unique ID.<br />
– <code>device_token</code> (required): Device’s token.<br />
– <code>subscription</code> (required): Category name for device registration.<br />
– <code>device_name</code> (optional): Name of the device.<br />
– <code>os_version</code> (optional): Operating system version.</p>
<p>Returns JSON:</p>
<pre><code>{
    "error": false,
    "message": "Device token registered",
    "subscription_id": 123
}
</code></pre>
<p><strong>Unsubscribe device:</strong></p>
<pre><code>https://example.domain/wp-json/fcm/pn/unsubscribe
</code></pre>
<p><strong>Parameters:</strong></p>
<ul>
<li><code>rest_api_key</code> (required): Unique site key from plugin settings.</li>
<li><code>device_uuid</code> (required): Device’s unique ID.</li>
</ul>
<p><strong>Returns JSON:</strong></p>
<pre><code>{
    "error": false,
    "message": "The device token was successfully removed"
}
</code></pre>
<p>This plugin is available as open-source and free of charge, allowing seamless integration with any WordPress setup and offering the flexibility for customization to meet specific needs.1. <strong>Preparation for Use</strong>:<br />
   – Prior to activating the plugin, it’s essential to establish a Firebase project and obtain the corresponding Firebase Server (API) key. This setup links your WordPress site to Firebase, enabling the key functionalities of the plugin.</p>
<ol>
<li>
<p><strong>Unique Site Key Requirement</strong>:</p>
<ul>
<li>Upon installing the plugin, you’ll need to access the plugin settings page to generate a unique site key. This key is crucial for the identification and security of your particular WordPress installation.</li>
</ul>
</li>
<li>
<p><strong>Content-Type Selection for Notifications</strong>:</p>
<ul>
<li>The plugin grants you the flexibility to choose specific types of posts for sending notifications. This allows for a tailored communication strategy, ensuring that users only receive alerts relevant to their interests.</li>
</ul>
</li>
<li>
<p><strong>Device Management via REST API Endpoints</strong>:</p>
<ul>
<li>The plugin utilizes REST API endpoints to manage device registration and deregistration. Your mobile application must be configured to interact with these endpoints, enabling accurate control over the device subscriptions.</li>
</ul>
</li>
<li>
<p><strong>Cross-Platform Compatibility</strong>:</p>
<ul>
<li>Designed to work seamlessly with both Android and iOS devices, this plugin ensures that you can reach your audience regardless of their preferred platform.</li>
</ul>
</li>
<li>
<p><strong>Category-Specific Notification Delivery</strong>:</p>
<ul>
<li>The plugin facilitates sending push notifications to all registered devices for a particular post category. This targeted approach enhances engagement by delivering content-specific alerts.</li>
</ul>
</li>
<li>
<p><strong>Registration Verification Before Notification</strong>:</p>
<ul>
<li>Prior to sending any notifications, the plugin verifies the device’s registration status. This step maintains notification accuracy and avoids sending to inactive or irrelevant devices.</li>
</ul>
</li>
<li>
<p><strong>Compatibility with Latest WordPress Version</strong>:</p>
<ul>
<li>While the plugin aligns with the most recent WordPress version, it’s advisable to check for compatibility to ensure a smooth integration within your specific WordPress environment.</li>
</ul>
</li>
<li>
<p><strong>Customizable Open-Source Software</strong>:</p>
<ul>
<li>Embracing an open-source model, the plugin’s code can be adapted to meet individual requirements. This encourages not only personalized use but also potential community contributions and collaboration.</li>
</ul>
</li>
</ol>


Push Notification FCM

Introducing a seamless framework plugin for Firebase Cloud Messaging (FCM) for Android and iOS developers, to send push notifications globally.

Topic-Based Push Notifications for Firebase vs Push Notification FCM