ubl / ubl_booking
Requires
- typo3-ter/iconfont: ^0.9.0
- typo3/cms: ^7.6.0
Requires (Dev)
- mikey179/vfsstream: ^1.4
- namelesscoder/typo3-repository-client: ^1.2
- nimut/testing-framework: ^1.0
- phpunit/phpunit: ^4.7 || ^5.0
Replaces
- typo3-ter/ubl-booking: 2.0.0
- ubl_booking: 2.0.0
This package is not auto-updated.
Last update: 2022-02-01 13:06:08 UTC
README
管理typo3前端用户的房间预订
此扩展是为了满足管理莱比锡大学图书馆对师生开放的群组学习室预订需求而创建的。
匿名网站访客可以在typo3后端中查看特定时间段内房间的情况和占用情况。
登录用户可以预订房间时间段,根据每天和地点定义的最大预订数。
要求
- Typo3 > 6.2 < 7.6.99
- PHP >= 5.4
- Icon font >= 0.9.0
我们尚未测试更高版本,但代码库应该是足够的。
用法
此扩展提供了一个插件,需要将其分配给指定的页面。
创建位置
添加新内容元素 -> 插件 -> 通用插件。在插件选项卡下选择房间预订。
配置
切换回插件选项卡后,您有多个选项可以指定
- 每天和用户的最大预订数定义用户每天可以预订的数量,无论您在此页面上提供多少房间。默认为5个预订,如果没有指定。
- 预订提前可用的周数定义用户可以提前预订的周数。当前周加上您在此处定义的周数。默认为2周,如果没有指定。
- 向后查看可用的周数定义一个人可以回溯查看占用情况的周数。默认为1周,如果没有指定。
- 管理账户定义被视为管理员的front-end用户账户。它们不受所有先前设置的限制。
在行为选项卡中,必须指定记录存储页面,其中将存储房间、预订、营业时间和关闭日。
如果未如高级自定义部分中所述覆盖,则在此处创建的所有营业时间和关闭日都将适用于此处创建的所有房间。
创建房间
要创建房间,请转到在配置部分之前指定的记录存储页面,创建新记录并选择房间。
您必须提供至少一个房间名称。
启用样式表
要启用扩展附带默认CSS样式表,必须将它们包含在根模板中。转到Web -> 模板,在下拉框中选择Info/Modify,然后单击编辑整个模板记录。选择Includes选项卡,将Booking CSS Styles (booking)从可用项添加到选定项,然后单击保存。现在,您已将扩展的样式表添加到页面,并启用了图标字体样式。
定义关闭日
关闭日对于银行假日等很有用。
要创建一个关闭日,请转到之前在“配置”部分中指定的作为“记录存储页”的页面,创建一个新的记录并选择“关闭日”
您必须提供至少一个关闭日名称和一个日期。这些日子在周概览中显示为不可预订,并且在这些日子上无法从前端创建预订。然而,从后端创建的预订没有经过验证,但在前端也不会显示。
定义营业时间
默认情况下,一周中所有天的所有时间都是可预订的。通过营业时间,可以定义一天的开业时间。
要为一天创建营业时间,请转到之前在“配置”部分中指定的作为“记录存储页”的页面,创建一个新的记录并选择“营业时间”
选择您想指定营业时间的星期几,然后选择值班时间。
如果您一个时间都不选择,那么这一天将完全关闭预订。例如,这样就可以创建每周关闭日,即星期日。
高级定制
默认情况下,关闭日和营业时间适用于所有房间。但是,如果您想为不同的房间定义不同的规则,您可以创建一个新的“记录存储页”并为指定的房间指定它。
只需打开已经创建的房间记录,并在“营业时间存储页面”下注册新创建的“记录存储页”。
如果您想利用继承原则,甚至可以注册多个页面。规则是,先来的先得。例如,如果您在两个页面上定义了星期一的营业时间,则优先列出页面的营业时间。
关闭日也会被继承。但是,在这里覆盖没有意义。
为了更好地了解为房间制作的预订,您还可以指定一个房间预订的存储页面。
要这样做,请在“预订存储页面”下注册指定的存储页面,然后您就可以开始了。未来的预订将存储在该页面上,但也会考虑来自插件存储页面的预订,因此您不必担心旧的预订。
清理旧预订
有一个清理命令可以与typo3的命令行界面或调度程序一起使用,用于清理旧的预订。请注意,此处不考虑插件配置的回溯周数。您指定从现在起要保留的周数。
转到调度程序->添加任务
- 从类中选择Extbase CommandController 任务
- 根据您的需求指定频率(每周一次就足够了)
- 从CommandController 命令列表中选择Booking Cleanup: cleanupBookings
- 保存任务**重要!否则,表单元素的参数不会出现
- 在weeks参数字段中指定要保留的周数。0(零)或空表示删除当前周之前的所有预订
升级到1.1.0
在版本1.1.0中,命名方式从ubl_booking
更改为booking
,类命名空间从LeipzigUniversityLibrary\UblBooking
更改为Ubl\Booking
,composer名称从ubl/ubl_booking
更改为ubl/booking
为了保留您的数据,请按照以下步骤将这些数据转换为新的名称
- 将网页设置为维护模式
- 安装新版本的同时安装旧版本,这样您就有
booking
和ubl_booking
安装并激活。 - 禁用
ubl_booking
- 在操作下,为
bookings
运行执行更新脚本 - 在每个页面上替换插件
- 根据上面的启用样式表启用样式表
- 删除扩展
ubl_booking
- 禁用维护模式