| @@ -1,59 +1,157 @@ | ||
| 1 | 1 | === Taboola === |
| 2 | 2 | Contributors: Taboola |
| 3 | -Tags: content recommendations, taboola, discovery,ad networks, ads, advertising, affiliate, content ads, contextual ads, Contextual Advertising, engagement, income, monetization, montize, 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: 3.0 | |
| 5 | -Tested up to: 3.9 | |
| 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 | |
| 5 | +Tested up to: 6.8.0 | |
| 6 | 6 | Stable tag: trunk |
| 7 | 7 | License: GNU General Public License v3.0 |
| 8 | 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 organic re-circulation and 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, and boost your site traffic and ad-inventory by recommending content people may like using Taboola personalized 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 | -* PHP 5.2 or higher. | |
| 20 | -* WordPress v3.0.x or higher. | |
| 20 | +* PHP 5.x, 7.x or 8.x | |
| 21 | +* WordPress 5.x or 6.x | |
| 21 | 22 | |
| 22 | 23 | = Installation Process = |
| 23 | -* Taboola will set up your account and send you the following required information - 'Publisher ID', 'Widget ID'. | |
| 24 | -* Log into WordPress admin for your site | |
| 24 | +* Log into the WordPress admin for your site | |
| 25 | 25 | * Go to 'Plugins' -> 'Add New' |
| 26 | 26 | * Search for Taboola. Once found click on 'Install Now' |
| 27 | 27 | * Select 'Activate Plugin' from the download page or go to 'Plugins' -> 'Installed Plugins' -> 'Activate Plugin' |
| 28 | -* Select 'Settings' -> which will navigate to Taboola's setting page. Or click on the left rail menu item 'Taboola' | |
| 29 | -* Enter 'Publisher ID' and 'Widget ID' you received from Taboola and click 'Apply Changes' | |
| 30 | -* Go take a look at your site, the widget is live! | |
| 31 | 28 | |
| 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. | |
| 37 | + | |
| 38 | +For more detail, see the <a href="https://developers.taboola.com/web-integrations/docs/wordpress-plugin/" target='_blank'>Taboola Dev Center</a>. | |
| 39 | + | |
| 32 | 40 | == Frequently Asked Questions == |
| 33 | 41 | = How do I use Taboola's Plugin? = |
| 34 | -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. | |
| 35 | 43 | |
| 36 | -= How quickly does it start working? = | |
| 37 | -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. | |
| 38 | 46 | |
| 39 | -= To generate the highest revenue where should I place widgets on my site? = | |
| 40 | -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 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! | |
| 41 | 49 | |
| 42 | -= Will the widget slow down my site? = | |
| 43 | -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! | |
| 44 | 52 | |
| 45 | -= How do I customize the UI of Taboola's widgets? = | |
| 46 | -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? | |
| 47 | 54 | |
| 48 | -= Can I display a Taboola widget content in a sidebar or footer? = | |
| 49 | -No, this is currently not supported but is planned for the near future. | |
| 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) | |
| 50 | 56 | |
| 51 | 57 | == Screenshots == |
| 52 | -1. **Taboola's settings page.** | |
| 58 | +1. **Taboola's settings page** | |
| 53 | 59 | |
| 54 | 60 | == Changelog == |
| 61 | + | |
| 62 | += 3.0.2 = | |
| 63 | +* Bug Fix related to Simple HTML DOM | |
| 64 | + Error Message"Fatal error: Cannot redeclare function …" | |
| 65 | + | |
| 66 | + | |
| 67 | += 3.0.1 = | |
| 68 | +* Bug Fix related to Mid Article | |
| 69 | + -"Loc_mid empty error" | |
| 70 | +* Bug Fix related to WebPush | |
| 71 | +* Minor Ui Modifications | |
| 72 | + | |
| 73 | + | |
| 74 | += 3.0 = | |
| 75 | +* Added the Category integration functionality and Multiple Mid Article thumbnails. | |
| 76 | +* Added the Homepage integration functionality for Feed | |
| 77 | +* Minor Ui Change | |
| 78 | + | |
| 79 | += 2.2.2 = | |
| 80 | +* Added the web push integration functionality and enabled push notifications | |
| 81 | + | |
| 82 | += 2.2.1 = | |
| 83 | +* The webPush scripts have been added to all pages, including Home, Category, and Article pages. | |
| 84 | + | |
| 85 | += 2.2.0 = | |
| 86 | +* Placed the Service Worker in the root directory | |
| 87 | + | |
| 88 | += 2.1.0 = | |
| 89 | +* Resolved the error and warnings | |
| 90 | + | |
| 91 | += 2.0.0 = | |
| 92 | +* Added the SDK script on the blog pages | |
| 93 | + | |
| 94 | += 2.1.1 = | |
| 95 | +* Fixed a bug that sometimes caused the creation of the settings table to fail, for certain MySQL versions | |
| 96 | + | |
| 97 | += 2.1.0 = | |
| 98 | +* Enhanced UI for sidebar units | |
| 99 | +* Security fix (HTML injection vulnerability) | |
| 100 | +* Tested on WordPress 6.3.2 | |
| 101 | + | |
| 102 | += 2.0.2 = | |
| 103 | +* Security fix (CSRF vulnerability) | |
| 104 | + | |
| 105 | += 2.0.1 = | |
| 106 | +* Minor UI improvements | |
| 107 | + | |
| 108 | += 2.0.0 = | |
| 109 | +* Enhanced UI and functionality | |
| 110 | +* Support for below-article, mid-article and homepage widgets | |
| 111 | +* Tested on Wordpress 6.1.1 | |
| 112 | + | |
| 113 | += 1.0.14 = | |
| 114 | +* Additional logging | |
| 115 | + | |
| 116 | += 1.0.13 = | |
| 117 | +* Minor fixes and improvements | |
| 118 | + | |
| 119 | += 1.0.12 = | |
| 120 | +* Minor Fix for PHP 8.0.x | |
| 121 | + | |
| 122 | += 1.0.11 = | |
| 123 | +* Support for PHP 8.0.x | |
| 124 | +* Tested on Wordpress 6.0.2 | |
| 125 | + | |
| 126 | += 1.0.10 = | |
| 127 | +* Support for PHP 7.4.x | |
| 128 | +* Tested on Wordpress 6.0.1 | |
| 129 | + | |
| 130 | += 1.0.8 = | |
| 131 | +* Renamed internal files | |
| 132 | +* Tested on Wordpress 4.7.3 | |
| 133 | +* Place widget outside of main content element by default (to allow "Read More") | |
| 134 | + | |
| 135 | += 1.0.7 = | |
| 136 | +* Removed excess logs | |
| 137 | + | |
| 138 | += 1.0.6 = | |
| 139 | +* Better impressions reporting | |
| 140 | + | |
| 141 | += 1.0.5 = | |
| 142 | +* Added support for PHP 7 | |
| 143 | + | |
| 144 | += 1.0.4 = | |
| 145 | +* Removed explicit http indication. it will automatically use the protocol from the page | |
| 146 | + | |
| 147 | += 1.0.3 = | |
| 148 | +* Added the ability to manually control where on the page the widget should be located | |
| 149 | + | |
| 150 | += 1.0.2 = | |
| 151 | +* Expanding the integration use cases that the template supports | |
| 152 | + | |
| 55 | 153 | = 1.0.1 = |
| 56 | 154 | * Added ability to place additional widgets on a page |
| 57 | 155 | |
| 58 | 156 | = 1.0 = |
| 59 | -* Initial release. | |
| 157 | +* Initial release | |
