Installation

Download and install the plugin

1. Download the Taboola Web Push Notifications plugin ZIP file from your Taboola account manager or technical contact.

2. In your WordPress dashboard, select Plugins (left sidebar).

3. Click on Add New Plugin (top), and then Upload Plugin.

4. Click on Choose File (center) and browse for the .ZIP file that you downloaded:

   

5. Click on Install Now:

   

6. If you already have a previous version installed, WordPress displays a comparison of the 2 versions.

   Click on Replace current with uploaded.

7. Once the installation is complete, WordPress displays a message:

   Plugin installed successfully or Plugin updated successfully

8. If you have not yet activated the plugin, click on Activate Plugin.

9. In the sidebar, you'll now see Taboola Push Notification (left) - this is your main plugin menu.

Requirements

• WordPress 5.0 or higher
• PHP 7.4 or higher
• SSL certificate (HTTPS) - Required for push notifications in production
• Modern browser with push notification support

Configuration

Initial setup

After installing and activating the plugin:

1. In your WordPress dashboard, select Taboola Push Notification → Notification Settings (left sidebar).
2. Check Enable Push Notifications to activate the plugin functionality.
3. Configure your Taboola Push Notification Server Authentication credentials (see below).
4. Click Save Settings to apply your configuration.

Authentication settings

To connect your WordPress site to Taboola's push notification service:

Taboola Push Notification Server Authentication

1. Client ID: Enter your unique client identifier provided by Taboola.
2. Client Key: Enter your secret client key provided by Taboola.

📘

Getting credentials

Contact your Taboola account manager or technical team to obtain your Client ID and Client Key for push notification authentication.

The plugin uses these credentials to authenticate with Taboola's push notification server at https://pushcms.taboola.com.

Usage

Dashboard overview

The plugin provides several admin pages accessible from Taboola Push Notification in your WordPress sidebar:

• Dashboard: Main overview and status
• Notification Settings: Configuration and manual sending

Sending manual notifications

Basic manual notification

1. Go to Taboola Push Notification → Notification Settings.
2. Expand the Send Manual Notification section.
3. Configure your notification:

Targeting options

• Send To App: Choose which app to target:
  • All Apps - Send to all configured applications
  • Specific app IDs (if configured)
  • Default App (33536) - Fallback option

Notification content

• Notification Title (required): The headline that appears in the push notification
• Notification Message (required): The body text of the notification
• Target URL (required): Where users go when they click the notification
  • Choose from dropdown: Custom URL, Homepage, or recent posts/pages
  • Or enter a custom URL manually
• Icon URL (optional): Custom icon for the notification (leave empty for default)

Scheduling options

• Send immediately: Default behavior - notification sends right away
• Schedule: Check the box and select a future date/time to schedule the notification

4. Click Send Notification to send immediately or schedule for later.

Advanced targeting

The plugin supports segment-based targeting through the Segments button, which allows you to:

• Target specific user segments
• Include/exclude based on:
  • Countries and regions
  • Languages
  • Operating systems
  • Browsers
  • User subscription age
  • Custom user lists

Automatic notifications for posts

When creating or editing posts, you can automatically send push notifications:

1. Create or edit a post in WordPress.
2. Look for the Taboola Push Notification meta box (usually in the sidebar or below the editor).
3. Check the option to send a push notification when the post is published.
4. Customize the notification:
   • Title (defaults to post title)
   • Message (defaults to post excerpt or content preview)
   • URL (automatically uses the post permalink)
5. Publish or update the post - the notification will be sent automatically.

Monitoring and status

Plugin status indicators

The settings page shows real-time status for:

• Push Notifications: Enabled/Disabled
• Authentication: Configured/Not Configured

Success and error messages

The plugin provides feedback for all operations:

• Success messages: Green notifications when operations complete successfully
• Error messages: Red notifications with specific error details
• Validation warnings: Yellow warnings for configuration issues

Configuration options reference

General settings

Authentication settings

Notification content settings

Advanced targeting options

Troubleshooting

Common issues

Push notifications not working

1. Check HTTPS: Push notifications require SSL/HTTPS in production
2. Verify credentials: Ensure Client ID and Client Key are correct
3. Check plugin status: Confirm "Enable Push Notifications" is checked
4. Browser permissions: Users must grant notification permission

Authentication errors

1. Verify credentials: Double-check your Client ID and Client Key
2. Contact Taboola: Ensure your credentials are active and properly configured
3. Check connectivity: Verify your server can reach https://pushcms.taboola.com

Notifications not received

1. Test with different browsers: Try Chrome, Firefox, Safari
2. Check user permissions: Users must have granted notification permission
3. Verify targeting: Ensure you're targeting the correct app/segments
4. Review notification content: Ensure title and message are not empty

Testing notifications

Local testing

1. Enable the plugin and configure basic settings
2. Visit your website in a new browser or incognito window
3. Grant notification permission when prompted by the browser
4. Send a test notification from the admin panel
5. Verify receipt - the notification should appear in your browser

Production testing

1. Ensure HTTPS is properly configured
2. Configure proper VAPID keys (if required by your setup)
3. Test with multiple browsers and devices
4. Monitor delivery rates through Taboola's reporting tools

Getting help

For technical support with the plugin:

• Plugin issues: Contact your WordPress developer or hosting provider
• Taboola integration: Contact your Taboola account manager or technical team
• Server authentication: Contact Taboola technical support for credential issues

API integration

Server endpoints

The plugin communicates with these Taboola endpoints:

• Authentication: https://authentication.taboola.com/authentication/oauth/token
• Push service: https://pushcms.taboola.com

Authentication flow

The plugin uses OAuth 2.0 client credentials flow:

POST https://authentication.taboola.com/authentication/oauth/token?
client_id={client_id}&client_secret={client_secret}&grant_type=client_credentials

Access tokens are cached for 1 hour and automatically refreshed as needed.

Notification payload

Notifications sent to the push service include:

• Title and message: User-defined content
• Target URL: Destination when notification is clicked
• Icon: Notification icon URL
• App IDs: Target application identifiers
• Segments: Targeting criteria (optional)
• Execution time: For scheduled notifications (optional)

---

Plugin Version: 5.0.0
Author: [email protected]
License: GPL v2 or later