Gestion des modèles statiques personnalisés

Gérez l'enregistrement de vos fichiers de modèles.

Avant de commencer

Gérer l'enregistrement des fichiers de modèle

Enregistrer un fichier modèle

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

Cette commande permet d'enregistrer un fichier modèle. Le tableau ci-dessous répertorie les types de fichiers autorisés.

Types autorisés Extensions de fichiers autorisées Nombre maximal de fichiers par type Taille maximale par fichier
js .js 15 300 Ko
CSS .css 15 100 ko
icon .ico,.png et.svg 30 100 ko
image .png,.jpg,.jpeg,.gif,.svg et.webp 15 500 ko
police .woff,..woff2,.ttf,.otf et.eot 15 500 ko

Récupérer tous les fichiers de modèle d'un type donné

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

Cette commande répertorie tous les fichiers associés à ce type de fichier.

Supprimer un fichier modèle

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

Cette commande supprime un fichier existant.

Supprimer tous les fichiers de modèle d'un type

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

Cette commande supprime tous les fichiers correspondant au type de fichier spécifié.

Personnaliser un fichier modèle

Vous pouvez modifier un fichier de modèle une fois qu'il a été enregistré. Pour modifier un fichier de modèle existant, consultez les pages suivantes :
Remarque : si la page Web fait référence au fichier via le /template/v1.0/static chemin d'accès API après sa mise à jour, les modifications peuvent ne pas apparaître immédiatement. Videz le cache de votre navigateur et patientez jusqu'à 5 minutes pour que la mise à jour prenne effet.

Utilisation d'un fichier enregistré au format HTML

Pour un .js fichier, enregistrez-le <js-filename> , puis ajoutez-le à la page HTML :

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

Pour un fichier image, enregistrez le <image-filename> fichier, puis ajoutez-le dans la page HTML :

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

Pour un fichier icône, enregistrez le <icon-filename> fichier, puis ajoutez-le dans la page HTML :

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

Pour un .css fichier, enregistrez-le <css-filename> , puis ajoutez-le à la page HTML :

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

Pour un fichier de police, incluez-le dans le .css fichier <css-filename>:

@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>'
}  

Après avoir enregistré le fichier <font-filename> de police et le .css fichier <css-filename>, ajoutez-le dans la page HTML :

<link rel="stylesheet" href="/template/v1.0/static/assets/css/<css-filename>?themeId=@THEME_ID@" />
Remarque : @THEME_ID@ est une macro qui représente l'identifiant du thème. Elle est remplacée par l' themeId e réelle lors de l'exécution.