# Push Notifications for WP – Self Hosted Web Push Notifications

**Contributors:** magazine3  
**Requires at least:** 3.0  
**Tested up to:** 6.8  
**Stable tag:** 1.43  
**License:** GPLv2 or later  
**License URI:** [http://www.gnu.org/licenses/gpl-2.0.html](http://www.gnu.org/licenses/gpl-2.0.html)  
**Tags:** Push, Web Push, Push Notification, Mobile Notification, Desktop Notifications  

Push Notifications for WP makes it easy to send **Web Push notifications** to your users for **FREE** with a simple 2-minute setup.

📖 [Documentation](https://pushnotifications.io/docs/)

---

## 🚀 Description

Automatically send push notifications when a post is published or updated. You can also send **custom push notifications**, access **audience and campaign reports**, and more — all from your WordPress dashboard.

---

## 🔑 Key Features

- **Automatic Notifications**: Instantly notify your followers whenever a new post is published.  
- **Custom Notifications**: Send fully personalized notifications to all or selected subscribers.  
- **Notification Subscription Popup**: Customize when, where, and how the popup appears with support for custom CSS.  
- **Scheduled Notifications**: Schedule notifications to be delivered at a future time.  
- **Supported Browsers**: Chrome, Safari, Edge, Opera, and Firefox (Desktop & Android). HTTPS required.  
- **Notification Design**: Choose from four predefined templates.  
- **Automatic Notification Control**: Select which post types will trigger notifications.  
- **Notification Limit**: Limit the number of notifications sent within a defined timeframe.  
- **Notification by User Roles**: Target users based on their roles (Editor, Subscriber, etc.).  
- **UTM Tracking**: Add UTM parameters to track clicks and performance.  
- **Campaigns List**: View sent campaigns with stats in your dashboard.  
- **Subscribers List**: Full list of active and expired subscribers.  
- **Visibility Controls**: Choose where the subscription popup appears (pages, posts, categories, tags).  
- **PWA Compatibility**: Works with or without PWA, supports PWAforWP and SuperPWA.  
- **Global Notification Function**: Use `pn_send_push_notification_filter` from anywhere in your code.  
- **Shortcode**: Use `[pn_campaigns]` to show campaign lists on the frontend.  
- **Plugin Compatibility**: Works with most plugins. Supported integrations include Polylang, PeepSo, Gravity Forms, BuddyPress/BuddyBoss, and Fluent Community.

---

## 🌟 Pro Features

- **Unlimited Notifications**: Send an unlimited number of push notifications to your subscribers without any restrictions or additional costs.
- **Segmentation**: Let users subscribe based on categories/authors.  
- **iOS Push Notifications**: Available in the Pro version.  
- **Continuous Development**: Regular updates and new features.  
- ...and more coming soon!

---

## 🛠 Support & Contributions

- 🧑‍💻 [Support Forum](https://wordpress.org/support/plugin/push-notification)  
- 📬 [Contact Us](http://pushnotifications.io/contact)  
- 🐛 [Report Bugs](https://github.com/ahmedkaludi/push-notification/issues)  
- ✨ [Request Features](https://github.com/ahmedkaludi/push-notification/issues/new)  
- 🧠 [Contribute on GitHub](https://github.com/ahmedkaludi/push-notification)

---

## 📚 Credits

This plugin uses the following third-party library:

- **Select2** – jQuery replacement for select boxes  
  - [GitHub](https://github.com/select2/select2)  
  - License: MIT  

---

## ❓ FAQ

### How do I install and configure Push Notifications for WP?
Once the plugin is activated, navigate to **Push Notification Options** in your WordPress dashboard. Follow the steps to connect your API and configure settings as per your preferences. Full setup takes under 2 minutes.  
📄 Documentation: https://pushnotifications.io/docs/

### Can I send notifications automatically when I publish a post?
Yes. Once configured, Push Notifications for WP will automatically send a push notification when you publish or update a post, provided automatic notifications are enabled in the settings.

### How do I send a custom push notification?
You can send a custom message at any time via the **Custom Notification** form in the Push Notifications for WP dashboard. Choose the audience, write your message, and send instantly or schedule it for later.

### Is Push Notifications for WP multisite compatible?
Yes. Push Notifications for WP allows you to send push notifications across **network sites** in a multisite installation from a single place.

### How do I report bugs or suggest new features for Push Notifications for WP?
We love feedback! Please report bugs or suggest new features on our GitHub page:  
https://github.com/ahmedkaludi/push-notification/issues  
Or contact us directly: https://pushnotifications.io/contact

### Will you add a feature I request to Push Notifications for WP?
We’re actively improving Push Notifications for WP and prioritize user feedback. You can [submit your feature request on GitHub](https://github.com/Magazine3/Push-Notifications-for-WP/issues) or [contact us directly here](https://pushnotifications.io/contact). We’ll do our best to include your suggestion in a future release.