2020-09-23 13:17:13 +02:00
🤙 Nextcloud app / Custom menu 🎨
2020-03-28 21:00:06 +01:00
===============================
2022-10-21 21:17:02 +02:00
[![Build Status ](https://ci.gitnet.fr/api/badges/deblan/side_menu/status.svg )](https://ci.gitnet.fr/deblan/side_menu)
[![Translations ](https://translate.codeberg.org/widgets/custom-menu/-/application/svg-badge.svg )](https://translate.codeberg.org/engage/custom-menu/)
2020-09-23 13:17:13 +02:00
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.
2022-01-12 11:44:45 +01:00
You can also add and sort custom categories, define apps that must be displayed in the top menu, etc. Fully customisable.
2020-08-13 16:51:41 +02:00
2020-04-22 00:42:47 +02:00
This application is rather suitable for instances that activate a lot of applications.
2020-03-28 20:51:49 +01:00
2022-10-17 18:27:46 +02:00
You can customize colors depending of the theme (Dark theme and Breeze Dark).
2020-03-28 23:45:27 +01:00
2020-05-14 17:03:09 +02:00
* [Installation and upgrade ](#installation-and-upgrade )
2020-05-14 17:02:23 +02:00
* [How to contribute? ](#how-to-contribute )
2021-10-31 19:43:25 +01:00
* [Support ](#support )
2020-09-03 10:11:09 +02:00
* [Screenshots ](https://gitnet.fr/deblan/side_menu/src/branch/master/screenshots/ )
2020-03-30 10:44:46 +02:00
2020-11-06 18:17:17 +01:00
You like this app and you want to support me? ☕ [Buy me a coffee ](https://www.buymeacoffee.com/deblan ) or [Donate with liberapay ](https://liberapay.com/deblan )
2020-09-11 13:46:25 +02:00
2023-02-12 00:29:18 +01:00
## [Read the documentation](https://deblan.gitnet.page/side_menu_doc/)
2023-02-12 00:28:51 +01:00
2020-10-24 14:29:32 +02:00
Requirements
------------
2022-12-02 12:25:31 +01:00
* PHP >= 8.0
2020-10-24 14:29:32 +02:00
* App `theming` enabled
2020-05-14 15:30:34 +02:00
Installation and upgrade
------------------------
2020-04-09 10:52:58 +02:00
2020-10-16 13:42:23 +02:00
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:
2020-03-30 10:44:46 +02:00
```
$ cd /path/to/nextcloud/apps
2020-10-16 13:42:23 +02:00
$ curl -sS https://gitnet.fr/attachments/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx | tar xvfz -
2020-03-30 10:44:46 +02:00
```
2020-05-11 22:57:55 +02:00
Administrators can edit many settings using the administration page.
Users can disable the menu using the page of personal settings.
2020-04-09 14:33:35 +02:00
2020-05-14 15:30:34 +02:00
Use the shortcut `Ctrl` +`o` to open and to hide the side menu. Use `tab` to navigate.
2022-11-20 14:00:26 +01:00
### Use first top menu app as default app
2022-11-20 14:00:33 +01:00
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` :
2022-11-20 14:00:26 +01:00
```
'defaultapp' => 'side_menu',
```
2022-11-20 14:00:33 +01:00
If the top menu is empty then it redirects to files.
2020-04-09 14:33:35 +02:00
How to contribute?
------------------
2022-10-21 21:29:10 +02:00
You can report a bug or request a feature by opening an issue: https://gitnet.fr/deblan/side_menu/issues
2022-10-21 20:12:04 +02:00
### You are a translator
Translations are managed from [translate.codeberg.org ](https://translate.codeberg.org/projects/custom-menu/application/ ).
### You are a developer
2020-04-22 00:42:47 +02:00
* fork the repository
* install an instance of Nextcloud
* go to `apps/` and clone your repository
2022-10-16 18:23:20 +02:00
* go to `apps/side_menu` and run `make dep`
2020-04-09 14:33:35 +02:00
2022-10-16 18:23:20 +02:00
Build javascripts using `make build` (or `make watch` to build them in real time).
2020-04-09 14:33:35 +02:00
Then commit and create a pull request.
2021-10-31 19:43:25 +01:00
Support
-------
You can join the official room on Matrix: [#custommenu:neutralnetwork.org ](https://matrix.to/#/#custommenu:neutralnetwork.org ).
2022-10-21 23:58:36 +02:00
Notice
------
Because I believe in a free and decentralized Internet, [Gitnet ](https://gitnet.fr ) is **self-hosted at home** .
In case of downtime, you can download **Custom Menu** from [here ](https://kim.deblan.fr/~side_menu/ ).