README

这是一个事件日历，可以显示Nova资源或其他与时间相关的数据。它可以在Nova 4项目中以月历视图显示，并且能够很好地适应亮色和暗色模式。

安装

composer require wdelfuego/nova-calendar

许可证摘要

任何人都可以以任何方式使用和修改此包，包括商业用途，只要商业用途是：a) 创建实施日历视图和/或b) 使用实施日历视图。基本上唯一条件是你不能将此包再许可或嵌入到框架中（除非你根据AGPLv3许可证这样做）。在Nova中的使用与AGPLv3许可证不兼容。更多详细信息见下文。

支持 & 文档

有关实施和使用日历的帮助，请首先查看文档。

如果您遇到任何问题或疑虑，请创建一个问题。对于功能请求，请点赞或打开一个功能请求讨论。欢迎有兴趣一起开发此工具的开发者。

它能做什么？

此Nova 4日历工具显示现有的Nova资源，如果您希望，还可以显示动态生成的事件，但本身不包含数据库迁移或Eloquent模型。这被认为是一个功能。预期您的项目已经包含某些带有DateTime字段的Nova资源或某些其他时间相关数据源，这些数据源可以用来生成向最终用户显示的日历事件。

以下功能受到支持：

自动在月历视图中显示Nova资源
在同一个日历上混合多种类型的Nova资源
显示与Nova资源不相关的活动
为活动添加徽章以指示状态或吸引注意
自定义每个单独活动的视觉样式和内容
尊重Laravel策略来自动排除日历中的活动
允许最终用户使用热键在日历中导航
允许最终用户通过点击事件导航到资源的详细信息或编辑视图

它不能做什么（目前还不能）？

以下功能目前尚未支持：

与外部日历服务的集成
直接从日历视图中创建新事件
拖放以更改事件日期

请创建或点赞功能请求讨论，在GitHub仓库中提出您认为最有价值的功能。

版本记录

v1.6

日历工具的URI现在可以配置，感谢@kitchetof！
添加了对自定义事件生成器的支持，以定义从Nova资源到日历事件的自定义映射
对于此包的开发者：添加了第一套单元测试

v1.5

日历时区现在可以自定义

v1.4

现在可以给日历日单元格添加徽章

v1.3

用户无权限查看的Nova资源的日历事件现在会自动从日历中隐藏
现在可以逐个排除Nova资源的日历事件

v1.2

增加了对自定义非Nova事件的支持
增加了对应用多个自定义样式的支持

v1.1

增加了对多日事件的支持
改进了视觉设计
更好地支持移动使用
修复了徽章可能会与事件标题重叠的bug
现在使用css grid而不是表格
新的双重许可模式（请参阅文件末尾）

v1.0

首次发布，仅支持单日事件

许可证

此版权和许可证通知必须包含在包的任何副本、备份、分叉或任何其他修改版本中。

您可以使用此包在以下两种许可证之一下使用：

GNU AGPLv3，适用于与GPLv3或更新版本兼容的开源项目。请注意，此许可证与Nova的使用不兼容，因此在此版本存在之前，该包不能在此许可证下使用。您可以在本存储库中的LICENSE-agpl-3.0.txt中找到此许可证的完整条款，也可以在https://gnu.ac.cn/licenses/上找到副本。
一个永久、不可撤销的100%免费（如啤酒免费）的许可证，允许以下6种条件下的非商业和商业使用：

您可以使用此包在尽可能多的应用程序上实现和/或使用尽可能多的服务器上的尽可能多的日历，并且可以为此收取费用，只要您和/或您的组织是以下之一：a) 负责实现日历的开发者，或b) 实现的日历的最终用户，或c) 两者都是。
不允许在此许可证下将此包（或其修改版本）的分销、再许可、转售或对其他开发者收费，以便他们实现日历视图。
您可以自由地进行任何修改，不需要公开您的修改或宣布它们。
只要您免费分发，作为独立的包，并在相同的双重许可模式下分发，您就可以自由地创建和分发此包的修改版本。
不允许在此许可证下将此包（或其修改版本）嵌入到向您的组织外的开发者提供的免费或付费软件库或框架中。如果软件库或框架与GPLv3或更新版本兼容，您可以在GNU AGPLv3许可证下这样做。
以下2项免责声明适用：
- 软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、特定用途的适用性和非侵权性保证。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任负责，无论是基于合同、侵权或其他方式，无论是在软件或其使用中产生的，还是与之有关。
- 您承担与软件的安装和使用相关的所有风险。许可证持有人负责确定使用的适当性，并承担其使用的所有风险，包括但不限于程序错误、设备损坏、数据丢失或软件程序丢失，或操作不可用或中断的风险。

monty / calendar

维护者

详细信息