=== Taboola Push Notification ===
Contributors: Taboola Dev Team
Tags: push notifications, taboola, notifications
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 5.4.23
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Send instant browser push notifications through Taboola's platform.

== Description ==

**Taboola Push Notification** enables you to send instant browser push notifications to your audience through Taboola's Epsilon service.

= Key Features =

* **Instant Notifications** - Send notifications immediately to your audience
* **Scheduled Delivery** - Schedule notifications for future delivery
* **Advanced Targeting** - Target audiences by country, region, language, OS, and browser
* **Auto-Send on Publish** - Automatically notify subscribers when publishing new content
* **Custom Notifications** - Create manual notifications with custom titles, messages, and URLs
* **Multi-App Support** - Manage multiple Taboola applications from one dashboard

= How It Works =

1. **Connect** - Configure your Taboola API credentials in plugin settings
2. **Configure** - Set up notification preferences and targeting rules
3. **Send** - Send notifications manually or automatically when publishing posts
4. **Monitor** - Track delivery through Taboola's analytics dashboard

= Third-Party Service =

This plugin integrates with Taboola's Push Notification Service (Epsilon):

* **Service:** Taboola Push Notification Service (Epsilon)
* **URL:** https://pushcms.taboola.com
* **Purpose:** Delivers push notifications to subscribers
* **Data Sent:** Notification content (title, message, URL, icon), targeting segments, scheduling info
* **Authentication:** Requires Taboola Client ID and Client Key
* **Privacy Policy:** https://www.taboola.com/privacy-policy
* **Terms of Service:** https://www.taboola.com/terms-of-service

== Installation ==

= Automatic Installation =

1. Upload the plugin ZIP file via **Plugins > Add New > Upload Plugin**
2. Activate the plugin through the **Plugins** menu
3. Go to **Taboola Push Notifications** in WordPress admin menu

= Configuration =

1. Navigate to **Taboola Push Notifications > Settings**
2. Enter your Taboola API credentials:
   - Client ID
   - Client Key
3. Configure default notification thumbnail (publicly accessible URL)
4. Click **Save Settings**
5. Test the connection by clicking **Refresh Apps**

= Usage =

**Send Manual Notifications:**
1. Go to **Taboola Push Notifications > Settings**
2. Fill in notification title and message (max 140/500 characters)
3. Select target URL and thumbnail
4. Choose target apps and segments
5. Click **Send Notification** (immediate) or schedule for later

**Auto-Send on Post Publish:**
1. Edit any post/page
2. Find "Taboola Push Notifications" meta box
3. Click **Refresh Apps** to load available applications
4. Customize notification content (optional)
5. Click **Send Notification** after publishing

== Frequently Asked Questions ==

= Do I need a Taboola account? =

Yes, you need Taboola API credentials (Client ID and Client Key). Contact Taboola support to obtain your credentials.

= Can I schedule notifications? =

Yes, the plugin supports both immediate and scheduled notifications. Set any future date and time for delivery.

= How do I target specific audiences? =

Use the segments feature to create include/exclude rules based on geography, language, device type, and subscription age.

= What are the character limits? =

* Notification title: Maximum 140 characters
* Notification message: Maximum 500 characters

= Can I send notifications automatically? =

Yes, enable the feature in the post meta box to notify subscribers when publishing new content.

== Screenshots ==

1. Settings page - Configure API credentials and send manual notifications
2. Post meta box - Send notifications directly from post editor
3. Segments editor - Create audience targeting rules

== Changelog ==

= 5.4.23 =
* Current stable release
* All core features operational
* Compatible with WordPress 6.8

= 5.0.0 =
* Initial stable release
* Advanced segment targeting
* Notification scheduling
* Multi-app support

== Upgrade Notice ==

= 5.4.23 =
Current stable version. Fully functional with WordPress 6.8.

== Support ==

For technical support or feature requests, contact Taboola support team.