Mirror of NextCloud Server

Côme Chilliet 344d058016 fix(tests): Fix most obvious errors in ObjectStore tests 1 mēnesi atpakaļ
.devcontainer 0776f84947 Fix devcontainer url 2 gadi atpakaļ
.github 87786494f2 ci(psalm): Add missing imagick extension 1 nedēļu atpakaļ
.idea 2accc24fa9 Add newline that was removed by 15be763d46d56c57d4f0def7745bb02d513e3a38 10 gadi atpakaļ
.tx 4a35dc1f89 [tx-robot] Update transifex configuration 2 gadi atpakaļ
3rdparty @ 25c40620ae 4493b163af fix(deps): Update phpseclib to 2.0.47 7 mēneši atpakaļ
apps c46415847f Merge pull request #48927 from nextcloud/backport/48917/stable26 1 nedēļu atpakaļ
build ce9be3d5cd fix(dav): Always respond custom error page on exceptions 1 mēnesi atpakaļ
config 32fb6032d2 docs(config.sample.php): 7 mēneši atpakaļ
contribute 08b005fb0e Move GitHub files to .github directory 6 gadi atpakaļ
core 2a10014d0f fix: Prevent duplicate creation of print_exception function 1 mēnesi atpakaļ
cypress 2fc2a0d613 fix(cypress): revert only toggle 1 gadu atpakaļ
dist 79e3c680c8 chore(assets): Recompile assets 6 mēneši atpakaļ
lib 8b951e1b62 perf(ObjectStoreStorage): Improve (slow) move on same object bucket 5 dienas atpakaļ
ocs 21334a8836 fix(bruteforce-protection): Don't throw a 500 when MaxDelayReached is thrown 11 mēneši atpakaļ
ocs-provider f3319f6294 Allow to call the files even when you are in another instance atm 8 gadi atpakaļ
resources 80798fca25 fix(security): Update code signing revocation list 2 nedēļas atpakaļ
tests 344d058016 fix(tests): Fix most obvious errors in ObjectStore tests 5 dienas atpakaļ
themes 0f9aa499e4 Drop \OC_Theme::getLogoClaim 3 gadi atpakaļ
vendor-bin f27c3d0a04 composer update php 1 gadu atpakaļ
.codecov.yml 096c92cbee Disable codecov status and comment 6 gadi atpakaļ
.drone.yml a611f045be chore(CI): Sign .drone.yml file 1 gadu atpakaļ
.editorconfig 058ca8c560 Update editor config for .yml files 4 gadi atpakaļ
.eslintignore 6d883a8572 Fix various errors reported by eslint 2 gadi atpakaļ
.eslintrc.js b9906fb21e feat(files): Quota in navigation 1 gadu atpakaļ
.git-blame-ignore-revs afef7e4433 chore: add .git-blame-ignore-revs 1 mēnesi atpakaļ
.gitattributes 045bc32b1d Mark compiled CSS as binary 1 gadu atpakaļ
.gitignore 064fa10ecf Extract colour from custom background 1 gadu atpakaļ
.gitmodules eb0d740c1d targets 3rdparty submodule from Nc instead of oC 8 gadi atpakaļ
.htaccess 206bba9d27 Buffer chunked requests 9 mēneši atpakaļ
.jshintrc d790c27a19 Reduce JSHint errors/warnings 7 gadi atpakaļ
.mailmap 9aa248f007 Merge pull request #29245 from nextcloud/artonge-patch-1 3 gadi atpakaļ
.npmignore 70edda0342 Port dav calendar settings page to Vue.js 3 gadi atpakaļ
.php-cs-fixer.dist.php 47c9c34cca Fix psalm not running 2 gadi atpakaļ
.pre-commit-config.yaml c49bf7fa9f Do not apply codestyle to composer autoloaders 2 gadi atpakaļ
.scrutinizer.yml 3953e4aea1 Migrate Scrutinizer to new PHP Analysis 6 gadi atpakaļ
.tag 1efa338a52 Add .tag file to make tar balls tracable 10 gadi atpakaļ
.user.ini c6a69ba925 Remove the upload and memory setting 5 gadi atpakaļ
AUTHORS 0d42085b53 Bump AUTHORS 3 gadi atpakaļ
CHANGELOG.md e9532cfbbb Add link to real changelog 7 gadi atpakaļ
CODE_OF_CONDUCT.md 89d3c5e5b9 Create CODE_OF_CONDUCT.md 6 gadi atpakaļ
COPYING 03a0f4cbad Rename COPYING-AGPL to COPYING 8 gadi atpakaļ
COPYING-README 0fad921840 Add user-status app 4 gadi atpakaļ
DESIGN.md a97ee57745 docs(design): add basic design contribution guidelines 1 gadu atpakaļ
Makefile 87d0904b6f Split common vendor chunk 2 gadi atpakaļ
README.md fc22acba8e Merge pull request #35656 from fivenp/docs/add-design-contribution-guidelines 1 gadu atpakaļ
SECURITY.md be506f7b29 Set up a security policy 4 gadi atpakaļ
autotest-checkers.sh 258c919b3c ci: migrate ocp since checker to psalm 1 gadu atpakaļ
autotest-external.sh 027808c019 Remove the prefix setting attempt from our CI 4 gadi atpakaļ
autotest-js.sh b8a7ab9941 Fix jsunit 2 gadi atpakaļ
autotest.sh 5096d4f5cb Align version number of PHPUnit and give a helping install hint 1 gadu atpakaļ
babel.config.js 887c9e05de Port Files navigation to vue 1 gadu atpakaļ
composer.json 71162629cf fix(CI): Temporary workaround - Run Psalm CI with 1 thread only so it finishes 1 gadu atpakaļ
composer.lock 04578bc7ed chore(deps): Declare ext-openssl as required 1 gadu atpakaļ
console.php 010924916c Fix small typo 2 gadi atpakaļ
cron.php c8a6dad519 Cleanup tempfiles after each cron job run 2 gadi atpakaļ
cypress.config.ts cb0ba3e008 Do not stop docker in cypress workflow 1 gadu atpakaļ
index.html 869a674f29 remove type="text/javascript" from index.html 6 gadi atpakaļ
index.php 21334a8836 fix(bruteforce-protection): Don't throw a 500 when MaxDelayReached is thrown 11 mēneši atpakaļ
jest.config.js 7622fdfce3 Remove unneeded and problematic vue-cli-plugin-unit-test 2 gadi atpakaļ
occ 68a9376858 Use a more universal shebang 10 gadi atpakaļ
package-lock.json 27161f7cff chore(deps): fix package-lock.json 1 gadu atpakaļ
package.json b25a573095 chore: update `@nextcloud-vue` to `v7.12.2` 1 gadu atpakaļ
psalm-ocp.xml 258c919b3c ci: migrate ocp since checker to psalm 1 gadu atpakaļ
psalm.xml 1bd9d9143b ocm services 1 gadu atpakaļ
public.php 90c53df248 app type extended_authentication 1 gadu atpakaļ
remote.php 90c53df248 app type extended_authentication 1 gadu atpakaļ
robots.txt 5b77f16d57 Add robot.txt 11 gadi atpakaļ
status.php c0474ba364 Use product name in places where it is appropriate rather than the instance name 3 gadi atpakaļ
tsconfig.json 887c9e05de Port Files navigation to vue 1 gadu atpakaļ
version.php d6612b5c18 build(hub): 26.0.13 7 mēneši atpakaļ
webpack.common.js 2d4cb2aeab Remove extraneous Node.js core module dependencies 1 gadu atpakaļ
webpack.config.js 5b9a8f0407 Add component testing 1 gadu atpakaļ
webpack.modules.js 6130f1a78e Implement file reference wiget 1 gadu atpakaļ

