xima/xima-typo3-page-subscription
Composer 安装命令：
composer require xima/xima-typo3-page-subscription
包简介
This extension provides an update subscription functionality for frontend user regarding changes on content elements on a page.
README 文档
README
TYPO3 extension xima_typo3_page_subscription
This extension provides an update subscription functionality for frontend user regarding changes on content elements on a page.
Note: This extension is still under development and not yet ready for production.
Principles
What does it do?
- Subscribe as frontend user to a page
- Manage your subscriptions
- Get notified by mail about updates on subscribed pages
- Informing about new or changed content elements
- Providing a console command for checking updates
- Providing a crawler for fetching content elements
- Support partly subscriptions for single content elements
What does it not do?
- Providing detailed information about changed fields
- Informing about deleted content elements
Challenges
- Keeping dynamic elements on a page in mind, e.g. all entries of a news teaser list, which are basically not referenced on the coressponding page
- Finding all content data which are relevant for the frontend (not every update is a relevant change for a frontend user)
Requirements
- TYPO3 >= 12.4 & PHP 8.1+
Installation
Composer
composer require xima/xima-typo3-page-subscription
Configuration
Include the static TypoScript template "Page subscription" or directly import it in your sitepackage:
@import 'EXT:xima_typo3_page_subscription/Configuration/TypoScript/setup.typoscript'
See the extension settings in the TYPO3 backend for further configuration.
Template
Add the surrounding xtps:updateInformation viewhelper to your templates, e.g. to a general layout file.
Scheduler
Install the scheduler task for the console command page-subscription:check-updates in the TYPO3 backend.
Easy setup
ToDo
Concept
The general workflow is as follows:
- Frontend user is logged in
- User subscribes to a page
- Content of subscribed page is edited by a backend user
- Scheduler tasks runs in period and checks for updates
- Frontend user gets notified by mail
The technical implementation is based on the following concepts:
JavaScript
Use the PageSubscription class to handle the subscription of pages in the frontend. Example below:
import PageSubscription from '../path/to/extension/xima_typo3_page_subscription/Resources/Public/JavaScript/PageSubscription.js'; const toggleButton = document.querySelector('.toggle-subscription'); toggleButton.addEventListener("click", async function(){ const data = await PageSubscription.toggle(this, PageSubscription.Type.Subscription, this.element.getAttribute('data-page-subscription-pid')); if (data.result == true) { this.classList.add('subscribed'); } else { this.classList.remove('subscribed'); } });
ViewHelper
<html xmlns:xtps="http://typo3.org/ns/Xima/XimaTypo3PageSubscription/ViewHelpers" data-namespace-typo3-fluid="true"> <xtps:updateInformation object="{data}"> <!-- Content Element Rendering Template --> </xtps:updateInformation>
The viewhelper only occurs in the dom when crawler is active and renders a surrounding div with the metadata attributes around the content element.
Interpreter
Interpreter are used to build metadata information for the view helper and generate target links.
The following interpreters are available:
Create custom interpreter using the InterpreterInterface and register the new interpreter in your ext_localconf.php (example below):
$GLOBALS['TYPO3_CONF_VARS']['EXTENSIONS']['xima_typo3_page_subscription']['registerInterpreter'][\TYPO3\CMS\Core\Resource\File::class] = \Xima\XimaTypo3PageSubscription\Interpreter\FileInterpreter::class;
Console command
The console command checks all subscriptions for updates and starts the crawling process:
./vendor/bin/typo3 page-subscription:check-updates
See help for more options.
Crawler
The crawler runs through all subscriptions and fetches the content of all occuring xtps:updateInformation viewhelper elements in the frontend.
For crawling the uncached content, a middleware is used to disable the cache for the crawler request.
After that, the saved hashes of the subscription will be compared with the new ones and the subscribers will be notified by mail.
Fingerprint
The page fingerprint is a collection of hashes of all relevant content elements on a page. A hierarchy of elements is supported.
{"tt_content--textmedia--89":
{
"hash":"4f4b94deb5adbc50f63059ba9169bbde",
"children":[]
}
}
The content hierarchy is desired for e.g. dynamic elements within a plugin. Both of them can be updated individually, but the relation between them should be kept. Therefore a structure like the following will be generated as fingerprint:
- Header
- Textmedia
- News plugin
- News entry
- News entry
- News entry
- Teaser
Hash
The hash is generated by the HashGenerator and uses the following parts of a content element:
- Textual data
- Image
src - Link
href
The joined string is afterwards hashed with md5.
This is to ensure that all content element data relevant to the frontend is taken into account for hashing.
If you want to add more fields to the hash, you can do this by using a desired data attribute data-page-subscription-additional-data within the content element or using the HashGenerationModifyEvent:
<?php namespace Xima\XimaTypo3PageSubscription\EventListener; use Xima\XimaTypo3PageSubscription\Event\HashGenerationModifyEvent; final readonly class ModifyHashGenerationEventListener { public function __invoke(HashGenerationModifyEvent $event): void { $contentParts = $event->getContentParts(); // Extract class attributes from all HTML elements preg_match_all('/<[^>]+class="([^"]+)"/i', $content, $classMatches); $contentParts['class'] = implode('', $classMatches[1]); $event->setContentParts($contentParts); } }
Mailer
The mailer is used to send the update information to the subscribers. The mail template is configurable in the extension settings.
Thoughts
Why not use sys_history for this?
Good point, was also my first thought. But the sys_history table is not designed for this use case. It is more for tracking changes in the backend and not for monitoring relevant changes in the frontend. Also a requirement was to observe file list in the frontend and unfortunately sys_history does not support changes inside the fileadmin.
Why not using data handler hooks?
Almost the same reasons as above. ...
What is a relevant update for a frontend user?
Also, a tough question, because it depends on the use case. For example, a news teaser list is a dynamic element and the user should be informed about new entries. But not every change in the news entry is relevant for the user. So the challenge is to find the right balance between too much and too less information.
I was starting with a configuration file to desire which specific fields should be observed. This is more elaborate for the installation process but can be more flexible in the end.
But it all depends on the template showing the content elements in the frontend. So the decision was made to use the viewhelper to wrap the content element and generate a content hash out of textual information (and some additions to that).
ToDo
- Handle updates of page information (title and additional data)
- Add template and js for add/remove subscription in the frontend
- Documentation for subscription overview
- Documentation for Element Identifier
- Test standalone version
Outlook
- Add more interpreters for different content
- Add more configuration options for hash generation
- Show update notification in the frontend for frontend user
License
This project is licensed under GNU General Public License 2.0 (or later).
xima/xima-typo3-page-subscription 适用场景与选型建议
xima/xima-typo3-page-subscription 是一款 基于 PHP 开发的 Composer 扩展包，目前已累计 7 次下载、GitHub Stars 达 0， 最近一次更新时间为 2025 年 02 月 06 日， 在 PHP 生态内属于活跃度较高的组件。
我们在过去多个企业项目中使用过 xima/xima-typo3-page-subscription 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。
基于 xima/xima-typo3-page-subscription 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。
线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。
承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。
统计信息
- 总下载量： 7
- 月度下载量： 0
- 日度下载量： 0
- 收藏数： 0
- 点击次数： 11
- 依赖项目数： 0
- 推荐数： 0
其他信息
- 授权协议： GPL-2.0-or-later
- 更新时间： 2025-02-06