TYPO3 Calendarize扩展ICS导入自定义字段及外部事件接入求助

问题背景 #

需要修改Calendarize扩展的ICS导入功能，支持OpenEndTime、图片URL等自定义字段；或实现从MySQL/PHP源直接添加自定义事件的方案。尝试修改calendarize/Classes/Ical/DissectEventAdapter.php第174行的isOpenEndTime方法，硬返回true但未生效，无日志报错。

测试用ICS文件（修正标准格式后）：

BEGIN:VCALENDAR
VERSION:2.0
PRODID:PHP
METHOD:PUBLISH
X-WR-CALNAME:Events
X-WR-TIMEZONE:Europe/Berlin
BEGIN:VTIMEZONE
TZID:Europe/Berlin
BEGIN:DAYLIGHT
TZOFFSETFROM:+0100
TZOFFSETTO:+0200
DTSTART:19700329T020000
RRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=2SU
TZNAME:CEST
END:DAYLIGHT
BEGIN:STANDARD
TZOFFSETFROM:+0200
TZOFFSETTO:+0100
DTSTART:19701025T030000
RRULE:FREQ=YEARLY;BYMONTH=11;BYDAY=1SU
TZNAME:CET
END:STANDARD
END:VTIMEZONE
BEGIN:VEVENT
DTSTART;TZID=Europe/Berlin:20230512T200000
X-OPENENDTIME:true
X-IMAGE-URL:https://example.com/event1.jpg
DTSTAMP:20230509T101336Z
LOCATION:Bürgersaal
DESCRIPTION:
SUMMARY:Programm Titel
UID:19ca14e7ea6328a42e0eb13d585e4c22
SEQUENCE:0
END:VEVENT
BEGIN:VEVENT
DTSTART;TZID=Europe/Berlin:20230513T200000
X-OPENENDTIME:true
X-IMAGE-URL:https://example.com/event2.jpg
DTSTAMP:20230509T101336Z
LOCATION:Location
DESCRIPTION:
SUMMARY:Programm Titel
UID:a5771bce93e200c36f7cd9dfd0e5deaa
SEQUENCE:0
END:VEVENT
END:VCALENDAR

原修改未生效的原因 #

1. ICS格式不标准：原ICS中的openEndTime : true不符合ICS扩展字段规范，标准格式应为X-OPENENDTIME:true（大写、无前缀空格、以X-开头），解析器无法识别非标准字段。
2. 逻辑不完整：仅硬改isOpenEndTime返回值，但未从ICS中读取对应字段值，也未将值传递到Calendarize的事件存储逻辑中。

一、ICS导入支持自定义字段的实现步骤 #

1. 标准化工ICS自定义字段 #

所有自定义字段必须以X-开头，大写命名，无空格，如X-OPENENDTIME:true、X-IMAGE-URL:https://xxx.jpg。

2. 用XCLASS重写解析类（避免修改原扩展文件） #

TYPO3的XCLASS机制允许你重写原扩展的类，升级时不会覆盖修改：

• 在自定义扩展的ext_localconf.php中注册XCLASS：

$GLOBALS['TYPO3_CONF_VARS']['SYS']['Objects'][\HDNET\Calendarize\Ical\DissectEventAdapter::class] = [
    'className' => \YourVendor\YourExtension\Xclass\DissectEventAdapter::class
];

• 创建自定义XCLASS文件YourExtension/Classes/Xclass/DissectEventAdapter.php：

namespace YourVendor\YourExtension\Xclass;

use HDNET\Calendarize\Ical\DissectEventAdapter as OriginalAdapter;
use Sabre\VObject\Component\VEvent;

class DissectEventAdapter extends OriginalAdapter
{
    protected $openEndTime = false;
    protected $imageUrl = '';

    public function __construct(VEvent $event)
    {
        parent::__construct($event);
        // 读取OpenEndTime自定义字段
        if (isset($event->{'X-OPENENDTIME'})) {
            $this->openEndTime = filter_var((string)$event->{'X-OPENENDTIME'}, FILTER_VALIDATE_BOOLEAN);
        }
        // 读取图片URL自定义字段
        if (isset($event->{'X-IMAGE-URL'})) {
            $this->imageUrl = (string)$event->{'X-IMAGE-URL'};
        }
    }

    public function isOpenEndTime(): bool
    {
        return $this->openEndTime;
    }

    // 传递自定义数据到导入逻辑
    public function getCustomData(): array
    {
        $customData = parent::getCustomData();
        $customData['imageUrl'] = $this->imageUrl;
        return $customData;
    }
}

3. 保存自定义字段到数据库 #

• 如果需要将图片URL关联到TYPO3的文件系统，可监听Calendarize的导入信号，在事件保存前将URL转为sys_file记录并关联到事件字段；
• 若需新增自定义数据库字段，在自己的扩展中通过ext_tables.sql和TCA配置添加到tx_calendarize_domain_model_event表。

二、从MySQL/PHP源添加自定义事件的方案 #

直接使用Calendarize的Domain API操作事件：

示例代码（控制器环境） #

use HDNET\Calendarize\Domain\Model\Event;
use HDNET\Calendarize\Domain\Repository\EventRepository;
use TYPO3\CMS\Core\Utility\GeneralUtility;
use TYPO3\CMS\Extbase\Persistence\Generic\PersistenceManager;

// 获取Repository实例
$eventRepository = GeneralUtility::makeInstance(EventRepository::class);
$persistenceManager = GeneralUtility::makeInstance(PersistenceManager::class);

// 创建事件对象
$event = Event::create();
$event->setTitle('自定义PHP导入事件');
$event->setStartDateTime(new \DateTime('2024-01-01 19:00:00'));
// 设置OpenEndTime
$event->setOpenEndTime(true);
// 设置图片（需先将URL转为sys_file记录，此处示例用已存在的文件UID）
$file = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Resource\FileRepository::class)->findByUid(123);
$event->setImage($file);

// 保存事件
$eventRepository->add($event);
$persistenceManager->persistAll();

三、避免升级覆盖修改的最佳实践 #

1. 绝对不要直接修改原扩展文件：所有定制逻辑都放在自己的独立扩展中。
2. 优先使用XCLASS重写类：针对需要修改的原扩展类，用XCLASS继承并重写对应方法。
3. 利用信号槽（Signal/Slot）机制：如果Calendarize在关键流程（如ICS导入、事件保存）中发出信号，直接监听信号添加自定义逻辑，无需重写整个类。
4. 自定义字段通过独立扩展添加：新增数据库字段或TCA配置都放在自己的扩展中，不修改原扩展的结构。

内容的提问来源于stack exchange，提问作者Daniel