side_menu

This application customs the top menu of Nextcloud 📦 https://apps.nextcloud.com/apps/side_menu 📘 https://deblan.gitnet.page/side_menu_doc/

plugin

Go to file

Simon Vieille 0ce318d6ec ci/woodpecker/push/woodpecker Pipeline was successful Details Merge pull request 'fix ci syntax' (#281 ) from develop into master Reviewed-on: #281		2023-09-29 16:48:36 +02:00
.gitea/issue_template	update issue template	2023-02-20 13:50:53 +01:00
appinfo	release v3.10.3	2023-07-24 21:32:13 +02:00
bin	add a script to import config	2020-10-23 18:25:08 +02:00
css	fix top position of always opened menu	2023-06-23 15:37:03 +02:00
img	update icons (#84 )	2022-01-10 14:59:17 +01:00
l10n	add gitignore	2020-08-28 16:46:38 +02:00
lib	release v3.10.2	2023-07-15 15:22:09 +02:00
screenshots	update screenshots	2022-11-04 22:26:20 +01:00
src	update @nexcloud/* packages	2023-07-24 21:10:30 +02:00
templates	refactoring choices	2023-05-23 14:17:45 +02:00
vendor	replace the sortable jquery plugin with html5sortable	2021-11-05 20:19:08 +01:00
.eslintrc.js	init	2020-03-28 17:40:53 +01:00
.gitignore	update gitignore and add yarn lock file	2022-10-16 20:00:06 +02:00
.stylelintrc.json	update rules of makefile, webpack, stylelintrc	2022-10-16 18:23:20 +02:00
.woodpecker.yml	fix ci syntax	2023-09-29 16:46:56 +02:00
CHANGELOG.md	release v3.10.3	2023-07-24 21:32:13 +02:00
CODE_OF_CONDUCT.md	fix the code of conduct	2021-11-06 20:11:53 +01:00
LICENCE	add licence	2020-03-29 13:47:07 +02:00
Makefile	reduce release task as packaging (ci)	2023-03-17 17:22:35 +01:00
README.md	add badge of downloads	2023-03-11 00:29:32 +01:00
package.json	update @nexcloud/* packages	2023-07-24 21:10:30 +02:00
webpack.js	update rules of makefile, webpack, stylelintrc	2022-10-16 18:23:20 +02:00

README.md

Allows you to modify the position of the main menu by creating a panel on the left of the interface or with a big menu on the top. You can also add and sort custom categories, define apps that must be displayed in the top menu, etc. Fully customisable.

This application is rather suitable for instances that activate a lot of applications.

You can customize colors depending of the theme (Dark theme and Breeze Dark).

Installation and upgrade
How to contribute?
Support
Screenshots

You like this app and you want to support me? ☕ Buy me a coffee or Donate with liberapay

📘 Read the documentation

Requirements

PHP >= 8.0
App theming enabled

Installation and upgrade

Custom menu is available from the app store.

$ cd /path/to/nextcloud
$ php occ app:install side_menu

If you want to install it from source, go to https://gitnet.fr/deblan/side_menu/releases and copy the link to the last release (side_menu_vX.Y.Z.tar.gz). Then:

$ cd /path/to/nextcloud/apps
$ curl -sS https://gitnet.fr/attachments/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | tar xvfz -

Administrators can edit many settings using the administration page.

Users can disable the menu using the page of personal settings.

Use the shortcut Ctrl+o to open and to hide the side menu. Use tab to navigate.

You can easily let Custom Menu redirect to the first app in the top menu by changing the following parameter in your config/config.php:

'defaultapp' => 'side_menu',

If the top menu is empty then it redirects to files.

How to contribute?

You can report a bug or request a feature by opening an issue: https://gitnet.fr/deblan/side_menu/issues

You are a translator

Translations are managed from translate.codeberg.org.

You are a developer

fork the repository
install an instance of Nextcloud
go to apps/ and clone your repository
go to apps/side_menu and run make dep

Build javascripts using make build (or make watch to build them in real time).

Then commit and create a pull request.

Support

You can join the official room on Matrix: #custommenu:neutralnetwork.org.

Notice

Because I believe in a free and decentralized Internet, Gitnet is self-hosted at home. In case of downtime, you can download Custom Menu from here.