Quick Start Guide

1. Add a new calendar (in "Calendar" App)

2. Add contact info

3. Select Calendar, Apply and Click "Edit Template"

4. Add appointment slots

5. Save the template

6. Enable sharing

7. Get appointments page URL

Timezones

Your calendar's timezone is used as the base and appointment time will be converted to visitors' local time at their end.

Example: 12:00PM America/New_York timezone appointment based in New York

Customize Public Page

GDPR Compliance

Any text in the "GDPR Compliance" field will trigger the "GDPR" checkbox to display. The checkbox can be hidden by checking the "GDPR text only (no checkbox)" option.

A checkbox with plain text (no html) or any html/links without a checkbox will work as is. However, if you need to include the checkbox and certain html or a link to your privacy policy, please read on: For the link to work properly, you should separate it from the <label> element, and the <label>'s "for" attribute MUST be set to "appt_gdpr_id". Example:

Appointment Title

If an event title/summary starts with the "_" character then the title will be displayed next to or below the time in the form. For example: _Language Lessons will be displayed as "Language Lessons"

Title Template

Style Override

Insert custom <style></style> element to override default page style. Try something like this, for example:

<style>
#header{
    background: transparent !important;
}
#content{
    background: linear-gradient(to bottom, #ff00cc, #333399) !important;
}
#body-public #content {
    min-height: 100%;
}
form{
    background:whitesmoke;box-shadow: 3px 3px 25px 0px rgba(0,0,0,0.75);
}
.srgdev-ncfp-form-header{
    border-bottom: 3px solid #961AB1;
}
</style>

Email Settings

Email the Attendee when the appointment is modified and/or deleted - Attendees will be notified via email when their upcoming appointments are updated or deleted in the calendar app or via some other external mechanism. Only changes to Date/Time, Status or Location will trigger the "Modified" notification.

Email Me when an appointment is updated - A notification email will be sent to you when an appointment is booked via the public page or an upcoming appointment is confirmed or canceled via the email links.

Skip email validation step - When this option is selected, the "... action needed" validation email will NOT be sent to the attendee. Instead, the "... Appointment is confirmed" message will be sent immediately, and the "All done" page will be displayed upon submission of the form.

useDefaultEmail - Most Nextcloud instances won't have the configuration required to allow sending of emails on behalf of organizers. Therefore, the default email address set in the Mail Settings is used, and the organizer's address is included in the "Reply-To:" header field. If your Nextcloud configuration supports sending emails on behalf of individual users, Admins can override the 'useDefaultEmail' directive with this command: occ config:app:set appointments useDefaultEmail --value no

Additional Email Text - this text is appended as a paragraph at the end of validation and confirmation emails. Currently only pain text is allowed and included HTML will be escaped.

Additional ICS file description - this text (no HTML please) will be appended to the end of the event's "DESCRIPTION" property.

Time slot mode

Weekly Template - this mode allows you to set up a weekly template and it will be automatically repeated.

Simple mode - Use the provided "Add Appointment Slots" dialog to add "available" time slots. Recurrence is not supported in this mode.

External mode - Use Nextcloud's Calendar App or any other CalDAV-compatible client to add "available" timeslots. Most recurrence rules are supported in this mode. Two calendars are required: a "Source Calendar" to keep track of your availabile timeslots, and a "Destination Calendar" for booked appointments.

Talk App Integration

Talk rooms/conversations can be automatically created when an appointment is confirmed. FLOATING timezones are not supported.

Guest password - when this option is selected, Talk rooms will be password protected. An automatically generated pseudo-random password will be sent to attendees along with a room/meeting link.

Customize email text - you can override default the email message. There are two tokens available, {{url}}, and if you use password protection, {{pass}}. These will be replaced with the room URL and the password, if used.

For example:

will look similar to this:

"Meeting Type" form field - when this option is enabled, a <select> drop-down similar to the one below will be added to the form. If a visitor selects an 'In-person' meeting, a Talk room will NOT be created for this appointment.

Type change email text - if this field is not empty and has two tokens {{link_text}} (can contain any text) and {{new_type}} (MUST be new_type), then this text will be attached to the email and attendees will be able to change their meeting type simply by clicking on the link {{link_text}}.

For example, this:

will look similar to this:

Talk rooms will be created and deleted automatically when a meeting type changes.

Redirect to a Custom "All Done" Page After Confirmation

Redirect Confirmed URL - when a URL is specified here, visitors will be redirected to the URL after they confirm their email address. A base64 encoded d=... query parameter containing a JSON object will be added to the URL. The final URL for https://your-cool-domain.com/finish.html might look something like this: https://your-cool-domain.com/finish.html?d=eyJpbml0aWFsQ29uZmlybSI6dHJ1ZSwiaWQiOiI4YjhkOD...

When the d=... param data is base64 decoded, the JSON object might be similar to this:

{
    "initialConfirm": true,
    "id": "8b8d87915a32bc4f48eb14439cd52cef",
    "name": "Bruce Banner",
    "dateTimeString": "Wednesday, April 13, 2022, 10:30 AM EDT"
}

iFrame/Embedding

...
    <?php
    $src='PROVIDED_EMBEDDABLE_URL';
    if(isset($_GET['some_param_name'])){
    // Email Confirm/Cancel button was clicked
    $src=substr($src,0,-4).'cncf?d='.urlencode($_GET['some_param_name']);
    }
    echo '<iframe src = "'.$src.'"></iframe>';
    ?>
...

Booked and Pending Appointment Buffers

It is possible to block off a period of time before and after a booked(and pending) appointment. This could be useful when some preparation or travel time is required before, or clean-up/cooling-off/review time needs to be blocked off after.

Buffer blocking logic:

Default Reminders language

Advanced/Notification Extensions