Konviva | Configurando a Nova Home (JSON)
ATENÇÃO: esta configuração está disponível apenas para o suporte, caso deseje realizar alguma alteração na sua home você deverá abrir um chamado.
É possível realizar alterações no layout da na nova home do aluno, através do configurador geral. O layout é configurado a partir de um JSON.
Para acessar a configuração, navegue até o menu Administração>Configurador Geral>Home, e escolha a opção 'Home Nova'. Abaixo do template 1, você verá um JSON editável :
Recomenda-se utilizar um validador de JSON, como o jsonlint.com.
Estrutura
O Json sempre começará com "{" e terminará com "}" para que seja válido. As propriedades do JSON precisarão ser compatíveis com o HTML do tema também. Cada funcionalidade(Destaque, catálogo e etc), deverá ter propriedades diferentes.
Exemplo básico da estrutura com algumas propriedades :
{"bloco":[{"title":"Titulo","subtitle":"Subtitulo","btnTitle":"Nome do botão","template":"caminho do html no tema","codigoCategoria":"código obtido através da url da catégoria do catálogo","mostrarTrilhaCompleta":"true ou false","card":{"btnTitle:"Titulo do botão","requerid":"true ou false","score":"true ou false","title":"true ou false","description":"true ou false","date":"true ou false","progress":"true ou false","rating":"true ou false","listInfo":"true ou false","fileType":"true ou false","flag":"true ou false"}}]}
Blocos
Os blocos são as partes do layout. Na home do aluno, o layout é dividido em 2 blocos :
"geral" - Aqui você pode inserir as informações de Cursos, Trilhas, Biblioteca e Catálogo
"destaque" - Geralmente usado para inserir informações dos destaques;
Template
A propriedade que define a visualização da funcionalidade é o "template". Nesta propriedade, será atribuída o caminho da função no tema :
- Destaques - "template":"portal/views/home/includes/destaques-include.tpl.html"
- Cursos em andamento - "template":"portal/views/home/includes/cursos-include.tpl.html"
- Catálogo - "template":"portal/views/home/includes/catalogo-include.tpl.html"
- Minhas Trilhas - "template":"portal/views/home/includes/trilhas-include.tpl.html"
- Favoritos - "template":"portal/views/home/includes/favoritos-include.tpl.html"
- Pílulas - "template":"portal/views/home/includes/pilulas-include.tpl.html"
- Biblioteca - "template":"portal/views/home/includes/biblioteca-include.tpl.html"
- Cursos Obrigatórios - "template":"portal/views/home/includes/cursos-obrigatorios-include.tpl.html"
- Sugeridos para você - "template":"portal/views/home/includes/sugeridos-interesses-include.tpl.html"
- Recomendações de Cursos - "template":"portal/views/home/includes/sugeridos-cursos-include.tpl.html"
Propriedades
As funcionalidades não serão sempre descritas iguais no JSON. Algumas funcionalidades terão o seu comportamento especifico, por exemplo:
O catálogo só irá aparecer se você incluir a propriedade "codigoCategoria", com um código válido. Já os destaques não possuem este código, então não é necessário colocar. As propriedades do card serão sempre as mesmas. As funcionalidades com propriedades únicas serão o Catálogo, Minhas Trilhas e Cursos em andamento.
Catálogo: "codigoCategoria": 1
Diferente dos outros campos, o valor da propriedade código não terá aspas. Você pode pegar esse código entrando em um catálogo como Administrador e pegando o codCategoria no final da URL :
Minhas Trilhas: "mostrarTrilhaCompleta": "valor"
O valor será atribuído com true ou false.
Cursos em andamento : "mostrarCarrosselVazio": "valor"
O valor será atribuído com true ou false.
Na prática
Com todas as informações acima, agora é possível configurar a home nova.
Este é o layout da home sem nenhum card adicionado. Com o um editor de texto, ou validador de JSON aberto, iniciaremos a população dos cards.
Utilizando o editor do site JSON Online Validator and Formatter - JSON Lint, inserir as informações de destaque :
Agora é só copiar e colar no configurador geral :
Esta será a visão do layout do aluno :
A partir dai, é necessário criar um novo bloco para inserir as informações de cursos, trilhas e etc. Como exemplo, irei adicionar ao arquivo JSON o novo bloco com as informações do catálogo código 14:
Após inserir no configurador geral, esta será a visão do aluno :