Home

Awesome

<!-- - SPDX-FileCopyrightText: 2021 Nextcloud GmbH and Nextcloud contributors - SPDX-License-Identifier: AGPL-3.0-or-later -->

Calendar Resource Management

REUSE status

This app enables the 🗓️ Calendar App to work with resources and rooms

Installation

Obtain the latest pre-release build

Builds are available at https://github.com/nextcloud-releases/calendar_resource_management/releases.

Download and extract calendar_resource_management.tar.gz into nextcloud/apps/.

Activate it within the apps menu

Configuration

All boolean fields default to false if not specified

CommandDescriptionArguments (required)OptionsAssociated TableNotes
calendar-resource:building:createCreate a building resourcedisplay_name--address --description --wheelchair-accessiblecalresources_building
calendar-resource:story:createCreate a story resourcebuilding_id display_namecalresources_storiesNeeds an associated building id
calendar-resource:room:createCreate a room resourcestory_id uid display_name email room_type--contact-person-user-id --capacity --room-number --has-phone --has-video-conferencing --has-tv --has-projector --has-whiteboard --wheelchair-accessiblecalresources_roomsNeeds an associated story id
calendar-resource:restriction:createCreate a restriction on a resourceentity_type entity_id group_idcalresources_restrictsThis restricts a resource to a group
calendar-resource:resource:createCreate a general resourceuid building_id display_name email resource_type--contact-person-user-idcalresources_resourcesNeeds an associated building id
calendar-resource:vehicle:createCreate a vehicle resourceuid building_id display_name email vehicle_type vehicle_make vehicle_model--contact-person-user-id --is-electric --range --seating-capacitycalresources_vehiclesNeeds an associated building id
calendar-resource:resources:listList all resources
calendar-resource:resource:deleteDelete a resource and anything that belongs to themresource_type id

Example for creating a room

php occ calendar-resource:building:create --address="Testweg 23, 12345 Berlin, Germany" "SpaceZ office Berlin"
php occ calendar-resource:story:create 1 "2nd floor"
php occ calendar-resource:room:create --wheelchair-accessible=1 --capacity=25 --room-number=201 1 "demouser" "berlin_main_office" "room.berlin.main@spacexyz.com" "Shared office"

CAVEAT: Each room needs a unique email address. A common workaround is to use fake email addresses like "room0001@none". Ref https://github.com/nextcloud/calendar_resource_management/issues/119#issuecomment-2114275319

The resources will be added to the calendar app via cron.

Any create command will return the ID of the created resource as the last line.