PluginProbe
Datafeedr API / 1.0.125
Datafeedr API v1.0.125
1.4.3 1.4.2 1.0.125 1.0.13 1.0.14 1.0.15 1.0.16 1.0.17 1.0.18 1.0.19 1.0.2 1.0.20 1.0.21 1.0.22 1.0.23 1.0.24 1.0.25 1.0.26 1.0.27 1.0.28 1.0.29 1.0.3 1.0.30 1.0.31 1.0.32 All 182 releases
datafeedr-api / readme.txt

readme.txt in Datafeedr API 1.0.125, at readme.txt

534 lines 17.2 KB
No matching file
Up and down to move Enter to open Esc to close
Raw Download Zip
1 === Datafeedr API ===
2
3 Contributors: datafeedr.com
4 Tags: woocommerce, datafeedr, affiliate products, dfrapi, import csv, import datafeed, import data feed, data feed, datafeed, import affiliate products
5 License: GPLv2 or later
6 License URI: http://www.gnu.org/licenses/gpl-2.0.html
7 Requires at least: 3.8
8 Tested up to: 5.7-alpha
9 Stable tag: 1.0.125
10
11 Connect to the Datafeedr API.
12
13 == Description ==
14
15 > **Important**
16
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
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
21 The *Datafeedr API* plugin currently integrates with the following plugins:
22
23 * [Datafeedr WooCommerce Importer](https://wordpress.org/plugins/datafeedr-woocommerce-importer/)
24 * [Datafeedr Product Sets](https://wordpress.org/plugins/datafeedr-product-sets/)
25 * [Datafeedr Comparison Sets](https://wordpress.org/plugins/datafeedr-comparison-sets/)
26
27 The *Datafeedr API* plugin provides the interface to connect to the Datafeedr API and perform the following tasks:
28
29 * Configure your API connection settings.
30 * Select affiliate networks you are a member of.
31 * Select merchants who have approved you.
32 * Add your affiliate network affiliate IDs.
33 * Import/export your selection of affiliate networks and/or merchants.
34 * View your API account usage.
35
36 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 Additionally, we have written plugins that integrate the *Datafeedr API* plugin with WooCommerce. More extensions are on the way...
39
40 **Requirements**
41
42 * PHP's `CURL` support must be enabled.
43 * PHP Version 7.2 (or greater).
44 * WordPress site with HTTPS (SSL/TLS) enabled.
45
46 == Installation ==
47
48 This section describes how to install and configure the plugin:
49
50 1. Upload the `datafeedr-api` folder to the `/wp-content/plugins/` directory.
51 1. Activate the *Datafeedr API* plugin through the 'Plugins' menu in WordPress.
52 1. Enter your Datafeedr API keys here: WordPress Admin Area > Datafeedr API > Configuration
53 1. Select the affiliate networks you are a member of here: WordPress Admin Area > Datafeedr API > Networks
54 1. Select the merchants who have approved you here: WordPress Admin Area > Datafeedr API > Merchants
55
56 == Frequently Asked Questions ==
57
58 = Where can I get help? =
59
60 Our support area can be found here: [https://datafeedrapi.helpscoutdocs.com/](https://datafeedrapi.helpscoutdocs.com/?utm_campaign=dfrapiplugin&utm_medium=referral&utm_source=wporg). This support area is open to everyone.
61
62 == Screenshots ==
63
64 1. API key configuration
65 2. Network selection
66 3. Merchant selection
67 4. Account usage overview
68
69 == Changelog ==
70
71 = 1.0.125 - 2020/12/29 =
72 * Prevent Belboon affiliate ID from being entered before Adspace ID is entered.
73 * Added a price.php file but not active yet.
74
75 = 1.0.124 - 2020/12/28 =
76 * Added support for new style of Belboon links.
77 * Fixed jQuery handlers like `.click()`, `.keyup()`, `.change()`, `.submit()` to use `.on()` or `.trigger()` methods instead.
78
79 = 1.0.123 - 2020/12/15 =
80 * Added support for Admitad.
81
82 = 1.0.122 - 2020/12/01 =
83 * Fixed issue where `ref_url` was requested for Amazon products.
84
85 = 1.0.121 - 2020/11/27 =
86 * Added product ID as a sort parameter in the search form.
87
88 = 1.0.120 - 2020/11/03 =
89 * Added support for additional Amazon locales
90 * Removed Zanox Brazil from available option
91
92 = 1.0.119 - 2020/10/28 =
93 * Added link to doc article for 2Performant.
94
95 = 1.0.118 - 2020/10/27 =
96 * Added new network 2Performant (Romania)
97
98 = 1.0.117 - 2020/10/12 =
99 * Fixed some broken network icons.
100
101 = 1.0.116 - 2020/10/12 =
102 * Skipped
103
104 = 1.0.115 - 2020/09/10 =
105 * Optimized unapproved_effiliation_merchants_exist() query.
106
107 = 1.0.114 - 2020/09/10 =
108 * Fixed issue with Effiliation affiliate ID loading.
109
110 = 1.0.113 - 2020/07/29 =
111 * Added support for HUF and RUB currencies.
112
113 = 1.0.112 - 2020/04/29 =
114 * Replacing network group names with group IDs.
115
116 = 1.0.111 - 2020/04/19 =
117 * Fixed bug with Awin and TheAffiliateGateway on Networks page.
118
119 = 1.0.110 - 2020/03/30 =
120 * Fixed link to Rakuten doc.
121
122 = 1.0.109 - 2020/03/26 =
123 * Added support for ADCELL.
124
125 = 1.0.108 - 2020/03/11 =
126 * Added support for Amazon NL.
127
128 = 1.0.107 - 2020/02/24 =
129 * Update Datafeedr API Library to support new [Amazon Product Advertising API 5.0](https://webservices.amazon.com/paapi5/documentation/).
130 * Requires an HTTPS connection to use Amazon.
131 * Added color field to search form.
132
133 = 1.0.106 - 2019/11/20 =
134 * Updated Helpscout beacon
135
136 = 1.0.105 - 2019/11/12 =
137 * Updated readme.
138
139 = 1.0.104 - 2019/10/15 =
140 * Added Merchant Limit filter to Search Form.
141
142 = 1.0.103 - 2019/08/06 =
143 * Updated Networks page to support new Partnerize networks.
144
145 = 1.0.102 - 2019/05/24 =
146 * Provided support for The Affiliate Gateway SID field.
147
148 = 1.0.101 - 2019/05/21 =
149 * Added support for The Affiliate Gateway network.
150 * Added new "_owner_datafeedr" meta key for all images imported via the `datafeedr_import_image()` function. This can include a meta_value of the plugin doing the importing as well.
151
152 = 1.0.100 - 2019/05/06 =
153 * Updated readme.
154
155 = 1.0.99 - 2019/04/23 =
156 * Updated readme.
157
158 = 1.0.98 - 2019/04/11 =
159 * Changed `TRUE` to `true` in `searchform.php` render() function.
160 * Added a width/height check in the image importer. Handles failed imports like Patagonia images.
161
162 = 1.0.97 - 2019/03/23 =
163 * Fixed missing FlexOffers logo.
164
165 = 1.0.96 - 2019/03/22 =
166 * Made plugin ready for upcoming FlexOffers support.
167
168 = 1.0.95 - 2019/02/19 =
169 * Updated readme.
170
171 = 1.0.94 - 2019/02/11 =
172 * Added Awin API token field so that only approved Awin programs are listed under Awin Merchants on this page: WordPress Admin Area > Datafeedr API > Merchants > Awin [Country]
173
174 = 1.0.93 - 2018/12/19 =
175 * Added support for Australia and Turkey for Amazon API queries.
176
177 = 1.0.92 - 2018/12/07 =
178 * Updated readme.
179
180 = 1.0.91 - 2018/07/31 =
181 * Added `tid` option for Partnerize on Networks page.
182
183 = 1.0.90 - 2018/07/30 =
184 * Changed more "Performance Horizon" references to "Partnerize".
185
186 = 1.0.89 - 2018/07/20 =
187 * Added support for Partnerize.
188
189 = 1.0.88 - 2018/07/16 =
190 * Added new Partnerize logos.
191 * Deleted old PJN logos.
192
193 = 1.0.87 - 2018/07/13 =
194 * Changed height of network and merchant pop-up modal.
195
196 = 1.0.85 - 2018/05/07 =
197 * Fixed tiny bug in Beacon code.
198
199 = 1.0.84 - 2018/05/07 =
200 * Added HelpScout Beacon to Datafeedr-specific pages for in-app documentation and support.
201
202 = 1.0.83 - 2018/04/11 =
203 * Removed old affiliate network icons and logos.
204
205 = 1.0.82 - 2018/04/11 =
206 * Fixed bug where images could not be imported if their file name was too long. Set limit to 100 characters.
207
208 = 1.0.81 - 2018/03/29 =
209 * Added support for Effiliation affiliate network.
210
211 = 1.0.80 - 2018/02/20 =
212 * Fixed form `action` on networks page.
213
214 = 1.0.79 - 2018/02/08 =
215 * Set API `retry` attempts to 3 if connection to API timesout. (#15364)
216
217 = 1.0.78 - 2018/01/19 =
218 * Added `dfrapi_string_starts_with()` helper function.
219
220 = 1.0.77 - 2018/01/17 =
221 * Updated "Tested up to" value.
222 * Added README.md for GitHub.
223
224 = 1.0.76 - 2018/01/10 =
225 * Fixed bug related to new dependency class.
226
227 = 1.0.75 - 2018/01/10 =
228 * Made more changes to the `Datafeedr_Plugin_Dependency` class + doc blocks.
229
230 = 1.0.74 - 2018/01/09 =
231 * Changed return values of `Datafeedr_Image_Importer::import()`.
232 * Removed some public methods from `Datafeedr_Image_Importer`.
233 * Added new `Datafeedr_Plugin_Dependency` class. Still needs doc blocks.
234
235 = 1.0.73 - 2018/01/08 =
236 * Changed protected method to public.
237
238 = 1.0.72 - 2018/01/08 =
239 * Changed @return doc of `datafeedr_import_image()` function.
240 * Added new `Datafeedr_Timer` trait.
241 * Added new methods and filters to `Datafeedr_Image_Importer` class.
242
243 = 1.0.71 - 2018/01/05 =
244 * Added new `Datafeedr_Image_Importer` class which will eventually replace all image importing functionality.
245 * Added new `datafeedr_import_image()` helper function.
246
247 = 1.0.70 - 2017/12/12 =
248 * Optimized check for incorrect Zanox & PH affiliate IDs.
249
250 = 1.0.69 - 2017/12/02 =
251 * Fixed errors thrown in `dfrapi_api_get_zanox_zmid()` and `dfrapi_api_get_ph_camref()` functions.
252 * Fixed issue where PerformanceHorizon errors were not being displayed as an admin_notice.
253
254 = 1.0.68 - 2017/12/01 =
255 * Optimize WordPress Admin Area pages so Networks and Merchants aren't queried from cache on every page load.
256
257 = 1.0.67 - 2017/11/29 =
258 * Cleaned up some of the admin nags.
259
260 = 1.0.66 - 2017/11/29 =
261 * Added support for Performance Horizon affiliate network. (#15361)
262
263 = 1.0.65 - 2017/11/18 =
264 * Updated `timeout` to `60` in `DatafeedrApi` options array. (#15382)
265
266 = 1.0.64 - 2017/11/18 =
267 * Updated CSS.
268
269 = 1.0.63 - 2017/11/17 =
270 * Updated instantiation of the `DatafeedrApi` class to accept an `$options` array instead of 3 parameters. (#15251)
271
272 = 1.0.62 - 2017/10/25 =
273 * Optimized query to check if unapproved Zanox merchants exist.
274 * Added ability to see unapproved Zanox merchants in admin notice.
275
276 = 1.0.61 - 2017/10/23 =
277 * Updated `DatafeedrApi` class with proper docs standard WP code formatting.
278
279 = 1.0.60 - 2017/10/18 =
280 * Added new `dfrapi_get_amazon_associate_tag()` function.
281 * Added Amazon support to the `dfrapi_url()` function where previously it was handled by child plugins. (#15201)
282
283 = 1.0.59 - 2017/10/10 =
284 * Updated TradeTracker network icons. (#15178)
285
286 = 1.0.58 - 2017/10/06 =
287 * Updated Documentation URLs.
288
289 = 1.0.57 - 2017/09/08 =
290 * Updated AffiliateWindow's name to Awin.
291
292 = 1.0.56 - 2017/05/01 =
293 * Replaced use of `number_format()` with `abs()` in API usage emailer script.
294
295 = 1.0.55 - 2017/03/06 =
296 * Updated Affiliate Window icons. (#14404)
297
298 = 1.0.54 - 2017/02/21 =
299 * Updated datafeedr.php API client. (#14372)
300 * Replaced all API calls with wp_remote_post(). (#14376)
301 * Removed "transport" option from WordPress Admin Area > Datafeedr API > Configuration > Datafeedr API Settings page. Replaced with wp_remote_post().
302
303 = 1.0.53 - 2017/02/12 =
304 * Added support for the Malaysian ringgit currency.
305
306 = 1.0.52 - 2017/01/21 =
307 * Fixed another bug introduced in 1.0.49
308
309 = 1.0.51 - 2017/01/21 =
310 * Removed option added in 1.0.49. It caused all sorts of issues.
311
312 = 1.0.50 - 2017/01/20 =
313 * Added support for a Tracking ID for Shopello.
314
315 = 1.0.49 - 2016/12/27 =
316 * Added new option to WordPress Admin Area > Datafeedr API > Configuration page to allow the API to be disabled without having to deactivate the Datafeedr API plugin.
317
318 = 1.0.48 - 2016/12/14 =
319 * Updated Snapdeal logos
320
321 = 1.0.47 - 2016/10/24 =
322 * Modified searchfilter.js to improve speed when searching for merchants on the Merchants page (#13955).
323
324 = 1.0.46 - 2016/09/07 =
325 * Remove Connexity from interface (#13803).
326
327 = 1.0.45 - 2016/09/02 =
328 * Replaced "Current Usage" section on Account page with link a link to the Members /api page.
329
330 = 1.0.44 - 2016/09/01 =
331 * Added support for connexity.com.
332 * Replaced old Shopello icons with new ones (#13589)
333
334 = 1.0.43 - 2016/06/27 =
335 * Removed 'database_rotation' message. (#13535)
336
337 = 1.0.42 - 2016/06/26 =
338 * Fixed CSS for 16x16 network icons. (#13534)
339
340 = 1.0.41 - 2016/06/20 =
341 * Updated CSS file for new networks.
342
343 = 1.0.40 - 2016/06/20 =
344 * Added support for Snapdeal (#13161)
345 * Added support for Shopello (#13258)
346
347 = 1.0.39 - 2016/05/24 =
348 * Added new `dfrapi_impression_url()` function. (#13237)
349
350 = 1.0.38 - 2016/04/10 =
351 * Modified search form help text.
352 * Added support for India, Brazil and Mexico for Amazon API queries.
353
354 = 1.0.37 - 2016/04/06 =
355 * Updated PepperJam logos.
356
357 = 1.0.36 - 2016/03/21 =
358 * Updated links to documentation on how to find your affiliate IDs on the Networks page.
359 * Updated links to https://members.datafeedr.com/ pages on the Account page.
360
361 = 1.0.35 - 2016/02/16 =
362 * Fixed more new links (see 1.0.34)
363
364 = 1.0.34 - 2016/02/16 =
365 * Changed links to Datafeedr's new support and members sites.
366
367 = 1.0.33 - 2016/02/03 =
368 * Added new function to get Amazon keys. This is related to DFRCS integration.
369
370 = 1.0.32 - 2016/02/03 =
371 * Added a "less than or equal to" and "greater than or equal to" option for the price field filters. (#12217)
372 * Added CSS to accommodate the new price field filters.
373 * Added compatibility/support for the upcoming DFRCS plugin. :)
374
375 = 1.0.31 - 2016/01/27 =
376 * Added support for FamilyBlend (previously Affiliate4You).
377
378 = 1.0.30 - 2015/10/20 =
379 * Added "Sort by Date Created Ascending" to API search form. (#11836)
380 * Added "Sort by Date Created Descending" to API search form. (#11836)
381 * Added "Sort by Final Price Ascending" to API search form. (#11836)
382 * Added "Sort by Final Price Descending" to API search form. (#11836)
383 * Added "Has Direct URL" filter to API search form. (#11836)
384
385 = 1.0.29 - 2015/09/21 =
386 * Added support for negative currency queries. (#11499)
387 * Added support for product ID queries (not exposed in search form). (#11499)
388 * Fixed "quirk" where individual products added to a Product Set would throw off pagination when those products were no longer available via the API. Now you can delete those products from the set and pagination works again.
389 * Updated the datafeedr.php library which fixed a small array issue. (#11346)
390 * Added new "noimage" image.
391
392 = 1.0.28 - 2015/08/12 =
393 * Added support for new affiliate network Optimise. (#11221)
394
395 = 1.0.27 - 2015/07/02 =
396 * Added new DatafeedrServerError class to the datafeedr.php library file. (#11199)
397
398 = 1.0.26 - 2015/06/30 =
399 * Removed DGM and replaced with APD affiliate network. Added APD network logos.
400
401 = 1.0.25 - 2015/04/29 =
402 * Added cache bypassing functions when getting transients. (#10866)
403
404 = 1.0.24 - 2015/04/06 =
405 * Added new icon to admin menu.
406 * Added new 128x128 and 256x256 plugin icons.
407 * Fixed broken URL to admin menu icons that have existed since the beginning of time.
408
409 = 1.0.23 =
410 * Fixed wrong error message when the merchant filter is added to the search form but no merchants are selected.
411
412 = 1.0.22 =
413 * Added support for Brazilian Real, Indian Rupee & Polish Złoty currency symbols.
414
415 = 1.0.21 =
416 * Updated Datafeedr API file.
417
418 = 1.0.20 =
419 * Just updating readme.
420
421 = 1.0.19 =
422 * Added FlipKart support.
423 * Added Amazon Local US support.
424
425 = 1.0.18 =
426 * Added MyCommerce to css file.
427 * Added link to docs for MyCommerce.
428
429 = 1.0.17 =
430 * Removed M4N from tags in readme.txt file.
431 * Changed RegNow to MyCommerce in readme file.
432 * Added MyCommerce icons.
433 * Added plugin icon for WordPress 4.0+.
434
435 = 1.0.16 =
436 * Fixed undefined 'tid' index.
437 * Changed the 'delete cached api data' tool from checkbox to ajax button.
438 * Display notice if a user has selected a Zanox merchant which has not approved their account. This prevents many extra API requests from being generated. (#9474)
439 * Removed p tags for nags.
440 * Added ajax.php file to handle... um... AJAX stuff.
441 * Add "___MISSING___" to Zanox URLs if affiliate ID is missing.
442
443 = 1.0.15 =
444 * Removed Commission Monster from list of supported affiliate networks.
445
446 = 1.0.14 =
447 * Fixed bug introduced by removing dfrapi_filter_affiliate_id filter in v1.0.12 related to Zanox.
448
449 = 1.0.13 =
450 * Removed BOL from list of supported affiliate networks.
451 * Changed WP header image.
452
453 = 1.0.12 =
454 * Removed dfrapi_filter_affiliate_id filter.
455 * Added ability to add tracking ID to outgoing affiliate links.
456
457 = 1.0.11 =
458 * Changed add_option to update_option in upgrade.php file.
459 * Updated the datafeedr.php API library to deal with 32-bit systems and product IDs.
460
461 = 1.0.10 =
462 * Added upgrade.php file to track version changes.
463 * Added dfrapi_get_total_products_in_db() function.
464
465 = 1.0.9 =
466 * Fixed issue where searches with duplicates excluded returned a higher 'found' count than really was there. (#8672)
467
468 = 1.0.8 =
469 * Added css and mapper link for docs for Double.net.
470
471 = 1.0.7 =
472 * Added logos for Double.net.
473
474 = 1.0.6 =
475 * Forgot to update version numbers in plugin file.
476
477 = 1.0.5 =
478 * Tweaked search form css.
479 * Added message for database rotation time between 8:00am and 8:20am GMT.
480 * Added search form help text.
481 * Changed some labels in the search form.
482 * Added support for Affiliator affiliate network.
483 * Updated Datafeedr API library.
484
485 = 1.0.4 =
486 * Tweaked search form css.
487 * Changes to a lot of help text on all pages.
488
489 = 1.0.3 =
490 * Changed <title> of Tools page.
491
492 = 1.0.2 =
493 * Edited nag boxes when API requests are 90% of max.
494 * Removed the 80% API usage email notice.
495 * Changed the text in the API usage emails.
496 * Converted emails sent from plain text to HTML.
497 * Fixed undefined indexes.
498 * Added "Free" plan to list of available plans.
499
500 = 1.0.1 =
501 * Added utm_campaign parameters to help tab links.
502
503 = 1.0.0 =
504 * Updated "Contributors" and "Author" fields to match WP.org username.
505 * Added support for AUD, DKK, SEK, NOK, CHF, NZD & TRY currency codes.
506
507 = 0.9.8 =
508 * Added support for Zanox.
509 * Fixed undefined indexes.
510
511 = 0.9.7 =
512 * Fixed issed related to using Sort by Relevance. #8439
513 * Fixed "support" links in help tab.
514 * Updated plugin information.
515
516 = 0.9.6 =
517 * Added if(!class_exists('...')) checks to the Datafeedr Api Client Library.
518
519 = 0.9.5 =
520 * Fixed undefined indexes.
521 * Added "static" to static methods to meet Strict Standards.
522
523 = 0.9.4 =
524 * Removed letters and characters from 'tagged' version.
525 * Updated "Tested up to" to 3.8.1
526
527 = 0.9-beta-3 =
528 * Initial release.
529
530 == Upgrade Notice ==
531
532 *None*
533
534