搜索boxhead / craft-churchsuite-events
将 ChurchSuite 事件同步到 Craft 作为原生元素。
Requires
- php: >=8.0.2
- craftcms/cms: ^4.5.0
Requires (Dev)
- craftcms/ecs: dev-main
- craftcms/phpstan: dev-main
README
将 ChurchSuite 事件同步到 Craft 作为原生元素。
要求
此插件需要 Craft CMS 4.5.0 或更高版本，以及 PHP 8.0.2 或更高版本。
安装
您可以从插件商店或使用 Composer 安装此插件。
使用 Composer
打开您的终端并运行以下命令
# go to the project directory cd /path/to/my-project.test # tell Composer to load the plugin composer require boxhead/craft-churchsuite-events # tell Craft to install the plugin ./craft plugin/install churchsuite-events
配置 churchsuite-events
安装完成后，您需要使用您的 ChurchSuite 组织/教堂处理设置插件设置，如您的 ChurchSuite URL 中所示。例如，URL https://abcd.churchsuite.com/ 中的 abcd。
安装过程将生成一些自定义字段、一个文件系统和卷来存储事件图像，以及一个事件类别组。您可以更改这些元素的名称和标签，但不应更改处理程序。在插件安装时删除这些字段也可能导致同步过程出现问题。
根据您的需要，您可以创建额外的自定义字段并将它们分配到设置中的 ChurchSuiteEvent 元素字段布局。
使用 churchsuite-events
同步过程从 ChurchSuite 日历 JSON 提供程序 中提取所有可用事件，并为每个事件创建一个新的事件元素。同步过程还将更新 ChurchSuite 中已更改的现有事件。同步过程不会删除 ChurchSuite 中已删除的事件，但将为任何缺失的或历史事件设置禁用状态。
可以从插件的实用工具页面手动运行同步过程，或将其设置为按计划自动运行。您还可以使用 ./craft churchsuite-events/events/sync 命令从命令行运行同步过程。
Twig 模板
插件提供了一个 craft.churchsuiteevents() 方法来查询事件。该方法返回一个 craft\elements\db\ElementQuery 实例，可以用来进一步细化查询。
{% set events = craft.churchsuiteevents().all() %}