Athento incluye varias zonas de la interfaz donde es posible añadir información personalizada, así como botones y enlaces.
Esta personalización se realiza mediante plantillas HTML compatibles con el framework Django. Con las plantillas personalizables Athento puedes adaptar elementos como la cabecera, la barra lateral y los botones.
Las siguientes áreas son personalizables:
Las plantillas configurables son:
- custom_header.html
- custom_sidebar.html
- custom_header_right.html
- custom_document_buttons.html
Configuración
Para utilizar estas plantillas, debes definir la propiedad ENABLE_CUSTOMIZED_TEMPLATES en local_settings.py con el valor True.
Una vez definido ENABLE_CUSTOMIZED_TEMPLATES, deben crearse todas las plantillas custom, aunque estén vacías.
A continuación, crea el enlace simbólico en la carpeta /var/www/athentose/athentose/templates. Por ejemplo:
ln -s /var/www/athentose/athentose/custom/acme/templates/* /var/www/athentose/athentose/templates
También puedes configurar la aplicación personalizada como una app de Django. Para ello, actívala en:
athentose/settings_config/custom/settings_custom_apps.py
Por ejemplo, si tu app se llama "acme", el contenido de custom_apps.py debe ser:
CUSTOM_INSTALLED_APPS = (
'acme.apps.AcmeAppConfig',
)
Para incluir la aplicación, debes crear la clase AcmeAppConfig en el archivo apps.py:
from core.apps import IntegrationAppConfig
from django.conf.urls import include
from django.urls import re_path
class AcmeAppConfig(IntegrationAppConfig):
name = 'acme'
def ready(self):
pass
def get_urlpatterns(self):
return [
re_path(r'^acme/', include('acme.urls', namespace='acme')),
]
Posibles usos de las plantillas personalizables
Athento permite añadir botones personalizados en la cabecera. Estos botones pueden redirigir al usuario a una pantalla o panel de la plataforma, o generar un nuevo documento a partir de un formulario o un espacio específico.
Diseño
Los botones se crean con código HTML y luego se configuran en la instancia. El HTML debe incluir la referencia (link) a la que se quiere redirigir al usuario.
En el caso de los botones que permiten crear nuevos documentos, el link es el siguiente:
/doctypes/quick/create/<UUID del espacio en el que se creara el documento>/<UUID del formulario que tendrá el documento>
Para añadir elementos a la barra lateral y al encabezado, también puedes usar los botones personalizados.