No description
Find a file
Richard Steinmetz 6dc3a16f2c
Merge pull request #208 from nextcloud/carl/port-away-execute
refactor: Port away from IQueryBuilder::execute
2025-09-26 15:57:40 +02:00
.github Merge pull request #203 from nextcloud/renovate/main-skjnldsv-xpath-action-digest 2025-09-24 14:22:54 +02:00
appinfo feat: add support for Nextcloud 33 2025-09-24 13:52:00 +02:00
composer perf(autoloader): Use Composer's authoritative classmap 2023-01-20 12:07:32 +01:00
lib refactor: Port away from IQueryBuilder::execute 2025-09-26 13:30:12 +02:00
LICENSES ci(reuse): Add reuse check 2024-10-30 19:03:04 +01:00
tests refactor: Port away from IQueryBuilder::execute 2025-09-26 13:30:12 +02:00
vendor-bin/phpunit test: Add phpunit test 2024-08-21 01:11:24 +02:00
.git-blame-ignore-revs chore: ignore coding-standard update 1.3.1 in git blame 2024-10-08 10:54:17 +02:00
.gitignore docs(reuse): Add SPDX header 2024-10-30 19:02:19 +01:00
.nextcloudignore docs(reuse): Add SPDX header 2024-10-30 19:02:19 +01:00
.php-cs-fixer.dist.php docs(reuse): Add SPDX header 2024-10-30 19:02:19 +01:00
AUTHORS.md docs(reuse): Add SPDX header 2024-10-30 19:02:19 +01:00
CHANGELOG.md chore(release): v0.10.0 2025-09-01 10:07:18 +02:00
composer.json chore(deps): bump nextcloud/coding-standard from 1.3.2 to ^1.4.0 2025-06-23 08:13:26 +00:00
composer.lock chore(deps): bump nextcloud/coding-standard from 1.3.2 to ^1.4.0 2025-06-23 08:13:26 +00:00
COPYING Initial Commit 2021-05-26 17:04:17 +02:00
krankerl.toml docs(reuse): Add SPDX header 2024-10-30 19:02:19 +01:00
README.md docs(readme): Add reuse badge 2024-10-30 19:04:30 +01:00
renovate.json chore(config): migrate config renovate.json 2025-09-24 10:58:05 +00:00
REUSE.toml docs(reuse): Add SPDX header 2024-10-30 19:02:19 +01:00

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

Command Description Arguments (required) Options Associated Table Notes
calendar-resource:building:create Create a building resource display_name --address --description --wheelchair-accessible calresources_building
calendar-resource:story:create Create a story resource building_id display_name calresources_stories Needs an associated building id
calendar-resource:room:create Create a room resource story_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-accessible calresources_rooms Needs an associated story id
calendar-resource:restriction:create Create a restriction on a resource entity_type entity_id group_id calresources_restricts This restricts a resource to a group
calendar-resource:resource:create Create a general resource uid building_id display_name email resource_type --contact-person-user-id calresources_resources Needs an associated building id
calendar-resource:vehicle:create Create a vehicle resource uid building_id display_name email vehicle_type vehicle_make vehicle_model --contact-person-user-id --is-electric --range --seating-capacity calresources_vehicles Needs an associated building id
calendar-resource:resources:list List all resources
calendar-resource:resource:delete Delete a resource and anything that belongs to them resource_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.