Trang đặt lịch (webmail)

Trang đặt lịch cho phép người dùng hộp thư công bố một trang "đặt cuộc họp với tôi". Khách truy cập mở liên kết công khai, chọn loại cuộc hẹn và một khung giờ trống, để lại tên và email, và cuộc họp được đưa vào lịch của người dùng — kèm email xác nhận và lời mời lịch gửi cho cả hai bên cùng các liên kết để đổi lịch hoặc huỷ. Giờ trống được tính từ lịch rảnh hằng tuần của người dùng trừ đi những gì đã có trong lịch, nên một cuộc họp thêm từ điện thoại sẽ chặn trang đó ngay lập tức.

Mọi thứ chạy trên máy chủ của chính bạn: không có dịch vụ lên lịch của bên thứ ba nào tham gia.

Thiết lập một trang

Mở trang Lịch trong webmail và nhấn Trang đặt lịch trên thanh công cụ (hoặc Quản lý trang đặt lịch dưới chương trình trong ngày). Nhấn Trang đặt lịch mới và điền:

Tiêu đề và Mô tả — những gì khách thấy ở đầu trang.
Địa chỉ — phần cuối của URL công khai: https://<webmail>/book/<address>. Chữ cái, chữ số và dấu gạch ngang; phải là duy nhất trên máy chủ.
Múi giờ — múi giờ dùng để viết lịch rảnh của bạn. Khách thấy giờ theo múi giờ của chính họ.
Khoảng cách khung giờ — các giờ bắt đầu có thể đặt cách nhau bao lâu (mặc định 30 phút).
Báo trước tối thiểu — khách phải đặt trước bao lâu (mặc định 2 giờ).
Có thể đặt tới — trang mở đặt trước bao nhiêu ngày trong tương lai (mặc định 60).
Lịch cho các lượt đặt — các cuộc họp được đưa vào lịch nào của bạn (lịch mặc định của bạn nếu không chọn lịch khác).
Lịch rảnh hằng tuần — một hoặc nhiều khung giờ cho mỗi ngày trong tuần. Ngày không có khung giờ nào thì không đặt được.

Sau đó thêm ít nhất một loại cuộc hẹn: tên, thời lượng, khoảng đệm tuỳ chọn trước và sau (được để trống quanh cuộc họp), một giá / nhãn tuỳ chọn hiển thị cạnh tên, một địa điểm (phòng, địa chỉ hoặc liên kết cuộc gọi) và mô tả. Một loại có thể bị tắt mà không cần xoá. Bỏ chọn Trang được công bố để đưa một trang ngoại tuyến mà vẫn giữ nó.

Dùng Sao chép liên kết để chia sẻ địa chỉ của trang.

Khách thấy gì

Trang tại /book/<address> không cần đăng nhập. Khách chọn một loại cuộc hẹn, chuyển qua dải tuần tới một ngày có giờ trống, chọn một giờ (hiển thị theo múi giờ của chính khách, kèm ghi chú múi giờ của trang) và nhập tên, email cùng ghi chú tuỳ chọn. Khung giờ được kiểm tra lại ngay lúc đó; nếu trong lúc ấy người khác đã đặt mất thì khách được yêu cầu chọn giờ khác.

Khi thành công, cả hai bên nhận một email gửi từ hộp thư của chủ trang:

khách nhận một email xác nhận cùng cuộc họp dưới dạng lời mời lịch (.ics, METHOD:REQUEST) và một liên kết Đổi lịch hoặc huỷ;
chủ trang nhận một email "New booking" kèm thông tin và ghi chú của khách.

Cuộc họp được tạo trong lịch của chủ trang với khách là người tham dự, nên nó cũng đồng bộ với điện thoại qua CalDAV.

Đổi lịch và huỷ

Liên kết của khách (/book/manage/<token>) hiển thị lượt đặt và cung cấp Chọn giờ mới (cùng bộ chọn khung giờ trống, với khung giờ của chính lượt đặt được giải phóng) và Huỷ lượt đặt này. Cả hai hành động đều cập nhật sự kiện lịch và gửi email cho hai bên — việc huỷ kèm một lời mời METHOD:CANCEL để các ứng dụng thư gỡ sự kiện đi.

Chủ trang thấy các lượt đặt sắp tới dưới chương trình trong ngày trên trang Lịch và trên màn hình Trang đặt lịch, và có thể huỷ bất kỳ lượt nào; khách sẽ nhận email.

Giới hạn và bảo vệ

Các endpoint công khai bị giới hạn tần suất theo từng địa chỉ IP (đọc và đặt lịch riêng), một lượt đặt chỉ được chấp nhận cho khung giờ mà trang đang cung cấp, và mỗi trang bị giới hạn trong cửa sổ 120 ngày cho mỗi yêu cầu. Trang đặt lịch là một plugin webmail, bật theo mặc định; người dùng có thể tắt nó tại Cài đặt → Plugin.

Lời mời lịch trong thư

Liên quan: khi một email chứa lời mời lịch (một phần text/calendar hoặc tệp đính kèm .ics), màn hình xem thư hiển thị một thẻ lời mời với chi tiết sự kiện, một dải dòng thời gian của ngày của bạn — các sự kiện sẵn có của bạn với xung đột được đánh dấu đỏ — và các nút Chấp nhận / Có thể / Từ chối. Trả lời sẽ gửi một phản hồi iTIP tới người tổ chức từ tài khoản nhận thư và thêm sự kiện vào lịch của bạn (từ chối sẽ gỡ nó). Bạn có thể chọn thêm vào lịch nào khi có nhiều hơn một lịch.