Skip to content
This repository has been archived by the owner on Oct 31, 2022. It is now read-only.

Commit

Permalink
Merge pull request #6 from jaredcobb/1.0.0
Browse files Browse the repository at this point in the history
1.0.0
  • Loading branch information
jaredcobb authored Jan 8, 2018
2 parents 1a6e88b + 8d46270 commit 20bc0f8
Show file tree
Hide file tree
Showing 70 changed files with 7,887 additions and 3,268 deletions.
63 changes: 63 additions & 0 deletions .travis.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
sudo: false
dist: trusty

language: php

notifications:
email:
on_success: never
on_failure: change

branches:
only:
- master

cache:
directories:
- vendor
- $HOME/.composer/cache

matrix:
include:
- php: 7.1
env: WP_VERSION=latest
- php: 7.0
env: WP_VERSION=latest
- php: 5.6
env: WP_VERSION=4.6
- php: 5.6
env: WP_VERSION=latest
- php: 5.6
env: WP_VERSION=trunk
- php: 5.6
env: WP_TRAVISCI=phpcs

before_script:
- export PATH="$HOME/.composer/vendor/bin:$PATH"
- |
if [ -f ~/.phpenv/versions/$(phpenv version-name)/etc/conf.d/xdebug.ini ]; then
phpenv config-rm xdebug.ini
else
echo "xdebug.ini does not exist"
fi
- |
if [[ ! -z "$WP_VERSION" ]] ; then
bash bin/install-wp-tests.sh wordpress_test root '' localhost $WP_VERSION
composer global require "phpunit/phpunit=4.8.*|5.7.*"
fi
- |
if [[ "$WP_TRAVISCI" == "phpcs" ]] ; then
composer global require wp-coding-standards/wpcs
phpcs --config-set installed_paths $HOME/.composer/vendor/wp-coding-standards/wpcs
fi
script:
- |
if [[ ! -z "$WP_VERSION" ]] ; then
phpunit
WP_MULTISITE=1 phpunit
fi
- |
if [[ "$WP_TRAVISCI" == "phpcs" ]] ; then
phpcs
fi
40 changes: 40 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
# Church Community Builder Core API

## A WordPress Plugin that syncs your church data

CCB Core API is a WordPress plugin that has one simple job: It **synchronizes** your church data from [Church Community Builder](https://www.churchcommunitybuilder.com/) into your WordPress database as [Custom Post Types](https://codex.wordpress.org/Post_Types#Custom_Post_Types), [Custom Taxonomies](https://codex.wordpress.org/Taxonomies#Custom_Taxonomies), and [Post Meta](https://codex.wordpress.org/Custom_Fields).

## Who should use this?

This plugin is geared toward Developers, Designers, and Site Administrators who are familiar with customizing WordPress templates. While it does a great job of synchronizing the data, you'll still need to alter your theme in order to take *advantage* of the data.

## What's included?

Out of the box, there are two complete integrations:

### Public Groups

This integration will synchronize any groups that are both _publicly listed_ and _active_ from the Church Community Builder `group_profiles` service to a Custom Post Type named `ccb_core_groups`.

### Public Calendar (Events)

This integration will synchronize all events from the Church Community Builder `public_calendar_listing` service to a Custom Post Type named `ccb_core_calendar`.

## Features

* **Auto Synchronize** - Set it and forget it! The plugin works in the background, never interrupting you or your visitors.
* **Secure** - Your credentials are encrypted, and so is the connection with the Church Community Builder API.
* **WordPress Standards** - The plugin follows WordPress coding standards and best practices, so it's easy to extend and build upon.
* **Free** - Free as in "speech" or free as in "beer"? Yes! It's [GPLv2 licensed](https://tldrlegal.com/license/gnu-general-public-license-v2). Don't you love open source?

## Customizing & Extending

* Setup additional integrations with other Church Community Builder API services.
* Write your own plugin that builds upon this one.
* Customize the existing integrations (Groups & Events).

<center>**[The Wiki](https://github.com/jaredcobb/ccb-core/wiki) has more information and code samples.**</center>

## General Usage

General usage information (setting up the plugin and customizing your theme) can be found in the [usage docs](https://www.wpccb.com/documentation/).
33 changes: 17 additions & 16 deletions README.txt
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
=== Church Community Builder Core API ===
Contributors: jaredcobb
Tags: ccb, church, api, chms
Requires at least: 3.0.1
Tested up to: 4.3.1
Stable tag: 0.9.6
Requires at least: 4.6.0
Tested up to: 4.9.1
Stable tag: 1.0.0
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Expand All @@ -12,15 +12,14 @@ Provides a core integration to the Church Community Builder API.
== Description ==

Church Community Builder Core API *synchronizes* your church data to WordPress [custom post types](https://codex.wordpress.org/Custom_Post_Types).
This plugin is geared toward developers (or advanced WordPress users who aren't afraid to get into a little bit of code).

Find out more at [http://www.wpccb.com/](http://www.wpccb.com).
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](https://www.wpccb.com) and [https://github.com/jaredcobb/ccb-core](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!
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 =

Expand All @@ -34,7 +33,7 @@ your theme, widgets, or even your own plugins!

= Documentation =

The [http://www.wpccb.com/documentation/](official documentation) has more information, including code samples, hooks, filters, and links to tutorials.
Extensive developer documentation is available on the [GitHub wiki](https://github.com/jaredcobb/ccb-core/wiki).

== Installation ==

Expand All @@ -49,15 +48,11 @@ The [http://www.wpccb.com/documentation/](official documentation) has more infor

= 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.
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](https://support.churchcommunitybuilder.com/customer/portal/articles/361764-editing-groups)
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.
You'll need to ensure your [group settings](https://churchcommunitybuilder.force.com/s/article/2102903) 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.

== Screenshots ==

Expand All @@ -66,6 +61,12 @@ allow the group to be publicly listed. A great way to cross reference if your gr

== Changelog ==

= 1.0.0 =
* Official stable release
* *Breaking Changes* - Please note that post type and custom taxonomy names have changed (see [release notes](https://github.com/jaredcobb/ccb-core/wiki/1.0.0-Stable-Release) )
* 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
Expand All @@ -89,7 +90,7 @@ allow the group to be publicly listed. A great way to cross reference if your gr
= 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 http://www.wpccb.com
* 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
Expand Down
Loading

0 comments on commit 20bc0f8

Please sign in to comment.