fredbradley/socs-calendar-ics-parser

一个PHP脚本,可以从SOCS解析ICS文件,并以可读的格式在其他地方显示。

2.0.0 2021-09-30 13:40 UTC

README

一个PHP脚本,可以从SOCS解析ICS文件,并以可读的格式在其他地方显示。

功能

  • 超级容易使用。
  • 一旦将其包含在您的composer包中,只需一行代码即可获取一个包含事件对象的PHP数组。
  • 如果使用WordPress,则与WordPress Transients兼容。
  • 如果使用Laravel,则与Laravel缓存兼容。
  • 积极维护 - 如果您有功能或想法请求,请告诉我,或者更好的是 - 提交一个pull request

要求

此项目需要PHP 7。我懒得为PHP 5.6编写了。跟上进度吧!

如何安装

composer install fredbradley/socs-calendar-ics-parser

示例

WordPress小工具示例

这是为与WordPress兼容而编写的,甚至内置了WordPress缓存(set_transient)功能,以提高页面加载速度。

如果您想查看使用此代码的小工具示例,请查看此代码片段在我 'cranleigh-socs' 插件中。如果您喜欢,可以安装整个Cranleigh SOCS插件,但请注意,它是用Bootstrap 3编写的,带有针对我们网站的特定HTML标记。

Wordpress Example

如果您需要帮助定制,我会很乐意帮忙。

使用方法

选项

  • minNumEvents(默认:5)
  • ignoreCache(默认:false)如果您不想从缓存中获取对象,则设置为true
  • cacheName(默认:'calendar-cache')如果您有此实例的多个实例,您可能应该为每个实例提供一个唯一的缓存名称,以免相互覆盖。
  • weeksAhead(默认:15)您想获取多少周的事件

使用默认选项的基本示例

$ics_url = "<YOUR URL FOR YOUR ICS HERE>";
$calendar = new \FredBradley\SOCSICSParser\CalendarEvents( $ics_url );

使用自定义选项的示例

$ics_url = "<YOUR URL FOR YOUR ICS HERE>";
$options = [
  'minNumEvents' => 10,
  'cacheName' => 'my-music-calendar'
];
$calendar = new \FredBradley\SOCSICSParser\CalendarEvents( $ics_url, $options );