-
Notifications
You must be signed in to change notification settings - Fork 10
/
readme.txt
executable file
·249 lines (141 loc) · 10.9 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
=== CiviCRM Member Sync ===
Contributors: needle, cuny-academic-commons
Donate link: https://www.paypal.me/interactivist
Tags: civicrm, member, membership, sync
Requires at least: 4.9
Tested up to: 6.6
Requires PHP: 7.4
Stable tag: 0.6.4a
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/old-licenses/gpl-2.0.html
Keep WordPress Users in sync with CiviCRM Memberships by granting either a Role or Capabilities to Users with that Membership.
== Description ==
CiviCRM Member Sync keeps a WordPress User in sync with a CiviCRM Membership by granting either a Role or Capabilities to a WordPress User who has that Membership.
This enables you to have, among other things, members-only content on your website that is only accessible to current members as defined by the Membership Types and status rules that you set up in this plugin's settings. CiviCRM Member Sync is compatible with both the [Members](https://wordpress.org/plugins/members/) and [Groups](https://wordpress.org/plugins/groups/) plugins for managing members-only content in WordPress. See the Installation section for details.
### Requirements
This plugin requires a minimum of *WordPress 4.9* and *CiviCRM 5.19*. It is compatible with the [Members](https://wordpress.org/plugins/members/) and [Groups](https://wordpress.org/plugins/groups/) plugins. Please refer to the Installation page for configuration instructions.
It is also strongly recommended that you also install [CiviCRM Admin Utilities](https://wordpress.org/plugins/civicrm-admin-utilities/) and have version 0.6.8 or greater activated. Make sure the checkbox labelled "Check this to fix the Contact 'soft delete' process" is checked so that Contacts that have been "soft deleted" have their corresponding WordPress User's status updated.
### Plugin Development
This plugin is in active development. For feature requests and bug reports (or if you're a plugin author and want to contribute) please visit the plugin's [GitHub repository](https://github.com/christianwach/civicrm-wp-member-sync).
### Shouts Out To...
This plugin builds on the [work](https://github.com/tadpolecc/civi_member_sync) done by [Tadpole Collective](https://tadpole.cc) and originally developed by [Jag Kandasamy](https://github.com/jeevajoy). Kudos.
== Installation ==
1. Extract the plugin archive
1. Upload plugin files to your `/wp-content/plugins/` directory
1. Make sure CiviCRM is activated and properly configured
1. Activate the plugin through the 'Plugins' menu in WordPress
The first thing to decide is whether you want CiviCRM Member Sync to synchronize CiviCRM Memberships to WordPress Roles or WordPress Capabilities. If, for example, you need your WordPress User Roles to be independent of Membership Status, then choose Capabilities. The default synchronisation method is Capabilities, because WordPress has limited support for multiple Roles.
<h4>Working with Capabilities</h4>
1. Visit the plugin's admin page at "CiviCRM" --> "Member Sync".
1. Select "Capabilities" as the sync method
1. Click on "Add Association Rule" to create a rule. You will need to create a rule for every CiviCRM Membership Type you would like to synchronize. For every Membership Type, you will need to determine the CiviMember states that define the member as "current" thereby granting them the appropriate WordPress Capabilities. It is most common to define "New", "Current" and "Grace" as current. Similarly, select which states represent the "expired" status thereby removing the WordPress Capabilities from the User. It is most common to define "Expired", "Pending", "Cancelled" and "Deceased" as the expired status.
1. "Current Status" adds a "Membership Capability" to the WordPress User, while "Expired Status" removes the "Membership Capability" from the WordPress User. This Capability will be of the form "civimember_ID", where "ID" is the numeric ID of the Membership Type. So, for Membership Type 2, the Capability will be "civimember_2".
1. **Note:** If you have the [Groups](https://wordpress.org/plugins/groups/) plugin active, then all "civimember_ID" Capabilities will be added to its custom Capabilities as well as to the list of Capabilities used to enforce read access on Posts. If you have Groups 2.8.0 or greater installed, then you will have the option to specify one or more "current" and "expired" Groups to which Users will be synced depending on whether their Membership is "current" or "expired".
1. **Note:** If you have the [Members](https://wordpress.org/plugins/members/) plugin active, then the "restrict_content" Capability will also be added.
1. **Note:** If you have [BuddyPress](https://wordpress.org/plugins/buddypress/) active, then you will have the option to specify one or more "current" and "expired" Groups to which Users will be synced depending on whether their Membership is "current" or "expired".
1. An additional "Membership Status Capability" will also be added to the WordPress User that is tied to the status of their Membership. This Capability will be of the form "civimember_ID_NUM", where "ID" is the numeric ID of the Membership Type and "NUM" is the numeric ID of the "Membership Status". So, for Membership Type 2 with Membership Status 4, the Capability will be "civimember_2_4".
<h4>Working with Roles</h4>
1. Visit the plugin's admin page at "CiviCRM" --> "Member Sync".
1. Select "Roles" as the sync method
1. Click on "Add Association Rule" to create a rule. You will need to create a rule for every CiviCRM Membership Type you would like to synchronize. For every Membership Type, you will need to determine the CiviMember states that define the member as "current" thereby granting them the appropriate WordPress Role. It is most common to define "New", "Current" and "Grace" as current. Similarly, select which states represent the "expired" status thereby removing the WordPress Role from the User. It is most common to define "Expired", "Pending", "Cancelled" and "Deceased" as the expired status. With 'roles' as your synchronization method, also set the Role to be assigned if the Membership has expired in "Expiry Role". This is not needed when working with Capabilities.
1. It may sometimes be necessary to manually synchronize Users. Click on the "Manual Synchronize" tab on the admin page to do so. You will want to use this when you initially configure this plugin to synchronize your existing Users.
1. **Note:** If you have the [Groups](https://wordpress.org/plugins/groups/) plugin activated and it is version 2.8.0 or greater, then you will have the option to specify one or more "current" and "expired" Groups to which Users will be synced depending on whether their Membership is "current" or "expired".
* **Note:** If you have [BuddyPress](https://wordpress.org/plugins/buddypress/) active, then you will have the option to specify one or more "current" and "expired" Groups to which Users will be synced depending on whether their Membership is "current" or "expired".
<h4>Manual Synchronize</h4>
It may sometimes be necessary to manually synchronize Users. Click on the "Manual Synchronize" tab on the admin page to do so. You will want to use this when you initially configure this plugin to synchronize your existing Users.
<h4>Test Test Test</h4>
**Note:** Be sure to test this plugin thoroughly before using it in a production environment. At minimum, you should log in as a test User to ensure you have been granted the appropriate Role or Capabilities when that User is given Membership. Then take away the Membership for the User in their CiviCRM record, log back in as the test User, and make sure you no longer have that Role or those Capabilities.
<h4>Known Issues</h4>
Code that used the `civi_wp_member_sync_after_insert_user` hook to send User Notifications on User Account creation should switch to the newer `civi_wp_member_sync_post_insert_user` hook to avoid the inadvertent loss of session data.
== Changelog ==
= 0.6.3 =
* Deletes BuddyPress and "Groups" group memberships when a CiviCRM Membership is deleted
= 0.6.2 =
* Maintenance release
= 0.6.1 =
* Provides a default Domain ID when none is passed
* Makes sure the CAU URL is rendered when needed
= 0.6.0 =
* Fixes missing hidden inputs
= 0.5.5 =
* Apply username filter when performing dry run
* Misc codestyle improvements
= 0.5.4 =
* Fix loading of "Add Rule" screens
= 0.5.3 =
* Fix Membership status on CAU listing screen
* Set default for WordPress pseudo-cron to "off"
= 0.5.2 =
* Introduce actions during "rule_undo" process
= 0.5.1 =
* Introduce "From - To" functionality for Manual Sync
* Introduce "civi_wp_member_sync_membership_deleted" action
= 0.5 =
* Introduce "Dry Run" functionality
* Compatibility with CiviCRM Admin Utilities "Manage Users" screen
= 0.4.7 =
* Support for syncing to BuddyPress Groups
* Fix sync for CiviCRM Memberships that do not require payment.
= 0.4.6 =
* Housekeeping release
= 0.4.5 =
* Fix validation on "Rule Add" screen
= 0.4.4 =
* Allow selection of multiple Membership Types when adding an Association Rule
* Introduce "civi_wp_member_sync_post_insert_user" action
= 0.4.3 =
* Introduce "civi_wp_member_sync_contact_retrieved" filter
* Fix references to CiviCRM WP Profile Sync methods
= 0.4.2 =
* Introduce "bulk create association rules" functionality
* Ask for confirmation before deleting an Association Rule
= 0.4.1 =
* Fix sync for Contacts in Trash - fix requires CiviCRM Admin Utilities 0.6.8+
= 0.4 =
* Support access control based on "Groups" plugin Group Membership
= 0.3.8 =
* Fix fatal error when renewing and changing Membership Type
= 0.3.7 =
* Allow Manual Sync batch count to be filtered
* Ensure usernames are unique during WordPress User creation
= 0.3.6 =
* Allow sync to be restricted to CiviCRM Contacts of Contact Type "Individual"
= 0.3.5 =
* Fix creation of WordPress User on new Membership
= 0.3.4 =
* Make order of processed Memberships explicit
* Support renewals dureing which the Membership Type changes
= 0.3.3 =
* Pass CiviCRM Contact ID to "civi_wp_member_sync_auto_create_wp_user" filter
* Allow limitless API queries where needed
= 0.3.2 =
* Add filter for username prior to creation of WordPress User
= 0.3.1 =
* Fix bug in PHP 7
= 0.3 =
* Support multiple Memberships per Contact
* AJAX-driven Manual Sync admin page
* Fix sync when Membership is renewed
= 0.2.7 =
* Disambiguate network-activated and site-activated installs
* Fix courtesy links to settings pages
= 0.2.6 =
* Fixes scheduled sync
= 0.2.5 =
* Updates compatibility with Civi plugin
= 0.2.4 =
* Adds actions and filters at critical points
= 0.2.3 =
* Adds compatibility with Groups plugin
* Better uninstallation cleanup
= 0.2.2 =
Fixes sync all reference Props EventConsulting.
= 0.2.1 =
Fixes current WordPress Role selector. Props EventConsulting.
= 0.2 =
First public release
= 0.1 =
Initial release
== Upgrade Notice ==
= 0.3.6 =
This version introduces a setting to allow sync to be restricted to CiviCRM Contacts of Contact Type "Individual". Once you have upgraded, please review plugin settings to make sure yours are correct.