Verwaltung benutzerdefinierter statischer Vorlagen

Verwalten Sie die Registrierung Ihrer Vorlagendateien.

Vorbereitende Schritte

Registrierung von Vorlagendateien verwalten

Eine Vorlagendatei registrieren

curl -X POST 'https://<tenant>/template/v1.0/branding/registration/<type>' --header 'Authorization: Bearer <access_token>' -F 'file=@"<file>"'

Dieser Befehl registriert eine Vorlagendatei. In der folgenden Tabelle sind die zulässigen Dateiformate aufgeführt.

Zulässige Typen Zulässige Dateiendungen Maximale Anzahl von Dateien pro Typ Maximale Dateigröße
js .js 15 300 KB
CSS .css 15 100 KB
icon .ico,.png und.svg 30 100 KB
Abbildung .png,.jpg,.jpeg,.gif,.svg und.webp 15 500 KB
Schriftart .woff,..woff2,.ttf,.otf und.eot 15 500 KB

Alle Vorlagendateien eines Typs abrufen

curl -X GET 'https://<tenant>/template/v1.0/branding/registration/<type>' -H 'Authorization: Bearer <access_token>'

Dieser Befehl listet alle Dateien auf, die für den angegebenen Dateityp registriert sind.

Eine Vorlagendatei löschen

curl -X DELETE 'https://<tenant>/template/v1.0/branding/registration/<type>/<file_name>' --header 'Authorization: Bearer <access_token>'

Dieser Befehl löscht eine vorhandene Datei.

Alle Vorlagendateien eines Typs löschen

curl -X DELETE 'https://<tenant>/template/v1.0/branding/registration/<type>' --header 'Authorization: Bearer <access_token>'

Dieser Befehl löscht alle Dateien, die unter dem angegebenen Dateityp registriert sind.

Eine Vorlagendatei anpassen

Sie können eine Vorlagendatei aktualisieren, nachdem sie registriert wurde. Informationen zum Bearbeiten einer vorhandenen Vorlagendatei finden Sie auf den folgenden Seiten:
Hinweis: Wenn die Webseite nach der Aktualisierung über den /template/v1.0/static API-Pfad auf die Datei verweist, werden die Änderungen möglicherweise nicht sofort angezeigt. Leeren Sie den Cache Ihres Browsers und warten Sie bis zu 5 Minuten, bis die Aktualisierung wirksam wird.

Verwendung einer registrierten Datei in HTML

Erstellen Sie eine .js Datei, speichern Sie <js-filename> sie und fügen Sie sie in die HTML-Seite ein:

<script type="text/javascript" src="/template/v1.0/static/js/<js-filename>?themeId=@THEME_ID@"></script>

Bei einer Bilddatei registrieren Sie die <image-filename> Datei und fügen Sie sie in die HTML-Seite ein:

<img src="/template/v1.0/static/assets/image/<image-filename>?themeId=@THEME_ID@">

Registrieren Sie die <icon-filename> Icon-Datei und fügen Sie sie in die HTML-Seite ein:

<link rel="icon" href="/template/v1.0/static/assets/icon/<icon-filename>?themeId=@THEME_ID@">

Erstellen Sie eine .css Datei, speichern Sie <css-filename> sie und fügen Sie sie in die HTML-Seite ein:

<link rel="stylesheet" href="/template/v1.0/static/assets/css/<css-filename>?themeId=@THEME_ID@">

<css-filename>Um eine Schriftartdatei einzubinden, füge sie in die .css Datei ein:

@font-face {   
    font-family: '<font-family>';   
    src: url('/template/v1.0/static/assets/fonts/<font-filename>?themeId=@THEME_ID@') format('<font-format>')
}


.custom-text {   
    font-family: '<font-family>'
}  

<css-filename>Nachdem Sie die Schriftartdatei <font-filename> und die .css Datei registriert haben, fügen Sie sie in die HTML-Seite ein:

<link rel="stylesheet" href="/template/v1.0/static/assets/css/<css-filename>?themeId=@THEME_ID@" />
Hinweis: @THEME_ID@ ist ein Makro, das die Theme-ID angibt. Es wird zur Laufzeit durch das eigentliche ` themeId ` ersetzt.