External Portal

A Nextcloud Dashboard widget providing a view of the current user's external sites. This app uses directly the sites provided by External sites API, which is thus required for meaningful usage of this app.

This app is not affiliated with the External sites app. Implementing the corresponding functionality in the External sites app would have also been a possibility - however, due to the very limited interoperability required, a separate app was chosen as a lighter solution.

Requirements

• Nextcloud 31 or 32
• PHP 8.1+
• Node.js 20+
• External sites app installed and configured

Building the app

Install dependencies and build:

npm install
npm run build

The app can also be built with

make

which creates a package build/externalportal.tar.gz suitable for a local installation in the apps directory on a Nextcloud instance.

For development with file watching:

npm run watch

Linting

npm run lint
npm run stylelint
composer cs:check
composer psalm

Releasing a new version

This section is only for the official app maintainers.

1. Update the version in appinfo/info.xml and package.json

2. Update CHANGELOG.md

3. Commit and tag the release:

   git add appinfo/info.xml package.json CHANGELOG.md
   git commit -m "vx.x.x"
   git tag vx.x.x
   git push && git push --tags

4. Set the shared_dir variable in the Makefile to match your development enviroment

5. Build and sign the appstore package:

   make sign

   This uses docker exec to run occ integrity:sign-app inside the master-nextcloud-1 container. Signing certificates must be placed in ~/.nextcloud/certificates/ (externalportal.key and externalportal.crt).

6. Upload build/externalportal.tar.gz to the Nextcloud App Store