Skip to content

Commit e7bc6f1

Browse files
committed
readme.txt updates.
1 parent 4073bbb commit e7bc6f1

File tree

2 files changed

+21
-6
lines changed

2 files changed

+21
-6
lines changed

README.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -18,12 +18,6 @@ WordPress.com compatibility is limited to Business tier users only. [How to add
1818

1919
![Configuring extra fields on your Signup Form (optional)](https://github.com/mailchimp/wordpress/blob/develop/.wordpress-org/screenshot-4.jpg?raw=true)
2020

21-
## Frequently Asked Questions
22-
23-
### Can I have multiple forms on one page?
24-
25-
No, only one form should exist per page, no matter the display type (widget, shortcode, or block).
26-
2721
## Access token Encryption
2822

2923
The plugin stores the OAuth access token in the WordPress database and encrypts it for security. To ensure encryption and decryption work properly, the plugin needs access to certain security constants that should remain unchanged.
@@ -39,6 +33,12 @@ define( 'MAILCHIMP_SF_ENCRYPTION_SALT', 'put your unique phrase here' );
3933

4034
If you add these constants after the plugin is already configured, the plugin will use the new constants, which may cause issues. To avoid this, you can copy the values from `LOGGED_IN_KEY` and `LOGGED_IN_SALT` to `MAILCHIMP_SF_ENCRYPTION_KEY` and `MAILCHIMP_SF_ENCRYPTION_SALT`. If you prefer new values, you will need to reconnect your Mailchimp account.
4135

36+
## Frequently Asked Questions
37+
38+
### Can I have multiple forms on one page?
39+
40+
No, only one form should exist per page, no matter the display type (widget, shortcode, or block).
41+
4242
## Installation
4343

4444
This section describes how to install the plugin and get started using it.

readme.txt

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,21 @@ After installation, you’ll log in with your API key, select your Mailchimp lis
1616

1717
WordPress.com compatibility is limited to Business tier users only. [How to add a signup form if you have a WordPress.com site](https://mailchimp.com/help/ways-to-add-a-signup-form-in-wordpress/).
1818

19+
=== Access token Encryption ===
20+
21+
The plugin stores the OAuth access token in the WordPress database and encrypts it for security. To ensure encryption and decryption work properly, the plugin needs access to certain security constants that should remain unchanged.
22+
23+
By default, the plugin uses the `LOGGED_IN_KEY` and `LOGGED_IN_SALT` constants from the wp-config.php file. These usually work well. However, if another plugin or mechanism regularly updates these constants, the plugin will have trouble decrypting the access token and you’ll need to reconnect your Mailchimp account.
24+
25+
To prevent such issues, it is recommended to define two additional constants in your 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 https://api.wordpress.org/secret-key/1.1/salt/ and use them. You should have additional code like the following in your wp-config.php file:
26+
27+
`
28+
define( 'MAILCHIMP_SF_ENCRYPTION_KEY', 'put your unique phrase here' );
29+
define( 'MAILCHIMP_SF_ENCRYPTION_SALT', 'put your unique phrase here' );
30+
`
31+
32+
If you add these constants after the plugin is already configured, the plugin will use the new constants, which may cause issues. To avoid this, you can copy the values from `LOGGED_IN_KEY` and `LOGGED_IN_SALT` to `MAILCHIMP_SF_ENCRYPTION_KEY` and `MAILCHIMP_SF_ENCRYPTION_SALT`. If you prefer new values, you will need to reconnect your Mailchimp account.
33+
1934
== Frequently Asked Questions ==
2035

2136
= Can I have multiple forms on one page? =

0 commit comments

Comments
 (0)