Skip to content

MagentaCLOUD theme as app for refactored style system since NC25

License

AGPL-3.0, Unknown licenses found

Licenses found

AGPL-3.0
COPYING
Unknown
COPYING.DTAG
Notifications You must be signed in to change notification settings

nextmcloud/nmctheme

Repository files navigation

MagentaCLOUD theme for Nextcloud 25+

Overall changes to Nextcloud standard themes

  1. The theme uses Telekom branding standards that are in the 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
<?php
$CONFIG = array (
    'enforce_theme' => '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)
<?php
$CONFIG = array (
    'default_language' => '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 <baseurl of your installation, e.g. https://magentacloud.de>

# 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 "<strong>Magenta</strong>CLOUD"
/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