| @@ -1,13 +1,14 @@ | ||
| 1 | 1 | === Datafeedr API === |
| 2 | 2 | |
| 3 | 3 | Contributors: datafeedr.com |
| 4 | -Tags: woocommerce, datafeedr, affiliate products, dfrapi, import csv, import datafeed, import data feed, data feed, datafeed, import affiliate products | |
| 4 | +Tags: import csv, import datafeed, data feed, datafeed, import affiliate products | |
| 5 | 5 | License: GPLv2 or later |
| 6 | 6 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 7 | +Requires PHP: 7.4 | |
| 7 | 8 | Requires at least: 3.8 |
| 8 | -Tested up to: 5.7-alpha | |
| 9 | -Stable tag: 1.0.125 | |
| 9 | +Tested up to: 7.1 | |
| 10 | +Stable tag: 1.4.3 | |
| 10 | 11 | |
| 11 | 12 | Connect to the Datafeedr API. |
| 12 | 13 | |
| 13 | 14 | == Description == |
| @@ -13,11 +14,11 @@ | ||
| 13 | 14 | == Description == |
| 14 | 15 | |
| 15 | 16 | > **Important** |
| 16 | 17 | |
| 17 | -> The *Datafeedr API* plugin requires that you have an active Datafeedr API Product subscription. [Purchase Subscription](https://members.datafeedr.com/subscribe?utm_campaign=dfrapiplugin&utm_medium=referral&utm_source=wporg) | |
| 18 | +> The *Datafeedr API* plugin requires that you have an active Datafeedr API Product subscription. [Purchase Subscription](https://datafeedr.me/pricing). | |
| 18 | 19 | |
| 19 | -The Datafeedr API provides access to our database of affiliate products. We have aggregated over 500,000,000 products from over [10,000+ merchants and 30+ affiliate networks](https://datafeedr.me/networks). We have indexed and normalized the product data making it easy for you to search for and find products you want to promote on your website. | |
| 20 | +The Datafeedr API provides access to our database of affiliate products. We have aggregated over 950,000,000 products from over [27,000+ merchants and 35+ affiliate networks](https://datafeedr.me/networks). We have indexed and normalized the product data making it easy for you to search for and find products you want to promote on your website. | |
| 20 | 21 | |
| 21 | 22 | The *Datafeedr API* plugin currently integrates with the following plugins: |
| 22 | 23 | |
| 23 | 24 | * [Datafeedr WooCommerce Importer](https://wordpress.org/plugins/datafeedr-woocommerce-importer/) |
| @@ -34,15 +35,20 @@ | ||
| 34 | 35 | * View your API account usage. |
| 35 | 36 | |
| 36 | 37 | The *Datafeedr API* plugin was built to be extended. The *Datafeedr API* plugin contains its own functions that third party developers can use to connect to the Datafeedr API, make search requests or display an 'advanced search' form. We encourage other developers to build on top of the *Datafeedr API* plugin. |
| 37 | 38 | |
| 38 | -Additionally, we have written plugins that integrate the *Datafeedr API* plugin with WooCommerce. More extensions are on the way... | |
| 39 | +Additionally, we have written plugins that integrate the *Datafeedr API* plugin with WooCommerce. | |
| 39 | 40 | |
| 41 | +*For personal-use only. Please contact us if you have any questions.* | |
| 42 | + | |
| 40 | 43 | **Requirements** |
| 41 | 44 | |
| 42 | -* PHP's `CURL` support must be enabled. | |
| 43 | -* PHP Version 7.2 (or greater). | |
| 44 | -* WordPress site with HTTPS (SSL/TLS) enabled. | |
| 45 | +* PHP 7.4 or greater | |
| 46 | +* MySQL version 5.6 or greater | |
| 47 | +* [WordPress memory limit of 256 MB or greater](https://codex.wordpress.org/Editing_wp-config.php#Increasing_memory_allocated_to_PHP) | |
| 48 | +* PHP's `CURL` enabled | |
| 49 | +* WordPress Cron enabled | |
| 50 | +* [HTTPS support](https://wordpress.org/news/2016/12/moving-toward-ssl/) | |
| 45 | 51 | |
| 46 | 52 | == Installation == |
| 47 | 53 | |
| 48 | 54 | This section describes how to install and configure the plugin: |
| @@ -66,8 +72,240 @@ | ||
| 66 | 72 | 3. Merchant selection |
| 67 | 73 | 4. Account usage overview |
| 68 | 74 | |
| 69 | 75 | == Changelog == |
| 76 | + | |
| 77 | += 1.4.3 - 2026/10/05 = | |
| 78 | +* Security: The search form AJAX handler now requires a valid nonce and the `edit_posts` capability (filterable via `dfrapi_search_form_capability`). Previously any logged-in user could call it. | |
| 79 | +* Security: Search form AJAX now only accepts numeric network and merchant IDs. | |
| 80 | +* Security: All requests to the Datafeedr API now use HTTPS. | |
| 81 | +* Security: Requests to the Effiliation API now use HTTPS. | |
| 82 | +* Security: The Import page no longer unserializes objects. Imported network and merchant data is validated before it is saved. | |
| 83 | +* Security: Network affiliate IDs and tracking IDs, merchant IDs and Configuration settings are now sanitized when saved. | |
| 84 | +* Security: Escaped network names, merchant names, affiliate IDs, tracking IDs, saved search form values, API error messages and the API query display in the WordPress Admin Area. | |
| 85 | +* Security: The merchant search box on the Merchants page and in the search form popups no longer renders names as HTML. | |
| 86 | +* Security: "Delete Cached API Data" and "Test Connection" on the Tools page now require the `manage_options` capability (filterable via `dfrapi_tools_capability`). | |
| 87 | +* Security: The Awin API token is now sent in an Authorization header instead of the URL. | |
| 88 | +* Security: Image downloads no longer disable SSL certificate verification when retrying a failed download. | |
| 89 | +* Security: Added direct file access protection to remaining PHP files. | |
| 90 | +* Datafeedr API admin notices and the Datafeedr support (HelpScout Beacon) link are now only shown to users with the `manage_options` capability. | |
| 91 | +* Removed unused settings registrations from the Tools and Export pages. | |
| 92 | +* Fixed fatal errors when an XML API response cannot be parsed and when displaying certain API errors on the Merchants page. | |
| 93 | +* Fixed API errors on the Networks and Merchants pages displaying "Array" instead of the error details. | |
| 94 | +* Added `dfrapi_sanitize_setting_text()`, `dfrapi_sanitize_networks_option()` and `dfrapi_sanitize_merchants_option()` helper functions. | |
| 95 | + | |
| 96 | += 1.4.2 - 2026/06/26 = | |
| 97 | +* Fixed Awin merchant list failing with a misleading credentials error when Awin's API rate limit (20 requests/minute) was hit. The joined-programs list is now cached, and a 429 response triggers a short back-off instead of re-calling Awin on every page load. | |
| 98 | +* Added the Awin joined-programs cache and rate-limit back-off transients to the "Delete Cached API Data" tool so they can be purged. | |
| 99 | + | |
| 100 | += 1.4.1 - 2026/05/04 = | |
| 101 | +* Fixed Deprecated notice for dfrapi_admin_notice() function. | |
| 102 | + | |
| 103 | += 1.4.0 - 2026/03/23 = | |
| 104 | +* Added support for Amazon's Creators API program. | |
| 105 | + | |
| 106 | += 1.3.25 - 2025/02/12 = | |
| 107 | +* Updated API Version selection to "stable" and "beta" and disabled the "beta" option as it's not currently available. | |
| 108 | + | |
| 109 | += 1.3.24 - 2025/02/10 = | |
| 110 | +* Fixed drop down for Merchant Limit search filter | |
| 111 | + | |
| 112 | += 1.3.23 - 2025/02/10 = | |
| 113 | +* Added support for PriceRunner | |
| 114 | + | |
| 115 | += 1.3.21 - 2024/12/17 = | |
| 116 | +* Added support for GiddyUp network | |
| 117 | + | |
| 118 | += 1.3.20 - 2024/11/08 = | |
| 119 | +* Added support for API version r6 (beta) | |
| 120 | +* Fixed dynamically calling class properties error message | |
| 121 | +* Added support for new networks | |
| 122 | +* Fixed sorting of networks on networks page | |
| 123 | +* Updated "tested up to" version | |
| 124 | + | |
| 125 | += 1.3.19 - 2024/07/05 = | |
| 126 | +* Fixed "tested up to" version | |
| 127 | + | |
| 128 | += 1.3.18 - 2024/07/05 = | |
| 129 | +* Updated "tested up to" value | |
| 130 | + | |
| 131 | += 1.3.17 - 2024/02/29 = | |
| 132 | +* Updated "tested up to" value | |
| 133 | + | |
| 134 | += 1.3.16 - 2023/11/10 = | |
| 135 | +* Updated "tested up to" value | |
| 136 | + | |
| 137 | += 1.3.15 - 2023/05/02 = | |
| 138 | +* Added public property to `Dfrapi_Account` class. | |
| 139 | + | |
| 140 | += 1.3.14 - 2023/05/01 = | |
| 141 | +* Prevent merchants.js from loading in Customizer view. | |
| 142 | + | |
| 143 | += 1.3.13 - 2023/04/26 = | |
| 144 | +* Added "Stock Quantity" as a search option to the Product Sets search form. | |
| 145 | + | |
| 146 | += 1.3.12 - 2023/03/27 = | |
| 147 | +* Increase network and merchant caching time from one day to one month. | |
| 148 | + | |
| 149 | += 1.3.11 - 2023/02/16 = | |
| 150 | +* Removed outdated "Date Created" sort by options from search form. | |
| 151 | + | |
| 152 | += 1.3.10 - 2023/02/08 = | |
| 153 | +* White space and spelling fixes. | |
| 154 | + | |
| 155 | += 1.3.9 - 2023/01/06 = | |
| 156 | +* Removed `array_multisort()` from Effiliation and Partnerize admin notices because of "inconsistent array sizes" errors. | |
| 157 | + | |
| 158 | += 1.3.8 - 2022/11/28 = | |
| 159 | +* Added support for TimeOne affiliate network. | |
| 160 | +* Added support for Partnerize Sweden. | |
| 161 | +* Fixed bug where `Dfrapi_SearchForm::ajaxHandler()` method was returning all merchants when `$value` was empty. | |
| 162 | + | |
| 163 | += 1.3.7 - 2022/10/28 = | |
| 164 | +* Updated "tested up to" values. | |
| 165 | + | |
| 166 | += 1.3.6 - 2022/10/21 = | |
| 167 | +* Added PHP url host to options array in DatafeedrApi constructor to provide better usage analytics. | |
| 168 | + | |
| 169 | += 1.3.5 - 2022/08/23 = | |
| 170 | +* Added support for Partnerize France. | |
| 171 | +* Added support for Partnerize Denmark. | |
| 172 | + | |
| 173 | += 1.3.4 - 2022/07/15 = | |
| 174 | +* Added SKU (`sku`) as a searchable field in the Product Sets search form. | |
| 175 | + | |
| 176 | += 1.3.3 - 2022/07/11 = | |
| 177 | +* Updated readme. | |
| 178 | +* Update links to new member's website. | |
| 179 | + | |
| 180 | += 1.3.2 - 2022/05/09 = | |
| 181 | +* Added support for new affiliate network: [Addrevenue](https://addrevenue.io/). | |
| 182 | + | |
| 183 | += 1.3.1 - 2022/03/21 = | |
| 184 | +* Added `dfrapi_get_fields_from_product()` function. | |
| 185 | +* Added `dfrapi_get_install_plugin_url()` function. | |
| 186 | +* Added `dfrapi_get_activate_plugin_url()` function. | |
| 187 | +* Added `dfrapi_plugin_is_installed()` function. | |
| 188 | +* Added `dfrapi_parse_plugin_path()` function. | |
| 189 | +* Replaced some conditionals with ternary operator. | |
| 190 | + | |
| 191 | += 1.3.0 - 2022/02/16 = | |
| 192 | +* General code refactor and file rearranging. | |
| 193 | +* Updated API usage over 90% notice. | |
| 194 | +* Updated Missing affiliate IDs notice. | |
| 195 | +* Updated No networks selected notice. | |
| 196 | +* Updated No merchants selected notice. | |
| 197 | +* Added User account data helper functions. | |
| 198 | +* Removed all functionality from Env file. | |
| 199 | +* Moved functions and actions into appropriate files. | |
| 200 | +* Fixed undefined index related to "adservice_mid". | |
| 201 | +* Removed old, unused action. | |
| 202 | +* Prevented the selection of Belboon, Effiliation and Partnerize networks if required keys were missing. | |
| 203 | +* Moved the searchform require to all pages, not just admin. | |
| 204 | +* Added helper functions for group IDs. | |
| 205 | +* Added new function that gets affiliate ID by network ID. | |
| 206 | + | |
| 207 | += 1.2.17 - 2022/02/10 = | |
| 208 | +* Fixed bug related to `DFRAPI_DOMAIN` missing. | |
| 209 | + | |
| 210 | += 1.2.16 - 2022/02/10 = | |
| 211 | +* Replaced all occurrences of `DFRAPI_DOMAIN` with `'datafeedr-api'`. | |
| 212 | +* Replaced references to ``'datafeedr-api/datafeedr-api.php'` with `DFRAPI_BASENAME`. | |
| 213 | +* Removed `datafeedr-api-v2.php` file and related `Wuwei` code (which wasn't doing anything). | |
| 214 | +* Moved all code from `datafeedr-api-v1.php` to the main `datafeedr-api.php` file. | |
| 215 | +* Removed the `zanox_client.php` library and some code related to Zanox. | |
| 216 | +* Updated Requirements in the readme file. | |
| 217 | +* Added `Requires PHP: 7.4` to readme.txt header and plugin header. | |
| 218 | +* Added new `register_activation_hook` to ensure that the Datafeedr API plugin cannot be activated at the Network level on Multisite installs. | |
| 219 | +* Moved WordPress Version check to `register_activation_hook` instead of a regular action. | |
| 220 | + | |
| 221 | += 1.2.15 - 2022/01/25 = | |
| 222 | +* Fixed bug where `get_option( 'dfrapi_transient_whitelist', [] )` didn't always return an array. | |
| 223 | + | |
| 224 | += 1.2.14 - 2022/01/12 = | |
| 225 | +* Made "matches" the default option in the search drop down menu instead of "contains". issues/668 | |
| 226 | + | |
| 227 | += 1.2.13 - 2021/12/15 = | |
| 228 | +* Added new `admin_notices` api. | |
| 229 | +* Added new error notice if 1,000 or more merchants are selected. | |
| 230 | +* Added some new helper functions related to merchants. | |
| 231 | +* Rewrote some of the existing `admin_notices` | |
| 232 | + | |
| 233 | += 1.2.12 - 2021/11/29 = | |
| 234 | +* Added new `getQueryScore()` method to `DatafeedrSearchRequestBase` class. | |
| 235 | +* Added `score` to API `$response` array. | |
| 236 | +* Removed [Add All] button from list of Merchants on WordPress Admin Area > Datafeedr API > Merchants page to prevent thousands of merchants being selected inadvertently. | |
| 237 | +* Updated URLs to Docs and Contact page. | |
| 238 | +* Fixed missing action links on WordPress Admin Area > Plugins page. | |
| 239 | + | |
| 240 | += 1.2.11 - 2021/11/17 = | |
| 241 | +* Added new "Product ID" Product Set search filter. Now you can search by a specific Product ID. | |
| 242 | +* Added new "Barcode" Product Set search filter. Now you can search products by EAN, UPC or GTIN. | |
| 243 | +* Added new "Has Barcode" Product Set search filter. Now you can include or exclude products based on whether or not they have a Barcode (ie. UPC, EAN or GTIN). | |
| 244 | + | |
| 245 | += 1.2.10 - 2021/10/14 = | |
| 246 | +* Added support for a new Nordic-oriented affiliate network: [Adservice](https://www.adservice.com/) | |
| 247 | + | |
| 248 | += 1.2.9 - 2021/10/03 = | |
| 249 | +* Fixed bug where "missing affiliate IDs" error appeared for Partnerize Spain. | |
| 250 | +* Fixed bug where "missing affiliate IDs" error appeared for Partnerize Ireland. | |
| 251 | + | |
| 252 | += 1.2.8 - 2021/07/07 = | |
| 253 | +* Added support for GoAffPro affiliate network. | |
| 254 | +* Added support for Digital Advisor affiliate network. | |
| 255 | + | |
| 256 | += 1.2.7 - 2021/04/21 = | |
| 257 | +* Fixed bug where products ending with "." resulted in image ending with double "..". | |
| 258 | +* Fixed bug where product names which were very long were causing image imports to fail. | |
| 259 | + | |
| 260 | += 1.2.6 - 2021/03/23 = | |
| 261 | +* Fixed bug where image URL file names greater than 255 characters were returning a "failed to open stream: File name too long" resulting in a "mime_type_indeterminable" error. Now temporary file names are truncated at 200 characters. This is only related to temporary file names, not the final file name. | |
| 262 | + | |
| 263 | += 1.2.5 - 2021/03/19 = | |
| 264 | +* Added new "condition" field to Product Set search form. | |
| 265 | + | |
| 266 | += 1.2.4 - 2021/03/11 = | |
| 267 | +* Added `source` and `merchant` as possible query params. | |
| 268 | + | |
| 269 | += 1.2.3 - 2021/03/05 = | |
| 270 | +* Added new In Stock filter to Product Set Search form. :) | |
| 271 | + | |
| 272 | += 1.2.2 - 2021/03/03 = | |
| 273 | +* Complete rewrite of image importer. | |
| 274 | +* Added support for Jetpack Photon library when importing 'difficult' images and when Jetpack is active. | |
| 275 | + | |
| 276 | += 1.2.1 - 2021/02/18 = | |
| 277 | +* Remove `@` from `dfrapi_api_get_query_param()` function. | |
| 278 | +* Fixed issue where `dfrapi_request_effiliation_affiliate_ids()` returns WP_Error and was not handled properly. | |
| 279 | + | |
| 280 | += 1.2.0 - 2021/02/15 = | |
| 281 | +* Added new [ActionScheduler](https://wordpress.org/plugins/action-scheduler/) wrapper functions. | |
| 282 | +* Added more image verification checks to `Datafeedr_Image_Importer::media_sideload_image()` function. | |
| 283 | + | |
| 284 | += 1.1.5 - 2021/02/01 = | |
| 285 | +* Added new Size and Gender search filters to the Product Sets search form. | |
| 286 | + | |
| 287 | += 1.1.4 - 2021/01/29 = | |
| 288 | +* Added Site Health Info | |
| 289 | + | |
| 290 | += 1.1.3 - 2021/01/22 = | |
| 291 | +* Added support for Profitshare | |
| 292 | + | |
| 293 | += 1.1.2 - 2021/01/20 = | |
| 294 | +* Added support for Ukrainian Hryvnia (UAH) currency | |
| 295 | +* Added "Test API Connection" tool to Tools page. | |
| 296 | + | |
| 297 | += 1.1.1 - 2021/01/14 = | |
| 298 | +* Added `Dfrapi_Cron` class. | |
| 299 | + | |
| 300 | += 1.1.0 - 2021/01/11 = | |
| 301 | +* Added warning to The Affiliate Gateway affiliate ID input area on Networks page if SID is not set. | |
| 302 | +* Added new `Dfrapi_Price` class. | |
| 303 | +* Added new `Dfrapi_Currency` class. | |
| 304 | +* Added helper function to instantiate `Dfrapi_Price` class. | |
| 305 | +* Added helper function to instantiate `Dfrapi_Currency` class. | |
| 306 | +* Added more string helper functions. | |
| 307 | +* Added Material as a searchable field in the Searchform. | |
| 70 | 308 | |
| 71 | 309 | = 1.0.125 - 2020/12/29 = |
| 72 | 310 | * Prevent Belboon affiliate ID from being entered before Adspace ID is entered. |
| 73 | 311 | * Added a price.php file but not active yet. |