README.md

Nextcloud Server ☁

Scrutinizer Code Quality codecov CII Best Practices Design

A safe home for all your data.

Why is this so awesome? 🤩

  • 📁 Access your Data You can store your files, contacts, calendars, and more on a server of your choosing.
  • 🔄 Sync your Data You keep your files, contacts, calendars, and more synchronized amongst your devices.
  • 🙌 Share your Data …by giving others access to the stuff you want them to see or to collaborate with.
  • 🚀 Expandable with hundreds of Apps ...like Calendar, Contacts, Mail, Video Chat and all those you can discover in our App Store
  • 🔒 Security with our encryption mechanisms, HackerOne bounty program and two-factor authentication.

Do you want to learn more about how you can use Nextcloud to access, share and protect your files, calendars, contacts, communication & more at home and in your organization? Learn about all our Features.

Get your Nextcloud 🚚

Enterprise? Public Sector or Education user? You may want to have a look into Nextcloud Enterprise provided by Nextcloud GmbH.

Get in touch 💬

You can also get support for Nextcloud!

Join the team 👪

There are many ways to contribute, of which development is only one! Find out how to get involved, including as a translator, designer, tester, helping others, and much more! 😍

Development setup 👩‍💻

  1. 🚀 Set up your local development environment
  2. 🐛 Pick a good first issue
  3. 👩‍🔧 Create a branch and make your changes. Remember to sign off your commits using git commit -sm "Your commit message"
  4. ⬆ Create a pull request and @mention the people from the issue to review
  5. 👍 Fix things that come up during a review
  6. 🎉 Wait for it to get merged!

