Gestión de plantillas estáticas personalizadas

Antes de empezar

Obtén un token de acceso. Consulte «Gestión de temas ».

Gestionar el registro de archivos de plantillas

Registrar un archivo de plantilla

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

Este comando registra un archivo de plantilla. En la siguiente tabla se indican los tipos de archivo permitidos.

Tipos permitidos	Extensiones de archivo permitidas	Número máximo de archivos por tipo	Tamaño máximo por archivo
js	.js	15	300 KB
CSS	.css	15	100 KB
icon	.ico,.png y.svg	30	100 KB
imagen	.png,.jpg,.jpeg,.gif,.svg y.webp	15	500 KB
Fuente	.woff,..woff2,.ttf,.otf y.eot	15	500 KB

Obtener todos los archivos de plantilla de un tipo

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

Este comando muestra todos los archivos registrados para ese tipo de archivo concreto.

Eliminar un archivo de plantilla

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

Este comando elimina un archivo existente.

Eliminar todos los archivos de plantilla de un tipo

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

Este comando elimina todos los archivos que corresponden a ese tipo de archivo concreto.

Personalizar un archivo de plantilla

Puedes actualizar un archivo de plantilla una vez que se haya registrado. Para modificar un archivo de plantilla existente, consulte las siguientes páginas:

Nota: Si la página web hace referencia al archivo a través de la /template/v1.0/static ruta de la API después de actualizarlo, es posible que los cambios no se vean de inmediato. Borra la caché del navegador y espera hasta 5 minutos a que se aplique la actualización.

Uso de un archivo registrado en HTML

Para crear un .js archivo, guárdalo y <js-filename> añádelo a la página HTML:

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

En el caso de un archivo de imagen, guarda el <image-filename> archivo y añádelo a la página HTML:

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

En el caso de un archivo de iconos, regístralo <icon-filename> y añádelo a la página HTML:

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

Para un .css archivo, regístralo <css-filename> y añádelo a la página HTML:

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

<css-filename>Para incluir un archivo de fuente, añádelo al archivo .css :

@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>Una vez registrado el archivo <font-filename> de fuente y el .css archivo, añádelo a la página HTML:

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

Nota: @THEME_ID@ es una macro que representa el ID del tema. En tiempo de ejecución se sustituye por el themeId real.