Esta página é destinada para atualizações 1.6.5 (Liquid) e superiores do TOTVS Fluig Plataforma.

Índice

Página de login personalizada

Todos os componentes da página de login podem ser personalizados, basta que sejam alterados os arquivos indicados nesta documentação. As personalizações exigem que o responsável tenha os conhecimentos básicos em HTML, JavaScript e CSS. 

Essa página contém as principais instruções de como efetuar a personalização, servindo como ponto de partida para seu desenvolvimento. Lembrando que qualquer personalização realizada na plataforma é de responsabilidade do cliente e não possui suporte do time TOTVS Fluig.

Criação da página de login personalizada

Para personalizar a página de login siga os passos a seguir:


  • Acesse o diretório [Instalação fluig]/repository/wcmdir/. Dentro dele, crie uma nova pasta chamada customlogin.


Caso as configurações do fluig tenham sido alteradas manualmente (por exemplo, para ambientes com alta disponibilidade), abra em um editor de texto o arquivo [diretório_instalação]/appserver/domain/configuration/domain.xml e localize nele a propriedade abaixo:

<simple name="java:global/wcm/globalDataDir">

Neste parâmetro estará informado o caminho alternativo do diretório [diretório_instalação]/repository/wcmdir/.


  • Dentro dessa pasta recém criada, crie um arquivo chamado loginsnowflake.html. Nesse arquivo crie o fragmento de conteúdo HTML que será inserido na página de login. O conteúdo do arquivo loginsnowflake.html será literalmente inserido dentro do HTML final da página de login, dentro de uma tag <DIV>. Portanto, não poderá conter as tags <HTML>, <BODY> ou <HEAD>.

  • Opcionalmente, crie na mesma pasta um arquivo chamado loginhead.html. Nesse arquivo crie o conteúdo HTML que importa os CSS que serão utilizados pela personalização. O conteúdo do arquivo loginhead.html será literalmente inserido dentro do HTML final da página de login, dentro da tag <HEAD>, portanto deverá conter apenas tags que importam recursos como CSS.

  • Opcionalmente, crie na mesma pasta um arquivo chamado loginscript.html. Nesse arquivo crie o conteúdo HTML que importa os JS que serão utilizados pela personalização. O conteúdo do arquivo loginscript.html será literalmente inserido dentro do HTML final da página de login, ao final da tag <BODY>, portanto deverá conter apenas tags que importam recursos como JS.


A configuração com o arquivo loginscript.html foi adicionada na atualização Update 1.7.0-210504. Caso esteja uma atualização anterior, como paliativo o JS pode ser importado no arquivo loginhead.html, no entanto podem ocorrer inconsistências no login via mobile (aplicativo My Fluig).




  • Caso utilize recursos estáticos, copie-os dentro desta mesma pasta, como arquivos JS, CSS e imagens. Esses recursos estáticos estarão acessíveis abaixo da URL /portal/resources/customlogin/.



  • Caso utilize o aplicativo Mobile, a personalização do login via Mobile pode ser feita da mesma forma. Basta criar os arquivos mlogin.html, mloginscript.html e mloginhead.html.



  • Reinicie os serviços do fluig.


Sempre que houver o login personalizado na empresa, ao acessar a plataforma pelo navegador do dispositivo mobile, esta página de login será respeitada e será apresentada no momento de realizar a autenticação.

Caso ocorra alguma mudança de domínio do sistema Fluig em ambiente Cloud, e caso este sistema possua tela de login personalizada para o My Fluig (aplicação mobile), pode haver alguns impactos na auntenticação através do aplicativo. 

Para resolver essa situação, deve-se atualizar a tabela fdn_oauthprovider informando a nova url que está sendo utilizada pela plataforma.


Exemplo de personalização

Primeiramente foram criados os arquivos descritos acima em "[diretório_instalação]/repository/wcmdir/customlogin/". Em seguida foram executados os seguintes procedimentos:

1. Importe o arquivo JavaScript customizado loginsnowflake.js e o arquivo de estilo loginsnowflake.css.

<link rel="stylesheet" type="text/css" href="/portal/resources/customlogin/loginsnowflake.css">
<script type="text/javascript" src="/portal/resources/customlogin/loginsnowflake.js"></script>

2. Insira aqui o código HTML de customização da sua página.

<h1 id="login_datetime"></h1>

Todo conteúdo HTML deve seguir as normas do Style Guide (definidas aqui: https://style.fluig.com/).

3. O arquivo js, ao terminar de carregar a página, insere a data atual no elemento "login_datetime" 

$(document).ready(function(){
   var today = new Date();
   var dd = today.getDate();
   var mm = today.getMonth()+1;
   var yyyy = today.getFullYear();
   if(dd<10) {
       dd='0'+dd
   }
   if(mm<10) {
       mm='0'+mm
   }
   today = dd + '/' + mm + '/' + yyyy;
   $("#login_datetime").html("Data: " + today);
})

4. O arquivo css deve conter as classes de personalização do seu HTML.

#login_datetime {
	position: absolute;
    text-align: center;
    width: 100%;
    left: 0px;
    bottom: 10%;
}


Resultado:

Exibição de data na parte inferior da tela.