Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

  1. Acessar o modo de edição da página;
  2. Assinalar quais widgets da página serão apresentadas no aplicativo mobile, clicando no ícone Habilitar no aplicativo mobile. Este ícone só estará presente para widgets que possuam suporte ao aplicativo mobile;
      Quais são as widgets que nesse momento suportam? Detalhar aqui.
      Adicionar imagem de configuração habilitando widget para mobile. A imagem deve ter um exemplo real de aplicação da widget.
      1. As Widgets com compatibilidade para o aplicativo Mobile são:
        1. Editor de Conteúdo
        2. Documentos Populares
        3. Endereço WEB
        4. Analytics
        5. kit aniversariantes
        6. Visualização de Artigos
      2. Para habilitar a widget no aplicativo mobile, acessar o mode de edição de página, adicionar a widget desejada e clicar no ícono conforme a imagem:
        1. Image Added
    1. Publicar a nova versão da página. 

    Caso tenha pelo menos uma instância de Widget habilitada para o aplicativo mobile no momento da publicação da nova versão da página, ela ficará disponível para o aplicativo mobile, caso contrário não ficará disponível.

    A definição de que uma widget possui suporte ao aplicativo mobile é feita através da propriedade booleana application.mobileapp presente no arquivo application.info (Arquivo localizado dentro da widget). Esta propriedade será adicionada pelo desenvolvedor da widget, e caso não seja informada irá assumir o valor padrão: false. Não há necessidade de chegar neste detalhe neste momento.A renderização das páginas no aplicativo mobile será enxuta, apresentando apenas o conteúdo das widgets habilitadas sequencialmente, conforme exemplo abaixo:

    O conteúdo abaixo será abordado na página Desenvolvimento de widgets Mobile.

    [No aplicativo do fluig os widgets ficarão disponíveis  de três formas:

    • Home: Será a primeira opção do menu principal do aplicativo, onde serão renderizadas todos widgets mobile da home da plataforma fluig. Além disso, será  possível deixar a "Home" como a tela inicial do aplicativo se ela possuir widgets mobile e um parâmetro no tenantData de acordo com a documentação: Personalização da tela inicial mobile.
    • Páginas:  Também será uma opção no menu principal do aplicativo que direcionará para uma listagem de todas as páginas por default apresentará apenas as páginas disponíveis para o mobile, porém existirá a opção de mostrar todas as páginas acionando o filtro. Ao acessar uma página será apresentada todos os widgets disponíveis para o mobile e terá uma opção para acessar as sub-páginas (caso existam).
    • Comunidades: Ao acessar uma comunidade o usuário terá acesso os widgets mobile daquela comunidade através de um item em destaque na tela ou pelo menu contextual.

    Os widgets devem ser responsivos para melhor visualização no mobile, por isso é recomendado a utilização de  componentes do fluig Style Guide no seu desenvolvimento.  De qualquer forma, a responsabilidade pelo desenvolvimento do widget ou adequação para o mobile é de inteira responsabilidade do cliente para widgets desenvolvidas por ele.  ]

    Este conteúdo deve ser elaborado para o cliente que quer criar uma widget para suporte no mobile.

    Neste caso percebi que é o mesmo conteúdo da especificação que deve ser ajustado.

    Sugestão, detalhar melhor a aplicação recurso para o cliente, conforme exemplo feito para Como criar um Widget que busque conteúdo, neste caso voltado para a explicação do que o usuário precisa configurar na widget, com exemplo de código fonte e se possível imagens.

    Acredito que se refere a evoluir o item 'Desenvolvimento de widgets' abaixo.

    Definições Técnicas

    Opção Mobile para páginas

    Será adicionado o atributo booleano enabledMobileApp na entidade WCMPageVersion para controlar a disponibilidade da página no aplicativo mobile e a opção Exibir página no aplicativo mobile (somente leitura) no formulário de cadastro de páginas.

    O valor do atributo enabledMobileApp será atribuído no momento da publicação de uma nova versão da página, assumindo o valor true quanto existir pelo menos uma instância de Widget habilitada para o aplicativo mobile na página, e o valor false quanto não existir nenhuma instância de Widget habilitada para o aplicativo mobile.

    Opção Mobile para widgets

    Será adicionado o atributo booleano mobileAppWidget na entidade WCMWidget. O valor do atributo mobileAppWidget será atribuído durante o processo de deploy da Widget de acordo com o valor da propriedade application.mobileapp presente no arquivo application.info (Arquivo localizado dentro da widget), caso não for encontrada a propriedade irá assumir o valor padrão false

    Será adicionado o atributo booleano enabledMobileApp na entidade WCMPageWidget e o ícone Habilitar no aplicativo mobile no modo de edição da Widget, sendo apresentado somente para as instâncias de uma Widget com suporte ao aplicativo mobile.

    Renderizador para o Aplicativo Mobile

    Para a renderização de páginas e widgets no aplicativo mobile será adicionado o método renderMobileAppPage na interface PageRenderer. Este método será invocado pelo RequestPipeline quando o header User-Agent da requisição possuir um product identifier igual a FluigApp/{fluig_app_version}.

    A implementação do método renderMobileAppPage utilizará o template mobileapp-master.ftl, que será uma versão simplificada do master.ftl. Este template apresentará somente o conteúdo das instâncias de widgets que possuem o atributo enabledMobileApp igual a true, de forma sequencial, sem apresentar o título padrão da Widget e desconsiderando o layout definido para a página em questão.

    A autentificação no fluig deve ser feita através do protocolo OAuth v1.0a (conforme já é realizado pelo aplicativo mobile para requisições na API do fluig).

    Desenvolvimento de Widgets


    Como criar um Widget com suporte a dispositivos mobile

    Para o desenvolvimento de Widgets com suporte à dispositivos mobile deve ser adicionado a propriedade application.mobileapp no arquivo application.info com o valor true (Arquivo application.info está localizado dentro da widget)Este propriedade será processada durante o processo de deploy da Widget.

    Incluir a propriedade no application.info.

    • application.mobileapp=true

    Desenvolvimento de widgets Mobile.

     Para o desenvolvimento de Widgets será adicionado o suporte à propriedade application.mobileapp no arquivo application.info (Arquivo localizado dentro da widget) para que o desenvolvedor possa determinar se a Widget pode ser renderizada no aplicativo mobile. Este propriedade será processada durante o deploy da Widget pelo DeploymentServiceBean.

    Será adicionado a variável booleana mobileAppMode no template do FreeMarker que determinará se a Widget está sendo renderizada através de uma requisição do aplicativo mobile. O fluig irá verificar o header User-Agent da requisição e caso seja oriundo do aplicativo mobile o valor da variável mobileAppMode será true. Através desta variável o desenvolvedor poderá modificar o comportamento da Widget quando renderizada pelo aplicativo mobile. O valor da variável mobileAppMode também estará disponível via JavaScript através do método WCMAPI.isMobileAppMode().

     

     Exemplo de utilização:

    Bloco de código
    languagejs
    themeRDark
    if (WCMAPI.isMobileAppMode()) {
        this.DOM.find('a').attr('href', '#');
    }

    API Pública

    Será disponibilizado um novo Está disponível serviço na API Pública (Será? já não foi disponibilizado? ql é o serviço) para realizar a consulta de páginas do fluig. Esta consulta retornará somente as páginas que o usuário tenha permissão de visualização. O retorno do serviço será paginado com uma lista de PageVOs contendo as informações das páginas, entre elas a URL de acesso, URL do ícone, páginas filhas (quando houverem) e se está disponível para o aplicativo mobile. Será possível informar os seguintes filtros:

    • parentPageCode: Código da página pai. Quando informado, retorna somente as páginas filhas da página informada.
    • mobileisMobile: Caso informado true retorna somente as páginas disponíveis para o aplicativo mobile.
    • pageIndex: Caso informado, será o index da página a ser exibida
    • pageSize: Caso informado, definirá a quantidade de registros por página.
    • searchLevel: Caso informado, busca hierarquicamente as páginas filhas .
    • internalPages: Caso informado true, a consulta de páginas resultará somente em paginas internas da plataforma.
    • filter: String para filtrar o dados em caso de busca.

    ...

    Qualquer tipo a autenticação requerido pela widget é de inteira responsabilidade do servidor do fluig (SSO, por exemplo), o mobile é apenas responsável por mostrar o HTML retornado pelo servidor no webview.

     

    Telas de configuração

    Image Removed