README

📗 目录

• 📖 关于项目
  • 🛠 使用技术
    • 技术栈
    • 主要功能
  • 🚀 在线演示
• 💻 开始使用
  • 设置
  • 先决条件
  • 安装
  • 用法
  • 运行测试
  • 部署
• 👥 作者
• 🔭 未来功能
• 🤝 贡献
• 🙏 致谢
• ❓ 常见问题解答
• 📝 许可证

📖 Lespf_Calendar

Lespf Calendar 是 Typo3 CMS 的插件扩展。它显示了一个带有节假日和（如果需要）事件的微型月历。

🛠 使用技术

技术栈

主要语言是 PHP。还有一些使用了 Fluid 模板和 CSS。数据以 YAML 文件（本地）和 SQL 查询（全局）的形式处理。

主要功能

• 包含许多欧洲国家的节假日
• 可以从通用的活动扩展导入事件
• CSS 样式化

(回到顶部)

💻 开始使用

要获取本地副本并运行，请按照以下步骤操作。

先决条件

为了运行此项目，您需要

• 一个具有 PHP 8.0 或更高版本以及 Datetime 扩展的 Web 服务器，
• Typo3 V11 或 V12，以及
• 如果您想从扩展导入事件，以下插件之一：
  • 新闻，
  • 事件新闻，或
  • SfEventMgt

设置

只要日历既不在 packagist 也不在 Typo3 扩展仓库 (TER) 上，您就必须手动下载。

因此，您可以将此存储库克隆到您希望的目标文件夹：sh cd your-folder git clone willadt@gitlab.com:lespf/lespf_calendar.git 或将其作为 ZIP 文件下载。

安装

使用以下命令安装此项目：

• composer，或
• 使用 Typo3 扩展管理器上传。

对于 composer，您需要配置您的 Typo3 安装以使用本地包，并将文件放置在那里，如果您想获取最新版本。如果您对最新官方版本满意，只需发出

composer require lespf/lespf-calendar

对于将最新版本通过扩展管理器上传到您的 Typo3 安装的流程，您应该在上传之前将下载的 ZIP 文件重命名为 lespf_calendar.zip（删除发布日期/编号内容）。官方编号版本应该找到其途径到 TER，因此您可以从那里下载它们。

安装后

安装后运行维护数据库比较。在重新安装时，您必须重新加载数据库表。如果您在扩展管理器内上传数据库不足，可能需要使用如 phpmyadmin 之类的工具导入 ext_tables_static+adt.sql。

用法

在项目的文档子文件夹中，以 Restructured Text 格式编写了有关配置和使用插件的（希望是完整的）文档。这里不再重复。

此文档也可通过 Typo3 扩展仓库 (TER) 在线访问。

编写 YAML 文件时，请参考 Resources/Private/Regions 子文件夹中的示例。

(回到顶部)

👥 作者

👤 Peter Willadt

• GitLab: @gitlabhandle

(回到顶部)

🔭 未来功能

• [ ] 添加更多国家

(回到顶部)

🤝 贡献

欢迎贡献、问题和功能请求！

由于假日最好是在你生活的文化中发生时才能理解，我很感激得到帮助。在包文档中，你可以找到一些我在探索表面时遇到的困难示例。

请随时查看问题页面。

(回到顶部)

🙏 致谢

我想感谢...

• Typo3社区的开发者文档
• 我检查的几个插件的作者，特别是 '静态信息表' 和 'tt_address' 的技巧

(回到顶部)

❓ 常见问题

• 如何找出支持哪些国家？

  • 由于国家列表有时会增长，最安全的方法是检查文件 ext-tables+adt.sql

• 我可以向数据库表添加私有条目吗？

  • 请不要这样做。它们将在下一次更新中消失。你可以通过YAML文件添加你的假日（和事件）。

(回到顶部)

📝 许可证

作为一个Typo3扩展，本项目根据GNU通用公共许可证，版本2或更高版本进行许可。请参阅Typo3项目的许可信息以获取详细信息。

(回到顶部)