This plugin is designed for users of the
Church Theme Content WP plugin.
It adds the ability to synchronise people data from Fellowship One into CTC people records.
Requirements
- The Church Theme Content WP plugin. Note that CTC Integration
will still install without CTC, but you wont be able to run anything. Tested against CTC 1.0.8+
- The PHP cURL library to communicate with Fellowship One. This plugin, once activated, will check that cURL exists and
inform you if it doesn't, as well as preventing you from running the affected synchronisations.
From your WordPress dashboard
- Visit 'Plugins > Add New'
- Search for 'Church Theme Content Integration'
- Activate Church Theme Content Integration from your Plugins page.
From
WordPress.org
- Download Church Theme Content Integration.
- Upload the 'church-theme-content-integration' directory to your '/wp-content/plugins/' directory, using your favorite method (ftp, sftp, scp, etc...)
- Activate Church Theme Content Integration from your Plugins page.
Setup (Important!)
Fellowship One
In order to sync data from your Fellowship One account:
-
Get your API key:
-
Select the People, Groups, and Events realms. Currently only the People and Group realms are required, but support for Events may be added later.
- In WP, navigate to CTC Integration -> Fellowship One. Enter your API URL (base URL only, minus the '/v1/'),
Consumer Key and Consumer Secret.
- If you are using 2nd party credential based authentication, enter your username and password. However, note that this
will be stored as plain text in the wordpress database, so use with care!
Difference between 2nd Party and 3rd Party authentication
This plugin allows you to use either authentication method.
To keep it simple, if in doubt, use 3rd party authentication as it is more secure. Use 2nd-party only if you know the risks.
Here are some reasons to help you decide.
Use 3rd party authentication if:
- You want the best security.
- You are happy (or indeed, would prefer) to only allow those with Fellowship One accounts to be able to run the
synchronisation.
Use 2nd Party authentication if:
- You are ok with having the username and password of one of your Fellowship One accounts stored as plain text
in the WP database.
- You would like to allow individuals at your church with web admin access the ability to synchronise data even if
they don't have a Fellowship One account.
People Sync Setup
- In Fellowship One, create people list(s) of the people that you want to sync.
- In Wordpress Admin, under CTC Integration -> Fellowship One, add the names of those people list(s) to the 'People Lists to Sync' option.
Uninstallation
If you decide to uninstall the plugin, the uninstall process will delete all custom tables, and custom post meta tags,
that this plugin uses to track associations between CTC records and the service provider records that they were
synced from. This does not make any changes to the data that was synced, that is, the CTC fields themselves.