Planning Center Online Plugin Beta Release

Hi, all,

I have been working on a Planning Center Online plugin for OpenLP 2.4.6.  It's now ready to see if others can use it.

You can download the 0.1 beta release at:

Source Code is available at:  https://github.com/ghjpk/planningcenter

If you use Planning Center Online and want to try OpenLP with it, give this a whirl and let me know if it works for you.  I've been using it myself for the past 2 weeks.

Best Regards,
John Kirkland

Release Notes are below:

This is the first beta release of the Planning Center Online plugin for OpenLP.

Installation (Windows/Linux):

  1. Unzip the planningcenter.zip file into your Planning Center plugins folder, keeping the planningcenter folder intact.
  2. Start OpenLP
  3. Verify and activate the planningcenter plugin in the Settings->Manage Plugins menu.
Installation (MacOS)
  1. Right click on OpenLP in the Applications Folder and select "Show Package Contents"
  2. Unzip the planningcenter.zip file inside of the OpenLP application at Contents/MacOS/plugins, keeping the planningcenter folder intact.

Usage:

  1. Select the File->Import->Planning Center Service menu.
  2. Setup your authentication keys, following the directions in the GUI.
  3. Import Services

Recommended Settings:

  • Turn off the "Import missing songs from service files" configuration in the Songs plugin. You will get strange results if you (a) import a song, (b). change the song lyrics on Planning Center, (c) import the song again, (d) edit the song. You will display the correct lyrics in the Service Manager but if you try and "edit" the song from the ServiceManager, then you will be editing the original lyrics, not the updated ones. You are better off depending on PCO as your song database if you use this plugin.

Currently Supported Features:

  1. Importing Lyrics from Planning Center songs that are added to a service (no verse order or other media support currently)
  2. Importing slides as Custom Slides. Note: the V2 API does not have support for getting the content added to slides on Planning Center. While PCO is discussing adding this back into the V2 API, they do not intend to continue to have support for editing these slides in the Services Web GUI sometime in 2019. So... this plugin just replicates the titles of any slides onto a single-page custom slide.
  3. Updating Service. This updates the current service in OpenLP with a new copy from Planning Center Online, keeping any edits you've made since you Imported it earlier. The use case here is that you are updating Custom Slides while the band is off working on rehearsals. After rehearsals, you can use the "update" feature to pull in any lyric or song-order updates without overwriting your custom slide updates. Note: if a song or custom slide is removed from Planning Center, it will also be removed from OpenLP, even if you have updated it.

Comments

  • As also mentioned in a different thread I managed to convince our build system to create a windows test build that should include the PCO plugin. I have not tested it myself since I don't have a windows PC, so feel free to test.
    Get it here: https://ci.appveyor.com/project/OpenLP/dev/build/OpenLP-win-ci-b638/artifacts
    Note that this is not a supported build!!!
  • And... now for the 0.2 Release of the Planning Center Online Plugin for OpenLP:  https://github.com/ghjpk/planningcenter/releases

    The previous 0.1 release was based off of a standalone utility that I wrote that reverse engineered the json/xml formats in the OpenLP saved service files and then mimicked the actions of loading these into a new service.

    This 0.2 release builds upon that code and knowledge but incorporates OpenLP classes and documentation styles into the classes/methods.

    Features:

    • Changed Plan List Dates to include 10 more recent (past) and 10 future (including today).
    • Added a feature called "airplane mode" that lets me do fake queries against the Planning Center API while I'm doing development on airplanes.

    Internal Changes:

    • Refactored on_test_credentials_button_clicked to move the lower-level api calls into the api
    • Migrated all code to OpenLP SongImport,Song,and CustomSlide Classes.
    • Created CustomImport library file
    • Inline class/module/function documentation updates.
    • Removed airplane mode directory from lib



Sign In or Register to comment.