You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: CHANGELOG.md
+11Lines changed: 11 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,6 +4,16 @@ All notable changes to this project will be documented in this file, per [the Ke
4
4
5
5
## [Unreleased] - TBD
6
6
7
+
## [1.9.0] - 2025-06-04
8
+
9
+
### Added
10
+
11
+
- New user synchronization feature that allows syncing WordPress users to Mailchimp (props [@iamdharmesh](https://github.com/iamdharmesh), [@jeffpaul](https://github.com/jeffpaul), [@dkotter](https://github.com/dkotter), [@qasumitbagthariya](https://github.com/qasumitbagthariya) via [#156](https://github.com/mailchimp/wordpress/pull/156)).
12
+
13
+
### Changed
14
+
15
+
- Improved the enqueueing of JavaScript scripts and styles (props [@iamdharmesh](https://github.com/iamdharmesh), [@dkotter](https://github.com/dkotter), [@qasumitbagthariya](https://github.com/qasumitbagthariya) via [#161](https://github.com/mailchimp/wordpress/pull/161)).
16
+
7
17
## [1.8.0] - 2025-05-08
8
18
9
19
**Note that this release bumps the WordPress minimum version from 6.3 to 6.4.**
@@ -313,6 +323,7 @@ All notable changes to this project will be documented in this file, per [the Ke
Copy file name to clipboardExpand all lines: README.md
+10-10Lines changed: 10 additions & 10 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -28,7 +28,7 @@ Starting in version 1.6.0, authentication has changed to use OAuth. As part of t
28
28
29
29
With no additional configuration, we use the standard `LOGGED_IN_KEY` and `LOGGED_IN_SALT` constants that are normally set in your site's `wp-config.php` file. Some sites make use of security plugins that rotate these constants on a periodic basis. When this happens, we won't be able to decrypt the access token and you’ll need to reconnect your Mailchimp account to generate a new access token.
30
30
31
-
To prevent such issues, it is recommended to define two additional constants in your site's `wp-config.php` file: `MAILCHIMP_SF_ENCRYPTION_KEY` and `MAILCHIMP_SF_ENCRYPTION_SALT`. These constants should consist of a combination of characters, preferably at least 32 characters long. Once set, these values should not be changed. For strong values, you can copy some of the values from [here](https://api.wordpress.org/secret-key/1.1/salt/) and use them. You'll end up with additional code like the following in your `wp-config.php` file:
31
+
To prevent such issues, it is recommended to define two additional constants in your site's `wp-config.php` file: `MAILCHIMP_SF_ENCRYPTION_KEY` and `MAILCHIMP_SF_ENCRYPTION_SALT`. These constants should consist of a combination of characters, preferably at least 32 characters long. Once set, these values should not be changed. For strong values, you can copy some of the values from the [WordPress Secret Key Generator](https://api.wordpress.org/secret-key/1.1/salt/) and use them. You'll end up with additional code like the following in your `wp-config.php` file:
32
32
33
33
```php
34
34
define( 'MAILCHIMP_SF_ENCRYPTION_KEY', 'put your unique phrase here' );
@@ -49,23 +49,21 @@ This section describes how to install the plugin and get started using it.
49
49
50
50
51
51
52
-
52
+
53
53
54
54
4. Click the Log in button and proceed through the OAuth flow, logging in to your Mailchimp account and authorizing the application. If you don't have an acccount, instead click the "Create an account" button to create one.
55
55
56
56
57
57
58
58
5. Select the list where you want to send new Mailchimp subscribers.
59
59
60
-
61
-
62
60
6. Optional: Turn **Merge Fields** and **Groups** on or off. Navigate to **Appearance**, and click **Widgets**. Drag the Mailchimp Widget into one of your Widget Areas.
63
61
64
-
62
+
65
63
66
-
7. Optional: adjust frontend site display with available CSS options.
64
+
7. Optional: turn on user synchronization to sync WordPress users to Mailchimp.
67
65
68
-
66
+
69
67
70
68
## Upgrading
71
69
@@ -88,23 +86,25 @@ You need to ensure that the fields are enabled both in your Mailchimp account (A
88
86
Internationalization (i18n) is available on GlotPress at [https://translate.wordpress.org/projects/wp-plugins/mailchimp/](https://translate.wordpress.org/projects/wp-plugins/mailchimp/). Any assistance [translating the plugin](https://translate.wordpress.org/projects/wp-plugins/mailchimp/) is greatly appreciated!
89
87
90
88
## E2E tests
89
+
91
90
The `tests` directory contains end-to-end tests for the project, utilizing Cypress to run tests in an environment created using wp-env.
92
91
93
92
### Pre-requisites
93
+
94
94
- Node.js v20
95
95
- Docker
96
96
- Create an account in [Mailchimp](https://mailchimp.com/)
97
97
98
98
### Run E2E tests in local
99
+
99
100
1. Run `npm install`.
100
101
2. Run `npm run build`.
101
102
3. Run `npm run env:start`.
102
103
4. Duplicate the `.env.test.sample` file and rename `.env.test`. Populate this file with your own Mailchimp account credentials.
103
104
-**NOTE:** Use a test account that does not require 2FA. 2FA will fail some of the tests.
104
105
5. Set your Mailchimp account up
105
-
- Name the audience in your Mailchimp test account "10up". Required for `settings.test.js`.
106
-
- Enable all merge fields. From your Mailchimp account home page -> `/audience/settings/` -> Edit merge fields/tags -> Set all merge fields to "visible". Required for `settings.test.js`.
107
-
106
+
- Name the audience in your Mailchimp test account "10up". Required for `settings.test.js`.
107
+
- Enable all merge fields. From your Mailchimp account home page -> `/audience/settings/` -> Edit merge fields/tags -> Set all merge fields to "visible". Required for `settings.test.js`.
108
108
6. Run `npm run cypress:run`. You can also run `npm run cypress:open` to run tests in UI mode.
0 commit comments