Church Community Builder Core API

Description

Church Community Builder Core API synchronizes your church data to WordPress custom post types.

This plugin is geared toward Developers, Designers, and Site Administrators who aren’t afraid to get into a little bit of code.

Find out more at https://www.wpccb.com and https://github.com/jaredcobb/ccb-core.

Why Use This Plugin?

One of the biggest challenges with getting your Church Community Builder data onto your site is the actual API integration. This plugin does all of the heavy lifting for you. Once your church data is securely synchronized you can use it freely in your theme, widgets, or even your own plugins!

Features

  • Get your Public Groups
  • Get your Public Events
  • Auto-synchronize (set it and forget it)
  • Manually synchronize anytime
  • Cached data (extremely fast)
  • Works in the background (never interrupts you or your visitors)
  • Secure (API communication is encypted, and so are your credentials)

Documentation

Extensive developer documentation is available on the GitHub wiki.

Screenshots

  • screenshot-1.png
  • screenshot-2.png

Installation

  1. Upload the entire plugin folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. You’ll find a settings page in a sidebar menu titled “CCB Core API”
  4. Enter your Church Community Builder software subdomain
  5. Enter your Church Community Builder API credentials
  6. Enable the synchronizations you’d like

FAQ

Installation Instructions
  1. Upload the entire plugin folder to the /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. You’ll find a settings page in a sidebar menu titled “CCB Core API”
  4. Enter your Church Community Builder software subdomain
  5. Enter your Church Community Builder API credentials
  6. Enable the synchronizations you’d like
I installed this plugin and my site doesn’t look any different

This plugin has a very specific task: It gets some of your Church Community Builder data and imports it into your WordPress database (as custom post types). A developer (or advanced WordPress administrator) will need to alter your theme to take advantage of this data.

Some of my groups in Church Community Builder aren’t being synchronized

You’ll need to ensure your group settings allow the group to be publicly listed. A great way to cross reference if your group is publicly visible is to visit yoursubdomain.ccbchurch.com/w_group_list.php and see if the missing group shows up there.

Reviews

Love it

What a great plugin, being a non coder I was able with the help of the support questions figure out how to add my groups and events to my churches website. Thanks so much for your awesome plugin!

excellent!

With the recent update this plugin does exactly what I need, no more and no less: it allows me to easily incorporate CCB group data into my WordPress site in a clean lightweight plugin. Jared’s support has been above and beyond. Highly recommend for church sites using CCB and WordPress.

Read all 2 reviews

Contributors & Developers

“Church Community Builder Core API” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.6

  • Fixes a bug where admin libraries may not be loaded under some cron contexts.

1.0.5

  • Fixes a bug where events could be duplicated on subsequent synchronizations.

1.0.4

  • Adds the CCB event id (as post meta) to each instance of a recurring event. This allows individual instances of a recurring event to be associated with each other in WordPress.

1.0.3

  • Featured images associated with synchronized posts now also get deleted when the post is deleted
  • A new filter ccb_core_synchronizer_delete_attachment has been created to optionally overwrite the default behavior of deleting attachments when posts are deleted
  • Any images that are synchronized automatically get a post meta key of ccb_core with a value of true (in case you need to programmatically query for CCB images in the future)

1.0.2

  • Fixed a bug to allow subdomains with dashes
  • Remove PHP 5.4 array syntax from the main plugin file (prevent crashes on PHP < 5.4)

1.0.1

  • Fixed a bug where terms are not populated in some circumstances
  • Added checks for minimum PHP and WordPress versions to prevent crashes

1.0.0

  • Official stable release
  • Breaking Changes – Please note that post type and custom taxonomy names have changed (see release notes )
  • Fixed broken group images (CCB API query parameter include_image_link=true)
  • Refactored code to be faster, simpler, and easier to extend

0.9.6

  • Added automatic flushing of rewrite rules when custom post type settings are changed
  • Added link to official documentation in README and About page

0.9.5

  • Added an option to import Group Images as the Featured Image (no longer referencing the CCB CDN location which expires quickly)
  • Added filters which allow you to customize the API to Custom Post Type mappings:
    • add_filter( 'ccb_include_group_participants' ), whether or not to ask the API to include group participants in the response
    • add_filter( 'ccb_get_groups_taxonomy_map' ), ability to customize the taxonomy mapping for groups
    • add_filter( 'ccb_get_groups_custom_fields_map' ), ability to customize the custom fields mapping for groups
    • add_filter( 'ccb_get_calendar_taxonomy_map' ), ability to customize the taxonomy mapping for events
    • add_filter( 'ccb_get_calendar_custom_fields_map' ), ability to customize the custom fields mapping for events
  • Added ability to automatically import collections of meta data (for example, multiple group leaders)

0.9.4

  • Added Group “Meet At” address and longitude / latitude coordinates as custom fields

0.9.3

  • Fixed a bug for backwards compatibility with PHP 5.2 servers

0.9.2

  • Added tooltips to some settings to help explain the functionality
  • Added better defaults for date ranges
  • Updated the plugin web site to https://www.wpccb.com

0.9.1

  • Fixed an issue where some web hosts were not saving encypted passwords

0.9.0

  • Initial release