Third-party components are handled as git submodules which have to be initialized first. So aside from the regular git checkout invoking git submodule update --init or a similar command is needed, for details see Git documentation.

Several apps that are included by default in regular releases such as First run wizard or Activity are missing in master and have to be installed manually by cloning them into the apps subfolder.

Otherwise, git checkouts can be handled the same as release archives, by using the stable* branches. Note they should never be used on production systems.

Working with front-end code 🏗

Building Vue components and scripts

We are moving more and more toward using Vue.js in the front-end, starting with Settings. For building the code on changes, use these terminal commands in the root folder:

# install dependencies
make dev-setup

# build for development
make build-js

# build for development and watch edits
make watch-js

# build for production with minification
make build-js-production

Building styles

Styles are written in SCSS and compiled to css.

# install dependencies
make dev-setup

# compile style sheets
npm run sass

# compile style sheets and watch edits
npm run sass:watch

Committing changes

When making changes, also commit the compiled files!

We still use Handlebars templates in some places in Files and Settings. We will replace these step-by-step with Vue.js, but in the meantime, you need to compile them separately.

If you don’t have Handlebars installed yet, you can do it with this terminal command:

sudo npm install -g handlebars

Then inside the root folder of your local Nextcloud development installation, run this command in the terminal every time you changed a .handlebars file to compile it:

./build/compile-handlebars-templates.sh

Before checking in JS changes, make sure to also build for production:

make build-js-production

Then add the compiled files for committing.

To save some time, to only rebuild for a specific app, use the following and replace the module with the app name:

MODULE=user_status make build-js-production

Please note that if you used make build-js or make watch-js before, you'll notice that a lot of files were marked as changed, so might need to clear the workspace first.

Working with back-end code 🏗

When changing back-end PHP code, in general, no additional steps are needed before checking in.

However, if new files were created, you will need to run the following command to update the autoloader files:

build/autoloaderchecker.sh

After that, please also include the autoloader file changes in your commits.

Tools we use 🛠

Contribution guidelines 📜

All contributions to this repository from June 16, 2016, and onward are considered to be licensed under the AGPLv3 or any later version.

Nextcloud doesn't require a CLA (Contributor License Agreement). The copyright belongs to all the individual contributors. Therefore we recommend that every contributor adds the following line to the header of a file if they changed it substantially:

@copyright Copyright (c) <year>, <your name> (<your email address>)

Please read the Code of Conduct. This document offers some guidance to ensure Nextcloud participants can cooperate effectively in a positive and inspiring atmosphere, and to explain how together we can strengthen and support each other.

Please review the guidelines for contributing to this repository.

More information how to contribute: https://nextcloud.com/contribute/