forked from woocommerce/pinterest-for-woocommerce
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathreadme.txt
387 lines (289 loc) · 18.3 KB
/
readme.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
=== Pinterest for WooCommerce ===
Contributors: automattic, pinterest, woocommerce
Tags: woocommerce, pinterest, advertise
Requires at least: 5.6
Tested up to: 6.4
Requires PHP: 7.3
Stable tag: 1.3.20
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html
Get your products in front of Pinterest users searching for ideas and things to buy. Connect your WooCommerce store to make your entire catalog browsable.
== Description ==
Pinterest gives people their next great idea. Part collection, part marketplace, it’s a one-stop shop for millions of pinners to source inspiration, new products and new possibilities. It’s like a visual search engine, guiding people to ideas, inspiration and products that are just right for them.
With the Pinterest for WooCommerce extension, you can put your products in front of Pinterest users who are already looking for ideas and things to buy. Connect your WooCommerce store to your *[Pinterest business account](https://business.pinterest.com/)* directly in the WooCommerce app. Your entire catalog will become browsable on Pinterest in just a few clicks.
= Pinterest Ads =
Get started with Pinterest Ads with **$125 free ad credit\*** from Pinterest when you set up Pinterest for WooCommerce and spend $15 on ads! Pinterest *[terms and conditions](https://business.pinterest.com/en-us/business-terms-of-service/)* apply.
= Open-minded and undecided =
People on Pinterest are eager for new ideas, which means they want to hear from you. In fact, 97% of top Pinterest searches are unbranded. Content from brands doesn’t interrupt on Pinterest—it inspires. Shopping features are built into both the organic Pinner experience, and our ad solutions.
We'll also automatically set up your Pinterest tag, and a shop tab on your Pinterest profile.
*[Learn more about Shopping on Pinterest](https://business.pinterest.com/en/shopping/)*
= Set up your foundation =
*Connect your account*
Install the extension and connect your account to quickly publish Product Pins, automatically update your product catalog every day, and track performance with the Pinterest tag.
*Catalogs*
Turn your entire product catalog into browsable product Pins, all at once.
*Pinterest tag*
Add the tag to your site to measure conversions and to optimize ads for shopping campaigns or retargeting.
Consider longer attribution windows to capture shoppers who take more time to convert.
*Build brand loyalty*
People on Pinterest are nearly 50% more likely to be open to new brands while shopping. And once they find a brand they like, they’re more loyal.
Become their new favorite with merchant solutions like the Shop Tab and the Verified Merchants Program. Shop Tab on profile: Consider this your always-on Pinterest shop. It’s automatically created when you upload your catalog so people can shop right from your profile.
*Verified Merchant Program*
People love to shop from brands they trust. That’s what the Verified Merchant Program is all about. It includes benefits like a “verified” badge on your profile and eligibility for enhanced distribution.
*More about Pinterest*
Pinterest is a visual discovery engine people use to find inspiration for their lives and make it easier to shop for home decor, fashion and style, electronics and more. 450 million people have saved more than 240 billion Pins across a range of interests, which others with similar tastes can discover through search and recommendations.
== Installation ==
= Minimum Requirements =
* WordPress 5.6 or greater
* WooCommerce 5.3 or greater
* PHP version 7.3 or greater (PHP 7.4 or greater is recommended)
* MySQL version 5.6 or greater
Visit the [WooCommerce server requirements documentation](https://woo.com/document/server-requirements/) for a detailed list of server requirements.
= Automatic installation =
Automatic installation is the easiest option as WordPress handles the file transfers itself and you don’t need to leave your web browser. To do an automatic install of this plugin, log in to your WordPress dashboard, navigate to the Plugins menu and click Add New.
In the search field type “Pinterest for WooCommerce” and click Search Plugins. Once you’ve found this plugin you can view details about it such as the point release, rating and description. Most importantly of course, you can install it by simply clicking “Install Now”.
= Manual installation =
The manual installation method involves downloading the plugin and uploading it to your webserver via your favourite FTP application. The WordPress codex contains [instructions on how to do this here](https://codex.wordpress.org/Managing_Plugins#Manual_Plugin_Installation).
= Where can I report bugs or contribute to the project? =
Bugs should be reported in the [Pinterest for WooCommerce repository](https://github.com/woocommerce/pinterest-for-woocommerce/).
= This is awesome! Can I contribute? =
Yes you can! Join in on our [GitHub repository](https://github.com/woocommerce/pinterest-for-woocommerce/) :)
Release and roadmap notes available on the [WooCommerce Developers Blog](https://developer.woo.com/)
== Changelog ==
= 1.3.20 - 2024-01-12 =
* Fix - Use proper redeem code format.
= 1.3.19 - 2024-01-09 =
* Tweak - Changed minimum WC version to 6.3.
* Tweak - WC 8.5 compatibility.
= 1.3.18 - 2023-12-27 =
* Fix - Pinterest duplicated notices.
* Fix - Product Editor transient notice shift.
* Fix - Wrong feed generation items counter.
= 1.3.17 - 2023-12-19 =
* Dev - Update Woo.com developer blog URLs.
* Update - promo code for 2024.
= 1.3.16 - 2023-12-13 =
* Tweak - Make sure `feed_location` has a full URL.
= 1.3.15 - 2023-11-28 =
* Add - Compatibility with the Cart and Checkout blocks.
= 1.3.14 - 2023-11-14 =
* Tweak - Add Pinterest businesses API exception handling.
= 1.3.13 - 2023-11-07 =
* Fix - Doc - Use new Woo.com domain.
* Tweak - WC 8.3 compatibility.
* Tweak - WP 6.4 compatibility.
= 1.3.12 - 2023-10-19 =
* Dev - Add phpcs on changed files only.
= 1.3.11 - 2023-10-10 =
* Dev - automate merging trunk to develop after a release.
* Tweak - WC 8.2 compatibility.
= 1.3.10 - 2023-09-12 =
* Dev - Updates PHPUnit version, unit tests, and matrix in git workflow for PHP8.2 compatibility.
= 1.3.9 - 2023-09-05 =
* Add - Adds logic to dynamically display spend requirement and credits given based on store currency.
* Fix - Uninstall procedure.
* Tweak - WC 8.1 compatibility.
= 1.3.8 - 2023-08-15 =
* Fix - Caching of API calls.
* Fix - Make add to cart events independent from WooCommerce archive page settings.
= 1.3.7 - 2023-08-09 =
* Tweak - Don't fetch the allowed countries list when not connected.
* Tweak - Increase allowed countries cache lifetime to two days.
* Tweak - WC 8.0 compatibility.
* Tweak - WP 6.3 compatibility.
* Update - Add missing countries to the allowed countries list.
= 1.3.6 - 2023-07-25 =
* Dev - Add release preparation GH workflow.
= 1.3.5 - 2023-06-28 =
* Tweak - WC 7.9 compatibility.
= 1.3.4 - 2023-06-21 =
* Fix - Fixed error when getting transient for a key of null value.
* Fix - Release 1.3.3 - merge trunk into develop.
* Tweak - Generate a new pot file for translations.
= 1.3.3 - 2023-06-13 =
* Tweak - WC 7.8 compatibility.
= 1.3.2 - 2023-06-06 =
* Fix - Ensure there is no fatal error for PHP 8+ during activation.
= 1.3.1 - 2023-06-06 =
* Update - Pinterest feed generator backoff adjustments.
= 1.3.0 - 2023-05-30 =
* Add - Integration with WooCommerce multichannel marketing dashboard.
* Fix - Remove feed configuration during plugin uninstall procedure.
* Fix - Connection flow not redirection the wizard view.
= 1.2.21 - 2023-05-02 =
* Tweak - WC 7.7 compatibility.
= 1.2.20 - 2023-04-26 =
* Fix - Unescaped `add_query_arg` function calls.
= 1.2.19 - 2023-04-18 =
* Fix - Escape product name for JS tracker.
* Fix - On backorder items missing from the feed.
* Fix - When a new feed configuration is created it should be updated in the pinterest.com config.
= 1.2.18 - 2023-04-11 =
* Add - Automatic enhanced match support.
* Add - Support to sync setting changes from Pinterest to the plugin.
* Fix - Fatal error if cart is not set.
= 1.2.17 - 2023-04-05 =
* Add - Enhanced match documentation link.
* Tweak - WC 7.6 compatibility.
* Update - Merchant disapproval reasons.
= 1.2.16 - 2023-03-21 =
* Fix - Undefined variable when caching API requests.
= 1.2.15 - 2023-03-14 =
* Tweak - WC 7.5 compatibility.
* Tweak - WP 6.2 compatibility.
= 1.2.14 - 2023-03-07 =
* Fix - Add retry mechanism for the feed generation.
= 1.2.13 - 2023-02-22 =
* Add - WordPress locale to Pinterest locale mapping.
* Fix - Prevent fatal error if retrieving account fails during onboarding.
* Fix - Prevent multiple active feed files.
* Fix - Price inconsistencies when tax region is different than shipping zone.
= 1.2.12 - 2023-02-14 =
* Dev - Remove deprecated argument call from inside a hook action handler function.
= 1.2.11 - 2023-02-07 =
* Dev - Fix deprecated method argument version.
* Dev - Fix php8.2 deprecation notices.
* Fix - Inconsistencies with the add to cart tracking event.
* Tweak - WC 7.4 compatibility.
* Update - The Onboarding task to use `TaskLists::add_task` method instead of the deprecated `woocommerce_admin_onboarding_task_list` filter.
= 1.2.10 - 2023-01-26 =
* Add - Pull supported countries from the API.
* Fix - Disable pin button if Chrome extension is detected.
* Fix - Doc/add include exluce filters to docs.
* Fix - Missing Attributes form on Simple products.
= 1.2.9 - 2023-01-24 =
* Add - Plugin connection and feed registration status tracking.
* Add - Recent feed generation time and feed product count tracking.
* Fix - Add backlog automation.
= 1.2.8 - 2023-01-03 =
* Dev - Add node and npm version restrictions.
* Fix - Prevent failed to `feed_report` if there is no feed registered.
* Tweak - WC 7.3 compatibility.
= 1.2.7 - 2022-12-16 =
* Add - Warning message duplicated meta tags.
* Fix - Update Tracking.php.
* Fix - Update wording in filter descriotion, tracking disable fiter.
* Fix - Use min instead of max.
* Tweak - Improve translators strings.
* Tweak - Refactor update procedures.
* Tweak - WC 7.2 compatibility.
= 1.2.6 - 2022-11-16 =
* Tweak - Add Ads Credits promotion information to the readme.txt.
* Tweak - Backoff merchant creation in case of failure.
= 1.2.5 - 2022-11-07 =
* Add - Ads Credit Campaign.
* Tweak - Declare HPOS compatibility.
* Tweak - WC 7.1 compatibility.
* Tweak - WP 6.1 compatibility.
= 1.2.4 - 2022-10-13 =
* Tweak - WC 7.0 compatibility.
= 1.2.3 - 2022-10-11 =
* Add - Warning message on potential conflicting tags.
* Dev - Add branch-labels GH workflow.
* Dev - Remove from PHP test matrix WP 5.6 and 5.7, add 5.9.
* Fix - Clear connection options during disconnection error to allow new connection.
* Fix - Display correct error if product sync is broken.
* Fix - Issue with sale price on the feed.
* Fix - Save Pin button available before finishing onboarding.
* Fix - Strip HTML from the Rich Pins description field.
= 1.2.2 - 2022-08-09 =
* Dev - GH release config and the new PR template.
* Fix - Error after domain verification.
* Tweak - WC 6.8 compatibility.
= 1.2.1 - 2022-07-01 =
* Fix - Error printing end of line character.
= 1.2.0 - 2022-06-27 =
* Add - Argentina, Colombia and Chile to ads supported countries.
* Fix - Move the <noscript> base code to <body>.
* Fix - Typo errors on translatable strings.
= 1.1.0 - 2022-06-17 =
* Add - .pot file for translators.
* Add - Inbox notifications for the onboarding process and catalog sync.
* Add - Key flows documentation.
* Add - The user will be redirected to the Get started page on first activation.
* Fix - Add plugin version to request headers.
* Fix - Error on feed generation due to orphaned variations.
* Fix - Unit tests for WooCommerce 6.5.
* Tweak - Improvements on the error logs.
* Tweak - WC 6.6 compatibility.
= 1.0.13 - 2022-05-24 =
* Add - Add action scheduler as a minimum plugin requirement.
* Add - Japan to ads supported countries.
* Add - Route to handle the plugin's settings.
* Fix - Limit the number of additional images to 10.
* Tweak - WC 6.5 compatibility.
= 1.0.12 - 2022-05-05 =
* Dev - update trusted plugins in composer.json.
* Fix - Feed generation fails if there is no eligible product.
* Fix - Fix fatal error if `get_pinterest_code()` doesn't exists on Throwable object.
= 1.0.11 - 2022-04-12 =
* Add - Clear error when the merchant is connected to another e-commerce platform.
* Add - Mexico added to supported countries.
* Fix - Currency is now being sent on the product page visit event.
* Fix - Ensure add to cart tag data is consistent.
* Fix - Price mismatch when price includes taxes.
* Fix - Unit tests failing on WC 6.4.
* Tweak - Simplify tracking code.
* Tweak - Updated the Track event generation script to prevent future errors.
* Tweak - WC 6.3 compatibility.
* Tweak - WP 5.9 compatibility.
= 1.0.10 - 2022-03-31 =
* Update - Feed Refactor with Action Scheduler Framework. ( [#368](https://github.com/woocommerce/pinterest-for-woocommerce/pull/368) )
= 1.0.9 - 2022-03-29 =
* Add - Plugin update framework. ( [#390](https://github.com/woocommerce/pinterest-for-woocommerce/pull/390 ) )
* Tweak - Use website verification instead of domains. ( [#391](https://github.com/woocommerce/pinterest-for-woocommerce/pull/391) )
* Tweak - Move deactivation hook to plugin file ( [#397](https://github.com/woocommerce/pinterest-for-woocommerce/pull/397) )
* Update - Add np:woocomerce param to partner data in the tag. ( [#404](https://github.com/woocommerce/pinterest-for-woocommerce/pull/404) )
* Fix - Remove invalid XML characters from feed. ( [#409](https://github.com/woocommerce/pinterest-for-woocommerce/pull/409) )
= 1.0.8 - 2022-03-11 =
* Update - Shipping column format. ( [#370](https://github.com/woocommerce/pinterest-for-woocommerce/pull/370) )
* Fix - Escape XML special chars in SKU for the XML MPN section. ( [#371](https://github.com/woocommerce/pinterest-for-woocommerce/pull/371) )
* Fix - Clean account data if user Disconnect during the onboarding process with a personal account. ( [#381](https://github.com/woocommerce/pinterest-for-woocommerce/pull/381) )
* Fix - Do not create merchant on get_feed_state. ( [#353](https://github.com/woocommerce/pinterest-for-woocommerce/pull/353) )
* Update - Disable enhanced match support when tracking is disabled. ( [#386](https://github.com/woocommerce/pinterest-for-woocommerce/pull/386) )
* Tweak - Take full size images for the feed. ( [#383](https://github.com/woocommerce/pinterest-for-woocommerce/pull/383) )
* Update - Enable shipping column in the feed. ( [#388](https://github.com/woocommerce/pinterest-for-woocommerce/pull/388) )
= 1.0.7 - 2022-02-24 =
* Fix - Critical error on Jetpack sites.
= 1.0.6 - 2022-02-16 =
* Fix – Fix the changelog for the 1.0.5 release by adding omitted changes.
= 1.0.5 - 2022-02-15 =
* Fix - Strip HTML shortcodes from feed.
* Fix - Make the price format consistent in the feed.
* Fix - Exclude zero price items from product feed.
* Tweak - Force logging to be enabled when setup is not complete.
* Add – Shipping column for developers and testers.
= 1.0.4 - 2022-02-03 =
* Fix - Store merchant id during the account creation. ( [#343](https://github.com/woocommerce/pinterest-for-woocommerce/pull/343) )
= 1.0.3 - 2022-01-25 =
* Fix - Allow proper setup for new merchants with no catalogs. ( [#339](https://github.com/woocommerce/pinterest-for-woocommerce/pull/339) )
= 1.0.2 - 2022-01-25 =
* Fix - Update and improve feedstate. ( [#240](https://github.com/woocommerce/pinterest-for-woocommerce/pull/240) )
* Add - Tooltips for the Publish Pins and Rich Pins options on the settings page. ( [#253](https://github.com/woocommerce/pinterest-for-woocommerce/pull/253) )
* Add - Merchant guidelines link in the setup page. ( [#255](https://github.com/woocommerce/pinterest-for-woocommerce/pull/255) )
* Add - Show a notice on the landing page if this extension does not support store country. ( [#256](https://github.com/woocommerce/pinterest-for-woocommerce/pull/256) )
* Update - Adjust image size for additional images. ( [#268](https://github.com/woocommerce/pinterest-for-woocommerce/pull/268) )
* Fix - Error message for merchants with declined status. ( [#272](https://github.com/woocommerce/pinterest-for-woocommerce/pull/272) )
* Add - Pinterest Ads Manager Call To Action UI. ( [#273](https://github.com/woocommerce/pinterest-for-woocommerce/pull/273) )
* Update - Tweak the UI of claim website. ( [#286](https://github.com/woocommerce/pinterest-for-woocommerce/pull/286) )
* Update - Remove unused parameters sent in create merchant request. ( [#294](https://github.com/woocommerce/pinterest-for-woocommerce/pull/294) )
* Add - Adding Woo Tracker for Usage Tracking. ( [#301](https://github.com/woocommerce/pinterest-for-woocommerce/pull/301) )
* Add - Implement Events Tracking. ( [#296](https://github.com/woocommerce/pinterest-for-woocommerce/pull/296) )
* Add - Product Attributes. ( [#303](https://github.com/woocommerce/pinterest-for-woocommerce/pull/303) )
* Update - API to v4. ( [#305](https://github.com/woocommerce/pinterest-for-woocommerce/pull/305) )
* Update - Refactor AccountConnection component. ( [#312](https://github.com/woocommerce/pinterest-for-woocommerce/pull/312) )
* Add - Product attribute for Google product category. ( [#317](https://github.com/woocommerce/pinterest-for-woocommerce/pull/317) )
* Fix - Onboarding wizard steps ( 2 and 3 ) are not clickable. ( [#318](https://github.com/woocommerce/pinterest-for-woocommerce/pull/318) )
* Fix - Fetch parent id for variable product during feed xml generation. ( [#320](https://github.com/woocommerce/pinterest-for-woocommerce/pull/320) )
* Fix - Plugin is blocking some 3rd party scripts. ( [#324](https://github.com/woocommerce/pinterest-for-woocommerce/pull/324) )
* Fix - Multiple catalog created on pinterest with no possibility to delete them. ( [#305](https://github.com/woocommerce/pinterest-for-woocommerce/pull/305) )
* Fix - Feed registration status is incorrect when user has more than one feed profile. ( [#335](https://github.com/woocommerce/pinterest-for-woocommerce/pull/335) )
= 1.0.1 - 2021-11-16 =
* Fix - Add PHP, JS & CSS linting GH actions.
* Fix - Enable enhanced match by default .
* Fix - Fix error with WC Session when accessing REST API endpoints publicly.
* Fix - Fix npm vulnerabilities.
* Fix - Update, clean and make green CSS & JS linters.
* Fix - Use Task List API to detect if we should show Pinterest onboarding tasks.
= 1.0.0 - 2021-10-25 =
- Initial release