docs(theming): update theming page

- Fresh screenshots
- Add disable-user-theming
- Explain how to set a static color as background via occ

Signed-off-by: Daniel Kesselberg <mail@danielkesselberg.de>
This commit is contained in:
Daniel Kesselberg
2023-06-05 18:18:48 +02:00
parent 0af4b9ee2a
commit b24010bc7f
4 changed files with 19 additions and 4 deletions

Binary file not shown.

Before

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 36 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 34 KiB

View File

@@ -14,16 +14,21 @@ Modify the appearance of Nextcloud
You can change the following parameters of the look and feel on your instance:
.. figure:: ../configuration_server/images/theming1.png
* Name (e.g. ACME Inc. Cloud)
* Web Address (e.g. https://acme.inc/)
* Web link (e.g. https://acme.inc/)
* Slogan
* Color: The color of header bar, checkboxes and folder icon
* Logo: The logo will appear in the header and on the log in page. Default has 62/34 px.
* Login image: The background image of the login page
* Background and login image: The background image
.. figure:: ../configuration_server/images/theming2.png
* Additional legal links (Legal notice and Privacy policy link)
* Custom header logo and favicon as alternative to auto-generation based on logo
.. figure:: ../configuration_server/images/theming.png
* Disable user theming: Although you can select and customize your instance, users can change their background and colors. If you want to enforce your customization, you can toggle this on.
Configure theming through CLI
-----------------------------
@@ -34,9 +39,19 @@ The following values are available to be set through this:
- name, url, imprintUrl, privacyUrl, slogan, color ``occ theming:config name "My Example Cloud"``
- background, logo, favicon, logoheader ``occ theming:config logo /tmp/mylogo.png``
- disable-user-theming (yes/no) ``occ theming:config disable-user-theming yes``
.. note:: Images require to be read from a local file on the Nextcloud server
Use a color instead of an image as background:
::
occ theming:config color "#0082c9"
occ theming:config --reset background
occ config:app:set theming backgroundMime --value="backgroundColor"
Theming of icons
----------------