Skip to content

Commit 46096a9

Browse files
Merge branch 'master' into dependabot/npm_and_yarn/karma-6.4.4
2 parents bc67f6f + e7f151d commit 46096a9

8 files changed

Lines changed: 215 additions & 28 deletions

File tree

‎.github/CODEOWNERS‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
# Managed by owncloud/admin — edit codeowners/ownership.yml, not this file.
2+
# Generated by scripts/sync-codeowners.py. Last matching pattern wins.
3+
* @owncloud/classic-maintainers

‎CODE_OF_CONDUCT.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
# Code of Conduct
2+
3+
This project follows the ownCloud Code of Conduct.
4+
5+
Please read the full Code of Conduct at:
6+
**<https://owncloud.com/contribute/code-of-conduct/>**
7+
8+
By participating in this project, you agree to abide by its terms.

‎CONTRIBUTING.md‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# Contributing
2+
3+
Thank you for your interest in contributing to this project!
4+
5+
Please read the full contributing guidelines at:
6+
**<https://owncloud.com/contribute/>**
7+
8+
For development setup, coding standards, and pull request process,
9+
see the README in this repository.

‎README.md‎

Lines changed: 85 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -1,41 +1,101 @@
11
# ownCloud Calendar
22

3-
[![Build Status](https://drone.owncloud.com/api/badges/owncloud/calendar/status.svg)](https://drone.owncloud.com/owncloud/calendar)
4-
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=owncloud_calendar&metric=alert_status)](https://sonarcloud.io/dashboard?id=owncloud_calendar)
5-
[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=owncloud_calendar&metric=security_rating)](https://sonarcloud.io/dashboard?id=owncloud_calendar)
6-
[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=owncloud_calendar&metric=coverage)](https://sonarcloud.io/dashboard?id=owncloud_calendar)
3+
<!-- OSPO-managed README | Generated: 2026-04-16 | v2 -->
74

8-
**A calendar app for [ownCloud](https://owncloud.org)**
5+
[![License](https://img.shields.io/badge/License-AGPL--3.0-blue.svg)](COPYING) [![ownCloud OSPO](https://img.shields.io/badge/OSPO-ownCloud-blue)](https://kiteworks.com/opensource) [![Docker Hub](https://img.shields.io/docker/pulls/owncloud)](https://hub.docker.com/r/owncloud/server)
96

10-
This is the new calendar app that has replaced the [old calendar app](https://github.com/owncloudarchive/calendar), and is only the frontend for the new server-integrated CalDAV-Backend.
7+
The ownCloud Calendar app provides a web-based calendar interface for ownCloud Server. It is the frontend for the server-integrated CalDAV backend, replacing the original calendar app. Users can create and manage multiple calendars, schedule events, and share calendars with other users. The app supports Chrome/Chromium 49+, Edge 14+, Firefox 45+, Internet Explorer 11, and Safari 10+.
118

12-
![](https://github.com/owncloud/screenshots/blob/master/calendar/screenshot.png)
9+
## Part of Classic (OC10)
1310

14-
## Maintainer:
11+
Calendar is an app for [ownCloud Server (Classic)](https://github.com/owncloud/core). It uses the CalDAV backend built into ownCloud Server core. The app is available on [Docker Hub as part of the ownCloud Server image](https://hub.docker.com/r/owncloud/server).
1512

16-
- [Julian Müller](https://github.com/Julian1998)
13+
## Getting Started
1714

18-
## Contributors:
15+
1. Clone this repository into the `apps/` directory of your ownCloud Server installation
16+
2. Run `make` to build the app
17+
3. Enable the app: `occ app:enable calendar`
1918

20-
- [Georg Ehrke](https://github.com/georgehrke)
21-
- [Raghu Nayyar](https://github.com/raghunayyar)
22-
- [Bernhard Fröhler](https://github.com/codeling)
23-
- [and many more](https://github.com/owncloud/calendar/graphs/contributors)
19+
## Documentation
2420

25-
If you’d like to join, just go through the [issue list](https://github.com/owncloud/calendar/issues) and fix some. :)
26-
We’re also in [#owncloud-calendar on freenode IRC](https://webchat.freenode.net/?channels=owncloud-calendar).
21+
- [Calendar FAQ](https://github.com/owncloud/calendar/wiki/FAQs)
22+
- [ownCloud Server documentation](https://doc.owncloud.com)
23+
- For CalDAV backend issues, see [ownCloud Core](https://github.com/owncloud/core)
2724

28-
## Support:
25+
## Community & Support
2926

30-
Check out our [FAQ](https://github.com/owncloud/calendar/wiki/FAQs). If you don't find a solution, you are welcome to [ask for support](https://owncloud.org/support/) in our Forums or the IRC-Channel. If you have found a bug, feel free to open a new Issue on GitHub. Keep in mind, that this repository only manages the frontend. If you find bugs or have problems with the CalDAV-Backend, you should ask the guys at [ownCloud Core](https://github.com/owncloud/core) for help!
27+
**[Star](https://github.com/owncloud/calendar)** this repo and **Watch** for release notifications!
3128

32-
## Supported Browsers
29+
- [ownCloud Website](https://owncloud.com)
30+
- [Community Discussions](https://github.com/orgs/owncloud/discussions)
31+
- [Matrix Chat](https://app.element.io/#/room/#owncloud:matrix.org)
32+
- [Documentation](https://doc.owncloud.com)
33+
- [Enterprise Support](https://owncloud.com/contact-us/)
34+
- [OSPO Home](https://kiteworks.com/opensource)
3335

34-
* Chrome/Chromium 49+
35-
* Edge 14+
36-
* Firefox 45+
37-
* Internet Explorer 11
38-
* Safari 10+
36+
## Contributing
3937

40-
We don't support Internet Explorer 10 and below. Patches for IE9+ are accepted though.
38+
We welcome contributions! Please read the [Contributing Guidelines](CONTRIBUTING.md)
39+
and our [Code of Conduct](CODE_OF_CONDUCT.md) before getting started.
4140

41+
### Workflow
42+
43+
- **Rebase Early, Rebase Often!** We use a rebase workflow. Always rebase on the target branch before submitting a PR.
44+
- **Dependabot**: Automated dependency updates are managed via Dependabot. Review and merge dependency PRs promptly.
45+
- **Signed Commits**: All commits **must** be PGP/GPG signed. See [GitHub's signing guide](https://docs.github.com/en/authentication/managing-commit-signature-verification).
46+
- **DCO Sign-off**: Every commit must carry a `Signed-off-by` line:
47+
```
48+
git commit -s -S -m "your commit message"
49+
```
50+
- **GitHub Actions Policy**: Workflows may only use actions that are (a) owned by `owncloud`, (b) created by GitHub (`actions/*`), or (c) verified in the GitHub Marketplace.
51+
52+
## Translations
53+
54+
Help translate this project on Transifex:
55+
**<https://explore.transifex.com/owncloud-org/owncloud/>**
56+
57+
Please submit translations via Transifex -- do not open pull requests for translation changes.
58+
59+
## Security
60+
61+
**Do not open a public GitHub issue for security vulnerabilities.**
62+
63+
Report vulnerabilities at **<https://security.owncloud.com>** -- see [SECURITY.md](SECURITY.md).
64+
65+
Bug bounty: [YesWeHack ownCloud Program](https://yeswehack.com/programs/owncloud-bug-bounty-program)
66+
67+
## License
68+
69+
This project is licensed under the [AGPL-3.0](COPYING).
70+
71+
## About the ownCloud OSPO
72+
73+
The [Kiteworks Open Source Program Office](https://kiteworks.com/opensource), operating under
74+
the [ownCloud](https://owncloud.com) brand, launched on May 5, 2026, to steward the open source
75+
ecosystem around ownCloud's products. The OSPO ensures transparent governance, license compliance,
76+
community health, and sustainable collaboration between the open source community and
77+
[Kiteworks](https://www.kiteworks.com), which acquired ownCloud in 2023.
78+
79+
- **OSPO Home**: <https://kiteworks.com/opensource>
80+
- **GitHub**: <https://github.com/owncloud>
81+
- **ownCloud**: <https://owncloud.com>
82+
83+
For questions about the OSPO or licensing, contact ospo@kiteworks.com.
84+
85+
### License Migration to Apache 2.0
86+
87+
The OSPO is driving a strategic relicensing of ownCloud repositories toward the
88+
[Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0), following
89+
the [Apache Software Foundation's third-party license policy](https://www.apache.org/legal/resolved.html).
90+
91+
Individual repositories will migrate as their audit is completed. The LICENSE file
92+
in each repo reflects its **current** license status (not the target).
93+
94+
**Current license: AGPL-3.0** (Category X per Apache policy -- cannot be included in Apache-2.0 works).
95+
96+
Migration prerequisites for this repository:
97+
98+
- **CLA/DCO coverage**: All past contributors must have signed agreements permitting relicensing
99+
- **Copyleft dependency audit**: All AGPL/GPL dependencies must be replaced or isolated
100+
- **KDE heritage review**: Any code with KDE-era copyrights requires legal analysis
101+
- **Complete relicensing**: AGPL-3.0 is a strong copyleft license; migration requires full relicensing of all files, not just a header change

‎SECURITY.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
# Security Policy
2+
3+
## Reporting a Vulnerability
4+
5+
**Do NOT open a public GitHub issue for security vulnerabilities.**
6+
7+
Please report security issues responsibly via:
8+
**<https://security.owncloud.com>**
9+
10+
You can also report vulnerabilities through our YesWeHack bug bounty program:
11+
**<https://yeswehack.com/programs/owncloud-bug-bounty-program>**

‎SUPPORT.md‎

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,10 @@
1+
# Support
2+
3+
For support with this project, please use the following channels:
4+
5+
- **Enterprise Support**: <https://owncloud.com/contact-us/>
6+
- **Community discussions**: https://github.com/orgs/owncloud/discussions
7+
- **Matrix Chat**: <https://app.element.io/#/room/#owncloud:matrix.org>
8+
- **Documentation**: <https://doc.owncloud.com>
9+
10+
Please do not use GitHub issues for general support questions.

‎agents.md‎

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
# AI Agent Guidelines for Calendar
2+
3+
This file provides context for AI coding agents (Claude Code, GitHub Copilot, Cursor, etc.) working in this repository.
4+
5+
## Repository Overview
6+
- **Product family:** Classic (OC10)
7+
- **Primary language(s):** JavaScript, PHP
8+
- **Build system:** Composer, Make, npm/Yarn, Gulp
9+
- **Test framework:** PHPUnit, Karma (JavaScript)
10+
- **CI system:** GitHub Actions
11+
12+
## Architecture & Key Paths
13+
- `controller/` - PHP controllers
14+
- `http/` - HTTP layer
15+
- `js/` - Frontend JavaScript
16+
- `css/` - Stylesheets
17+
- `templates/` - Server-side templates
18+
- `l10n/` - Translations
19+
- `appinfo/` - ownCloud app metadata
20+
- `img/` - App icons
21+
- `screenshots/` - App screenshots
22+
- `tests/` - Test suites
23+
- `Makefile` - Build and test automation
24+
- `composer.json` - PHP dependencies
25+
- `package.json` - JavaScript dependencies
26+
- `gulpfile.js` - Gulp task runner configuration
27+
- `phpunit.xml` - PHPUnit configuration
28+
29+
## Development Conventions
30+
- **Branching:** master
31+
- **Commit messages:** DCO sign-off required (`git commit -s`)
32+
- **Code style:** PHP_CodeSniffer, ownCloud coding standard, ESLint
33+
- **PR process:** Open a PR against master. All CI checks must pass.
34+
35+
## Build & Test Commands
36+
```bash
37+
# Build
38+
make
39+
40+
# Test (all)
41+
make test
42+
43+
# Test (PHP unit)
44+
make test-php-unit
45+
46+
# Test (JavaScript)
47+
make test-js
48+
49+
# Lint (PHP)
50+
make test-php-style
51+
52+
# Fix code style
53+
make test-php-style-fix
54+
```
55+
56+
## Important Constraints
57+
- All code contributions must be compatible with the **AGPL-3.0** license
58+
- Do not introduce new **copyleft-licensed dependencies** (GPL, AGPL, LGPL, MPL) without explicit discussion in an issue first. This is especially important for repos migrating to Apache 2.0.
59+
- Do not introduce new dependencies without discussion in an issue first
60+
- This app is the frontend only; the CalDAV backend is in ownCloud Core
61+
62+
63+
## OSPO Policy Constraints
64+
65+
### GitHub Actions
66+
- **Only** use actions owned by `owncloud`, created by GitHub (`actions/*`), or verified on the GitHub Marketplace.
67+
- Pin all actions to their full commit SHA (not tags): `uses: actions/checkout@<SHA> # vX.Y.Z`
68+
- Never introduce actions from unverified third parties.
69+
70+
### Dependency Management
71+
- Dependabot is configured for automated dependency updates.
72+
- Review and merge Dependabot PRs as part of regular maintenance.
73+
- Do not introduce new dependencies without discussion in an issue first.
74+
75+
### Git Workflow
76+
- **Rebase policy**: Always rebase; never create merge commits. Use `git pull --rebase` and `git rebase` before pushing.
77+
- **Signed commits**: All commits **must** be PGP/GPG signed (`git commit -S -s`).
78+
- **DCO sign-off**: Every commit needs a `Signed-off-by` line (`git commit -s`).
79+
- **Conventional Commits**: Use the [Conventional Commits](https://www.conventionalcommits.org/) format where the repository enforces it.
80+
81+
## Context for AI Agents
82+
- Match existing code style
83+
- Do not refactor unrelated code in the same PR
84+
- Write tests for new functionality
85+
- Keep PRs focused and atomic
86+
- Backend (CalDAV) issues should be filed against ownCloud Core, not this repository

‎yarn.lock‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3255,9 +3255,9 @@ js-tokens@^3.0.2:
32553255
integrity sha1-mGbfOVECEw449/mWvOtlRDIJwls=
32563256

32573257
js-yaml@3.x, js-yaml@^3.13.0:
3258-
version "3.13.1"
3259-
resolved "https://registry.yarnpkg.com/js-yaml/-/js-yaml-3.13.1.tgz#aff151b30bfdfa8e49e05da22e7415e9dfa37847"
3260-
integrity sha512-YfbcO7jXDdyj0DGxYVSlSeQNHbD7XPWvrVWeVUujrQEoZzWJIRrCPoyk6kL6IAjAG2IolMK4T0hNUe0HOUs5Jw==
3258+
version "3.15.0"
3259+
resolved "https://registry.yarnpkg.com/js-yaml/-/js-yaml-3.15.0.tgz#586e5214eafe3e893756a41e979b50d89d3e4a67"
3260+
integrity sha512-ttBQIIQPDeLjpPOohtUdXuXUVoA2uIB6fEH9HyJ7234s5mBJ5wTx20njxplLZQgLaOfpmPQA7X2t5AX6tIPbog==
32613261
dependencies:
32623262
argparse "^1.0.7"
32633263
esprima "^4.0.0"

0 commit comments

Comments
 (0)