|
1 | 1 | # Announcement Center |
2 | 2 |
|
3 | | -An Announcement Center app for ownCloud (allows administrators to publish announcements for users) |
4 | | -Depends on ['notifications'](https://github.com/owncloud/notifications) backend |
| 3 | +<!-- OSPO-managed README | Generated: 2026-04-16 | v2 --> |
5 | 4 |
|
6 | | -## QA metrics on master branch: |
| 5 | +[](COPYING) [](https://kiteworks.com/opensource) [](https://hub.docker.com/r/owncloud/server) |
7 | 6 |
|
8 | | -[](https://drone.owncloud.com/owncloud/announcementcenter) |
9 | | -[](https://sonarcloud.io/dashboard?id=owncloud_announcementcenter) |
10 | | -[](https://sonarcloud.io/dashboard?id=owncloud_announcementcenter) |
11 | | -[](https://sonarcloud.io/dashboard?id=owncloud_announcementcenter) |
| 7 | +The Announcement Center is an ownCloud Server app that allows administrators to publish announcements visible to all users. Announcements appear on a dedicated front page accessible from the app launcher, and users are automatically notified via the activity stream. The app depends on the [notifications](https://github.com/owncloud/notifications) backend for delivering notifications. |
12 | 8 |
|
13 | | ---- |
| 9 | +## Part of Classic (OC10) |
14 | 10 |
|
15 | | -## Screenshots |
| 11 | +Announcement Center is an app for [ownCloud Server (Classic)](https://github.com/owncloud/core). It is available on [Docker Hub as part of the ownCloud Server image](https://hub.docker.com/r/owncloud/server). |
16 | 12 |
|
17 | | -### Announcements front page (the "Add announcement" form is admin only) |
| 13 | +## Getting Started |
18 | 14 |
|
19 | | - |
| 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 announcementcenter` |
| 18 | +4. Ensure the [notifications](https://github.com/owncloud/notifications) app is also installed and enabled |
20 | 19 |
|
21 | | ---- |
| 20 | +## Documentation |
22 | 21 |
|
23 | | -### The users are also informed by an activity in their stream (can not be disabled) |
| 22 | +- See the `docs/` directory for screenshots and additional information |
| 23 | +- [ownCloud Server documentation](https://doc.owncloud.com) |
24 | 24 |
|
25 | | - |
| 25 | +## Community & Support |
26 | 26 |
|
| 27 | +**[Star](https://github.com/owncloud/announcementcenter)** this repo and **Watch** for release notifications! |
| 28 | + |
| 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) |
| 35 | + |
| 36 | +## Contributing |
| 37 | + |
| 38 | +We welcome contributions! Please read the [Contributing Guidelines](CONTRIBUTING.md) |
| 39 | +and our [Code of Conduct](CODE_OF_CONDUCT.md) before getting started. |
| 40 | + |
| 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 |
0 commit comments