| @@ -1,24 +1,25 @@ | ||
| 1 | 1 | === Taboola === |
| 2 | 2 | Contributors: Taboola |
| 3 | 3 | Tags: content recommendations, taboola, discovery,ad networks, ads, advertising, affiliate, content ads, contextual ads, Contextual Advertising, engagement, income, monetization, monetize, pay per click, popular posts, posts, ppc, related, Related Content, related post thumbnails, related posts, relevant ads, revenue, similar posts, text ads, widgets,recommendations,thumbnails, traffic, widget |
| 4 | -Requires at least: 5.2.x | |
| 5 | -Tested up to: 6.0.2 | |
| 4 | +Requires at least: 5.2 | |
| 5 | +Tested up to: 6.8.0 | |
| 6 | 6 | Stable tag: trunk |
| 7 | 7 | License: GNU General Public License v3.0 |
| 8 | -License URI: https://www.gnu.org/licenses/gpl-3.0.txt | |
| 8 | +License URI: http://www.gnu.org/licenses/gpl-3.0.txt | |
| 9 | 9 | |
| 10 | -Use the Taboola widget to generate revenue from 3rd-party content and increase engagement. | |
| 10 | +Use the Taboola plugin to generate revenue from native ads and drive engagement with editorial content. | |
| 11 | 11 | |
| 12 | 12 | == Description == |
| 13 | -This plugin enables WordPress users to easily integrate Taboola's content recommendation widgets on their site. | |
| 14 | -Generate direct revenue by surfacing Taboola's high quality sponsored content recommendations. | |
| 13 | +This plugin provides an easy way to integrate Taboola content into your WordPress pages. | |
| 14 | +Using Taboola’s mix of sponsored and editorial content, you can generate revenue and drive engagement. | |
| 15 | +(Requires an account with Taboola. For more detail, see the <a href="https://developers.taboola.com/web-integrations/docs/wordpress-plugin/" target='_blank'>Taboola Dev Center</a>.) | |
| 15 | 16 | |
| 16 | 17 | == Installation == |
| 17 | 18 | |
| 18 | 19 | = Requirements = |
| 19 | 20 | * PHP 5.x, 7.x or 8.x |
| 20 | -* WordPress v5.0.x or higher | |
| 21 | +* WordPress 5.x or 6.x | |
| 21 | 22 | |
| 22 | 23 | = Installation Process = |
| 23 | 24 | * Log into the WordPress admin for your site |
| 24 | 25 | * Go to 'Plugins' -> 'Add New' |
| @@ -24,50 +25,86 @@ | ||
| 24 | 25 | * Go to 'Plugins' -> 'Add New' |
| 25 | 26 | * Search for Taboola. Once found click on 'Install Now' |
| 26 | 27 | * Select 'Activate Plugin' from the download page or go to 'Plugins' -> 'Installed Plugins' -> 'Activate Plugin' |
| 27 | 28 | |
| 28 | -= Below Article widgets = | |
| 29 | -* Select 'Settings' -> which will navigate to Taboola's setting page. Or click on the left rail menu item 'Taboola' | |
| 30 | -* Taboola will set up your account and send you the following required information - 'Publisher ID', 'Widget ID' | |
| 31 | -* Enter the 'Publisher ID' and 'Widget ID' received from Taboola | |
| 32 | -* Check the boxes of the relevant widget's you would like to be displayed | |
| 33 | -* Click 'Apply Changes' | |
| 34 | -* Go take a look at your site, the widget is live! | |
| 29 | += Your Taboola widgets = | |
| 30 | +* Find Taboola in the ‘Installed Plugins’ section | |
| 31 | +* Select ‘Settings’ - this will take you to the plugin dashboard. | |
| 32 | +* If you have not already done so, contact Taboola to obtain your specific settings. | |
| 33 | +* Fill in your specific settings, as provided by Taboola. | |
| 34 | +* Your below-article unit will appear directly below your article. Your mid-article unit will appear directly below your chosen paragraph number. | |
| 35 | +* Click ‘Apply Changes’. | |
| 36 | +* The Taboola units should now appear on your article pages. | |
| 35 | 37 | |
| 36 | -= All other widgets = | |
| 37 | -* Go to Appearance -> Widgets | |
| 38 | -* Drag the 'Taboola' widget to where you would like it to be located | |
| 39 | -* Taboola will send you the following required information - 'Widget ID' | |
| 40 | -* Enter the 'Widget ID' you received from Taboola | |
| 41 | -* Click on 'Save' | |
| 42 | -* Go take a look at your site, the widget is live! | |
| 38 | +For more detail, see the <a href="https://developers.taboola.com/web-integrations/docs/wordpress-plugin/" target='_blank'>Taboola Dev Center</a>. | |
| 43 | 39 | |
| 44 | 40 | == Frequently Asked Questions == |
| 45 | 41 | = How do I use Taboola's Plugin? = |
| 46 | -You must first contact us here at Taboola and we will get you started by setting up your account and providing you with your 'Publisher ID' and your 'Widgets ID'. After that all you need to do is download the plugin and get started. | |
| 42 | +Once you have a Taboola account, reach out to us to obtain your specific Taboola settings. You can contact us through Backstage or reach out to your Taboola representative. | |
| 47 | 43 | |
| 48 | -= How quickly does it start working? = | |
| 49 | -Right away! | |
| 44 | += Where do the units appear on my pages? = | |
| 45 | +Taboola works best on article pages - this is where your users are most engaged. Our below-article units appear directly after your content. The plugin manages this for you automatically. For your mid-article widget, choose a paragraph number - the unit will display beneath your chosen location. | |
| 50 | 46 | |
| 51 | -= To generate the highest revenue where should I place widgets on my site? = | |
| 52 | -Directly below articles is the best place to integrate our widget. Once the user has finished reading an article and is looking for something to do next our widget will recommend content that the user is most likely to click on. | |
| 47 | += Can I have additional features, such as video or sticky ads? = | |
| 48 | +Yes, once you have added Taboola to your pages, you can request any other Taboola solution. You can do this in your Backstage account, or by contacting your Taboola representative. These additional solutions are activated by Taboola - no work required from you! | |
| 53 | 49 | |
| 54 | -= Will the widget slow down my site? = | |
| 55 | -No. The Taboola widget loads "asynchronously". This means your page will load independently of the widget script. | |
| 50 | += Can I customize the UI of the Taboola units? = | |
| 51 | +While we have created a UI that we know performs the best, you can make changes. Simply contact us in your Backstage account or reach out to your Taboola representative. These customizations are activated by Taboola - no work required from you! | |
| 56 | 52 | |
| 57 | -= How do I customize the UI of Taboola's widgets? = | |
| 58 | -After hundreds or A/B tests conducted we have reached a UI that outperforms anything else tested against it (on the same amount of real-estate). If you would like to change it please contact us here at Taboola http://taboola.com/contact | |
| 53 | += How can I report security bugs? | |
| 59 | 54 | |
| 55 | +You can report security bugs through the Patchstack Vulnerability Disclosure Program. The Patchstack team help validate, triage and handle any security vulnerabilities. [Report a security vulnerability.](https://patchstack.com/database/vdp/taboola) | |
| 56 | + | |
| 60 | 57 | == Screenshots == |
| 61 | 58 | 1. **Taboola's settings page** |
| 62 | 59 | |
| 63 | 60 | == Changelog == |
| 64 | 61 | |
| 62 | += 2.2.3 = | |
| 63 | +* Small changes to the homepage product integration | |
| 64 | + | |
| 65 | += 2.2.2 = | |
| 66 | +* Added the web push integration functionality and enabled push notifications | |
| 67 | + | |
| 68 | += 2.2.1 = | |
| 69 | +* The webPush scripts have been added to all pages, including Home, Category, and Article pages. | |
| 70 | + | |
| 71 | += 2.2.0 = | |
| 72 | +* Placed the Service Worker in the root directory | |
| 73 | + | |
| 74 | += 2.1.0 = | |
| 75 | +* Resolved the error and warnings | |
| 76 | + | |
| 77 | += 2.0.0 = | |
| 78 | +* Added the SDK script on the blog pages | |
| 79 | + | |
| 80 | += 2.1.1 = | |
| 81 | +* Fixed a bug that sometimes caused the creation of the settings table to fail, for certain MySQL versions | |
| 82 | + | |
| 83 | += 2.1.0 = | |
| 84 | +* Enhanced UI for sidebar units | |
| 85 | +* Security fix (HTML injection vulnerability) | |
| 86 | +* Tested on WordPress 6.3.2 | |
| 87 | + | |
| 88 | += 2.0.2 = | |
| 89 | +* Security fix (CSRF vulnerability) | |
| 90 | + | |
| 91 | += 2.0.1 = | |
| 92 | +* Minor UI improvements | |
| 93 | + | |
| 94 | += 2.0.0 = | |
| 95 | +* Enhanced UI and functionality | |
| 96 | +* Support for below-article, mid-article and homepage widgets | |
| 97 | +* Tested on Wordpress 6.1.1 | |
| 98 | + | |
| 99 | += 1.0.14 = | |
| 100 | +* Additional logging | |
| 101 | + | |
| 65 | 102 | = 1.0.13 = |
| 66 | -* Minor fixes and improvements. | |
| 103 | +* Minor fixes and improvements | |
| 67 | 104 | |
| 68 | 105 | = 1.0.12 = |
| 69 | -* Minor fix for PHP 8.0.x | |
| 106 | +* Minor Fix for PHP 8.0.x | |
| 70 | 107 | |
| 71 | 108 | = 1.0.11 = |
| 72 | 109 | * Support for PHP 8.0.x |
| 73 | 110 | * Tested on Wordpress 6.0.2 |
