Blocks For ChurchSuite allows you to display certain data from ChurchSuite\non your Wordpress website without resorting to embedding iframes. This\nplugin provides Blocks that are easy to drop into any page or post. Each\nblock will, behind the scenes, request data from your ChurchSuite feed,\nand will display the data returned in a similar way to the usual\nChurchSuite iframes, but natively to your website. Many aspects of the\ndisplay can be modified in your theme to make the display match your\nwebsite theme. The blocks allow you to use a range of attributes so that\nyou can display just the information you want for each part of your\nwebsite.<\/p>\n\n
For the technical among you: This block works on the 'server side',\nbuilding the response which is delivered to your browser from churchsuite.<\/p>\n\n
If you have a problem or a feature request, please send a message to the author.<\/p>\n\n
Currently there is no demo site, but you can view examples on a church website:<\/p>\n\n
This plugin relies on information provided by ChurchSuite using their\n'embed' JSON feed. Details of this JSON feed can be found here:<\/p>\n\n
https:\/\/github.com\/ChurchSuite\/churchsuite-api\/blob\/master\/modules\/embed.md<\/p>\n\n
For the Event Cards block<\/em>, place the block into a page or post. Set\nthe name of your ChurchSuite feed in the Church Name attribute (ie.\nthe name that is at the start of your churchsuite url e.g.\nhttps:\/\/mychurch.churchsuite.com - the name is 'mychurch').<\/p>\n\n You should see the block populate with events in the\neditor straightaway<\/p>\n\n You can ude the various parameters in the side bar to refine your\nsearch for events - see below for the many options<\/p>\n\n Because your calendar will have many<\/em> events, we can limit the number\nof events which are returned using the Number Of Events attribute\ncombined with the Days Ahead attribute. This latter attribute sets\nhow many days ahead you will look over to find a set of events from.\nIf this is set too large and you have a lot of events, the data\nrequest from ChurchSuite will take too long to return. So just\nexperiment until you get the number of events over the time period\nyou want.<\/p>\n\n Other attributes allow you to refine the events returned as follows:<\/p>\n\n And, in the 'Advanced' group you can do further refinements:<\/p>\n\n Details of these attributes and their values can be found here:<\/p><\/li>\n<\/ul>\n\n https:\/\/github.com\/ChurchSuite\/churchsuite-api\/blob\/master\/modules\/embed.md<\/p>\n\n For the Event List block<\/em>, place the block into a page or post. Set\nthe name of your ChurchSuite feed in the Church Name attribute (ie.\nthe name that is at the start of your churchsuite url e.g.\nhttps:\/\/mychurch.churchsuite.com - the name is 'mychurch').<\/p>\n\n You should see the block populate with events in the\neditor straightaway<\/p>\n\n The comments above about attributes you can set also apply to this\nblock. By default only a maximum of 5 days events are returned, but\nthis can be overridden using the attributes.<\/p><\/li>\n For the Calendar block<\/em> , place the block into a page or post. Set\nthe name of your ChurchSuite feed in the Church Name attribute (ie.\nthe name that is at the start of your churchsuite url e.g.\nhttps:\/\/mychurch.churchsuite.com - the name is 'mychurch').<\/p>\n\n You should see the calendar block populate with events in the\neditor straightaway.<\/p>\n\n Fewer customization parameters are available for this block because\nonly a subset of the parameters listed above make sense for a monthly\ncalendar.<\/p><\/li>\n For the Smallgroups block<\/em>,, place the block into a page or post. Set\nthe name of your ChurchSuite feed in the Church Name attribute (ie.\nthe name that is at the start of your churchsuite url e.g.\nhttps:\/\/mychurch.churchsuite.com - the name is 'mychurch').<\/p>\n\n You should see the block populate with groups in the\neditor straightaway.<\/p>\n\n The only parameter for SmallGroup lists that ChurchSuite supports is\nthe sites parameter, which you will find under the 'Advanced' section.<\/p><\/li>\n<\/ul>\n\n The plugin itself is released under the GNU General Public License. A\ncopy of this license can be found at the license homepage or in the top\ncomment within the From within Wordpress - In the Wordpress Dashboard use the menu to go\nto Plugins and from there choose 'Add new plugin'. Search for\n'churchsuite' and then look for this plugin. Select the 'install'\nbutton on the plugin to install it, and once installed use the\n'activate' link to activate the plugin.<\/p><\/li>\n If you want to install from gitlab:<\/p>\n\n Once you have used either method to install the plugin, you need to\nthen add a block (see examples below) to your wordpress posts or pages\nwhere you need them<\/p><\/li>\n<\/ul>\n\n\n The default behaviour when there is an error is to give no output\nrather than produce error messages all over your website. Check\nthat you have supplied the correct churchname, or test it with the\nchurchname 'demo' to see if that is the problem. Check that you can\nactually get to your ChurchSuite JSON api url - try entering the\nfollowing URL in a browser with your church name instead of You must use the block You can use the Number of Events block attribute to show a\nparticular number of events.<\/p><\/dd>\n By default the Events List only looks ahead 5 days and Events Cards\nonly 20 days. If your future events are beyond that nothing will\nshow, or if you are only looking for featured events or events\nwithin a particular category or with a particular name, none may be\nwithin the number of days being searched. So just adjust the Days\nAhead attribute or the search parameters.<\/p><\/dd>\n All search attributes are 'sanitized' to legal values before they are\nused, and if a sane legal value cannot be found the attribute is\ndiscarded. So, for example, a date like 2025-02-40 would be ignored.\nThe block doesn't change what you have entered into the attributes so\nas not to confuse you. So, just try some different attribute values\nuntil you get something legal. If in doubt, remove the block and add\na new block - this will start with 'sane' default values, and you\ncan test on the 'demo' site ChurchSuite provides to see what it\nreturns. Alternatively, use the Church Name 'cambray' to test - it\nhas a busy programme of events and so most queries will return a\nresult if legal search values are given.<\/p><\/dd>\n In general the blocks don't seek to set fonts and only use relative\ntext sizes. So, by setting fonts or text size in surrounding\nblocks you will see changes in the blocks themselves. You can also\nuse the font size attributes in the style tab to set the base font\nsize.<\/p>\n\n In addition to the text size, the background, margins and padding of\nthe containing box, and whether it is displayed in normal, wide or\nfull width can be adjusted from the block attributes in the sidebar\nstyle tab.<\/p>\n\n For things like line or background color within the block, all block\noutput is formatted via css - just override the default css rules\nin your theme. All the CSS rules begin with 'b4cs-' and so these\nare easy to find in your browser's inspector panes. Once overridden\nin your theme css file you can make them fit well with your theme.<\/p><\/dd>\n Because there are css rules for every part of the block, there is a\nlot you can do just in css. For example, the dramatic change in\nformat of the calendar from a monthly grid to an events list when\nit is displayed on a narrow screen is all accomplished by css rules.\nSo, you may be able to achieve what you want via css rule changes.<\/p>\n\n If your idea is dramatically different, however, please use the\nsupport forum to put in a request for a new feature. We will do\nwhat we can to provide anything which might also be useful to others.<\/p><\/dd>\n\n<\/dl>\n\n\n 2026-04-15<\/strong>\n* Version bump to 1.0.5 to ensure plugins are updated for new features<\/p>\n\n 2026-04-14<\/strong>\n* Added a distinct ChurchSuite icon for each block, and added a new block\n category to group the ChurchSuite blocks within.\n* Further minor change to CSS for Event Lists to make the shadow more subtle.<\/p>\n\n 2026-04-13<\/strong>\n* Added image pickers for the default image for Event Cards and Small\n Groups so that the provided default image can be overridden.\n* Minor css fixes to space the Event List text better.\n* Version bump to 1.0.4<\/p>\n\n 2026-03-27<\/strong>\n* Minor changes to add readme.md file and to change comments from github\n to gitlab after moving the development repository.<\/p>\n\n 2026-02-26<\/strong>\n* Refactored the Locale code to use the wordpress site locale rather than\n the server locale, and to use the wordpress admin settings for full\n date or time output. This means the time and date output should always\n be sympathetic with the Wordpress site settings. Also moved all the\n time and date string creation to a new module so it can be easily\n modified without having to update many files.\n* Version bump to 1.0.3<\/p>\n\n 2026-02-23<\/strong>\n* Added ability to render the various views which have dates using the Locale\n to render them in local style and language.\n* Version bump to 1.0.2<\/p>\n\n 2025-12-08<\/strong>\n* Bump for Wordpress 6.9. Updated 'Tested up to:' in readme.txt, and to\n version 1.0.1 as the stable tag in blocks-for-churchsuite.php. Checked\n that all block.json files were on API_VERSION 3 ... they were. Updates\n all blocks to version 1.0.1 in their block.json files.<\/p>\n\n 2025-11-03<\/strong>\n* Final approval from Wordpress Plugin Directory given. Last tidy ups to\n bring the plugin name in line with the one the Plugin Directory allocated.<\/p>\n\n 2025-09-29<\/strong>\n* Added all ChurchSuite attributes to each block that were not previously\n present. Added the santizers for all the permitted attributes. Added\n i18n support to the blocks for potential future translators. Tidied up\n code where needed. Removed now unused js scripts and html includes for\n the old Alpine.js support. Removed duplicated css and moved non-shared\n styles into each block. Fixed an error in the display of calendar, and\n made sure we remove days with no events from the small screen event list\n rendering of the calendar. Edited the readme.txt to reflect these changes.<\/p>\n\n 2025-09-27<\/strong>\n* Added some block attributes to allow background setting for the whole\n block, permit left, right alignment of the block or wide or full spread\n for the block, and add adjustment to block padding and margins.<\/p>\n\n 2025-09-26<\/strong>\n* Working version available and ready for testing prior to submission\n to the Wordpress Plugin<\/p>\n\n 2025-09-09<\/strong>\n* Initial release - Everything is tested and working, but only a subset\n of the attributes which could be used are provided.<\/p>\n\n **2025-04-26\n* Working version with all blocks using Alpine.js. But back-end would\n not use Alpine.js. So needed to refactor it all to use PHP only.<\/p>\n\n **2025-04-02\n* First attempt to move the Shortcode plugin cs-js-integration to a block<\/p>","raw_excerpt":"Blocks For ChurchSuite is a plugin providing blocks that enable display of event and small group data from ChurchSuite in various ways.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/255308","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=255308"}],"author":[{"embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/dramb"}],"wp:attachment":[{"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=255308"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=255308"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=255308"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=255308"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=255308"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=255308"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}\n
\n
\n
License<\/h3>\n\n
blocks4cs.php<\/code> file.<\/p>\n\n\n\n
\n
\n
The block produces no output<\/h3><\/dt>\n
mychurch<\/code>:<\/p>\n\n https:\/\/mychurch.churchsuite.com\/embed\/calendar\/json?num_results=3\n<\/code><\/pre><\/dd>\nHow do I add my church so that I get the JSON feed for my church?<\/h3><\/dt>\n
Church Name<\/code> attribute to enter the name of\nyour church which appears at the start of the churchsuite URL for\nyour church.<\/p><\/dd>\nI want to limit the number of events in the block<\/h3><\/dt>\n
The block is not showing any results<\/h3><\/dt>\n
I've changed a search attribute but the seems to be no change to the results<\/h3><\/dt>\n
I want to change how the output looks:<\/h3><\/dt>\n
I want a list of events which looks very different to those you provide<\/h3><\/dt>\n
1.0.5<\/h4>\n\n
1.0.4<\/h4>\n\n
1.0.3<\/h4>\n\n
1.0.2<\/h4>\n\n
1.0.1<\/h4>\n\n
1.0.0<\/h4>\n\n
0.1.0<\/h4>\n\n