內容簡介
**Blocks4CS 總結:**
Blocks4CS 可讓您在 WordPress 網站上顯示 ChurchSuite 的特定數據，無需使用 iframe 來嵌入。此外掛程式提供易於放置在任何頁面或文章中的 Blocks。每個 Blocks 都將從您的 ChurchSuite 資料中請求數據，並將返回的資料以與常規 ChurchSuite iframe 類似的方式顯示在您的網站上。透過主題的修改，可調整顯示內容，使其與您的網站主題相匹配。這些 Blocks 允許您使用各種屬性來顯示您在網站每個部分上所需的信息。
**問題與答案:**
- 這個外掛程式目的是什麼？
- 讓您在WordPress網站上展示ChurchSuite的特定數據，而無需使用iframe。
- Blocks4CS提供哪些功能？
- 將事件作為“卡片”顯示，包含事件圖片和詳細信息的Blocks。
- 按日期分組將事件作為“清單”顯示的Blocks。
- 返回完整月曆的Blocks，可供選擇顯示當前月份或指定日期。
- 將群組作為“卡片”顯示，包含群組圖片和詳細信息的Blocks。
- 如何使用Event Cards block？
- 將block放入頁面或文章中，並在Church Name屬性中設置您的ChurchSuite feed的名稱。
- 這個外掛程序使用的API請求是否緩存？
- 是的，所有API請求都使用4小時的緩存以確保快速性能。
- 如果您在使用上遇到問題或有要求功能，應該如何聯繫？
- 請向作者發送消息。
- 是否有演示站點供查看？
- 目前沒有演示站點，但可以在教會網站上查看示例。
- 外掛程式是依賴哪個ChurchSuite提供的資訊？
- 這個外掛程式依賴ChurchSuite使用他們的'嵌入'JSON feed提供的信息。
- 有什麼進階的屬性可以用於Event Cards block？
- 包括Categories、Event Names、Sites、Events、Merge和Sequence等進階屬性。
外掛標籤
開發者團隊
原文外掛簡介
Blocks4CS allows you to display certain data from ChurchSuite on your
Wordpress website without resorting to embedding iframes. This plugin
provides Blocks that are easy to drop into any page or post. Each
block will, behind the scenes, request data from your ChurchSuite feed,
and will display the data returned in a similar way to the usual
ChurchSuite iframes, but natively to your website. Many aspects of the
display can be modified in your theme to make the display match your
website theme. The blocks allow you to use a range of attributes so that
you can display just the information you want for each part of your
website.
Current features include:
block to return events as ‘cards’ with the event image and details
block to return events in a ‘list’ group by date
block to return a full month calendar, for the current month or a date
block to return groups as ‘cards’ with the group image and details
All API requests are cached with a 4 hour cache to ensure fast performance
A little Technical information
For the technical among you: This block works on the ‘server side’,
building the response which is delivered to your browser from churchsuite.
Support
If you have a problem or a feature request, please send a message to the author.
Demo
Currently there is no demo site, but you can view examples on a church website:
the Featured Events,
the Small Groups list,
the Events List,
the Calendar
Contributions
This plugin relies on information provided by ChurchSuite using their
’embed’ JSON feed. Details of this JSON feed can be found here:
https://github.com/ChurchSuite/churchsuite-api/blob/master/modules/embed.md
Usage
For the Event Cards block, place the block into a page or post. Set
the name of your ChurchSuite feed in the Church Name attribute (ie.
the name that is at the start of your churchsuite url e.g.
https://mychurch.churchsuite.com – the name is ‘mychurch’).
You should see the block populate with events in the
editor straightaway
You can ude the various parameters in the side bar to refine your
search for events – see below for the many options
Because your calendar will have many events, we can limit the number
of events which are returned using the Number Of Events attribute
combined with the Days Ahead attribute. This latter attribute sets
how many days ahead you will look over to find a set of events from.
If this is set too large and you have a lot of events, the data
request from ChurchSuite will take too long to return. So just
experiment until you get the number of events over the time period
you want.
Other attributes allow you to refine the events returned as follows:
Start Date – the starting date to look for events
Days Ahead – the number of days ahead from the start date to look
Number of Results – the number of events to display from those returned
Featured – whether to show only events marked as ‘Featured’
And, in the ‘Advanced’ group you can do further refinements:
Categories – only look for events in the categories whose category
numbers are given
Event Names – Only list events where the string given is in the
event title (e.g. ‘service’ to return all services)
Sites – if you have a multi-site church, only look for events
for the sites whose site numbers are given
Events – Only look for events in the list of event numbers
(Useful if you want to highlight a few particular events)
Merge – List only the first event or all events in a sequence
Sequence – Only list events in a given sequence number
Details of these attributes and their values can be found here:
https://github.com/ChurchSuite/churchsuite-api/blob/master/modules/embed.md
For the Event List block, place the block into a page or post. Set
the name of your ChurchSuite feed in the Church Name attribute (ie.
the name that is at the start of your churchsuite url e.g.
https://mychurch.churchsuite.com – the name is ‘mychurch’).
You should see the block populate with events in the
editor straightaway
The comments above about attributes you can set also apply to this
block. By default only a maximum of 5 days events are returned, but
this can be overridden using the attributes.
For the Calendar block , place the block into a page or post. Set
the name of your ChurchSuite feed in the Church Name attribute (ie.
the name that is at the start of your churchsuite url e.g.
https://mychurch.churchsuite.com – the name is ‘mychurch’).
You should see the calendar block populate with events in the
editor straightaway.
Fewer customization parameters are available for this block because
only a subset of the parameters listed above make sense for a monthly
calendar.
For the Smallgroups block,, place the block into a page or post. Set
the name of your ChurchSuite feed in the Church Name attribute (ie.
the name that is at the start of your churchsuite url e.g.
https://mychurch.churchsuite.com – the name is ‘mychurch’).
You should see the block populate with groups in the
editor straightaway.
The only parameter for SmallGroup lists that ChurchSuite supports is
the sites parameter, which you will find under the ‘Advanced’ section.
License
The plugin itself is released under the GNU General Public License. A
copy of this license can be found at the license homepage or in the top
comment within the blocks4cs.php file.
