Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nextmcloud/nmctheme

MagentaCLOUD theme as app for refactored style system since NC25
https://github.com/nextmcloud/nmctheme

customized magentacloud nextcloud

Last synced: about 2 months ago
JSON representation

MagentaCLOUD theme as app for refactored style system since NC25

Awesome Lists containing this project

README

        

= MagentaCLOUD theme for Nextcloud 25+
This is the MagentaCLOUD "modernized" theme for the new stylesheet/theming system since Nextcloud 25.

== Overall changes to Nextcloud standard themes

1. The theme uses Telekom branding standards that are in the
https://github.com/telekom/design-tokens[*github.com/telekom/design_token*] repo
available as OpenSource

2. The _TeleNeoWeb_ are forced to be the enabled in Nextcloud installation as soon as this app is installed.
(Note the Telekom branding license restriction!)

3. Nextcloud icons are replaced by Telekom or MagentaCLOUD standard icons.
(Note the Telekom branding license restriction!)

== Configuration
This is the recommended configuration for the installation of this theme:

.Nextcloud server `config/theme.config.php`
----
'magenta25', // or any other theme contained in the app
'theme' => '' // disable old themeing
);
----

.Restriction of supported languages (optional, example on some en and de locales)
----
'de_DE',
'nmc_supported_locales' => array(0 => 'en', 1 => 'en_GB', 2 => 'de', 3 => 'de_DE');
);
----

.Nextcloud standard *theming* app configs
----
# Set base url of the installation
/usr/bin/php occ theming:config url

# disable user themeing
/usr/bin/php occ theming:config disable-user-theming yes

# "Organisational" setting
/usr/bin/php occ theming:config color "#e20074" # don't use uppercase letters!
/usr/bin/php occ theming:config name "MagentaCLOUD"
/usr/bin/php occ theming:config slogan "Alle Dateien sicher an einem Ort"
/usr/bin/php occ theming:config imprintUrl "http://www.telekom.de/impressum"
/usr/bin/php occ theming:config privacyUrl "https://static.magentacloud.de/Datenschutz"

# application ids for mobile apps (with real MagentaCLOUD ids)
/usr/bin/php occ config:app:set theming AndroidClientUrl --value \
"https://play.google.com/store/apps/details?=com.t_systems.android.webdav"
/usr/bin/php occ config:app:set theming iTunesAppId --value "312838242"
/usr/bin/php occ config:app:set theming iOSClientUrl --value \
"https://apps.apple.com/us/app/magentacloud-cloud-speicher/id312838242"
----

NOTE: The theming icons are not directly exposed by the `nmctheme`app, but delivered for
upload under `lib/icons/*.*`. You need to use absolute path for the occ theming upload command.

.Busting user browser caches
The theme delivers a command to "bust" all the client browser caches for the rollout of a
modified theme. This is accomplished by changing a cachebuster query parameter `v=` that is
appended to the URL of all theme elements.

----
# getting the current cachebuster value
/usr/bin/php occ nmctheme:cachebuster

# busting all user caches
/usr/bin/php occ nmctheme:cachebuster --bust
----