apitdn/fluig_rag_docs/Plataforma Documentação técnica/Recurso de Comunidades (Social)/Componentes de Publicação.md

title, source, path

title	source	path
Componentes de Publicação	https://tdn.totvs.com/pages/viewpage.action?pageId=150635531	\Plataforma Documentação técnica\Recurso de Comunidades (Social)\Componentes de Publicação.md

Índice

• 1 Social Poster - Componente de Publicação
• 2 Bind de elementos HTML a funções
  • 2.1 Exemplo de um bind da função salvar em um botão
• 3 Funções do componente
  • 3.1 loadSocialPoster(alias)
  • 3.2 getDocumentEnabled(alias, cb)
  • 3.3 findSocialVOByAlias(alias, cb)
  • 3.4 getSocialUserLogged(cb)
  • 3.5 isSocialMember(alias, cb)
  • 3.6 serviceSocialVOByAlias(alias, cb)
  • 3.7 serviceSocialUserLogged(cb)
  • 3.8 serviceSocialMember(alias, cb)
  • 3.9 serviceSocialDocumentEnabled(alias, feature, cb)
  • 3.10 serviceCreatePost(options, cb)
  • 3.11 baseAjax(url, options, cb)
  • 3.12 preventXSS(str)
  • 3.13 mentions()
  • 3.14 resetMentions()
  • 3.15 shareTextFocus(el, ev)
  • 3.16 closePostShare(el, ev)
  • 3.17 shareTextBlur(el, ev)
  • 3.18 shareTextInput()
  • 3.19 shareTextKeyUp(el, ev)
  • 3.20 placeholderIE()
  • 3.21 resetCountText()
  • 3.22 postFormSubmit(el, ev)
  • 3.23 resetPostContent(el)
  • 3.24 postCreate()
  • 3.25 selectImageOpen()
  • 3.26 selectImageDone(event, data)
  • 3.27 thumbURL(documentId, version)
  • 3.28 selectVideoOpen()
  • 3.29 selectVideoDone(event, data)
  • 3.30 selectDocumentOpen()
  • 3.31 selectDocumentDone(event, object)
  • 3.32 removeAttachedMedia(el, ev)
  • 3.33 attachMedia(el, ev)
  • 3.34 attachType(el)

Social Poster - Componente de Publicação

A Social Poster é um componente de publicação que possibilita a criação de um post, no qual é possível anexar uma imagem, vídeo ou um documento.

Bem como todos os componentes da camada social do TOTVS Fluig Plataforma, a Timeline utiliza o facilitador SuperWidget na camada de Javascript. Para saber mais sobre o funcionamento, consulte o manual Super Widget

Bind de elementos HTML a funções

Para associar um evento a um elemento HTML, é preciso seguir o formato abaixo.

O componente HTML deve possuir um atributo data- o qual receberá o bind de funções da widget.

Exemplo de um bind da função salvar em um botão

No HTML

<button data-salvar-dados>Salvar dados</button>

No arquivo .js da widget

bindings: {
    local: {
        'salvar-dados': ['click_salvarDados']
    }
 },

//implementação da função salvar
salvarDados: function(el, ev) {
    //escreva a ação do botão salvar-dados aqui
}, ...

A função atribuída a um elemento HTML possui 2 parâmetros:

• el: Representa o próprio botão. No caso do exemplo: Salvar dados
• ev: representa o objeto do evento disparado

Note que não é necessário adicionar o prefixo data-.

O array atribuído é uma string no padrão EVENTO_FUNÇÃO.

Várias combinações de evento x função podem ser atribuídos a um único elemento.

Os bindings feitos no objeto local são referentes a elementos HTML dentro do div da widget. E os binds feitos no objeto global são para elementos fora do div da widget, ou retirados do div da widget por outro script, como é o caso das modais do jQueryUI.

Funções do componente

Segue abaixo o detalhamento das funções da Social Poster:

Função	Descrição
loadSocialPoster(alias)	Esta função centraliza todos os serviços necessários para o carregamento da página, monta um objeto 'view' que é renderizado via Mustache. Mustache é uma especificação de templates que não utiliza lógica, ou seja, não possui declarações com if, for, while etc, toda sua construção é baseada em tags.
getDocumentEnabled(alias, cb)	Função para verificar se a pasta para cada tipo de recurso está habilitada. Realiza uma chamada REST e recupera os dados da comunidade que são passados para uma "callback". Os tipos verificados são: DOCUMENT, GALLERY_PHOTO e GALLERY_VIDEO.
findSocialVOByAlias(alias, cb)	Retorna um objeto 'social' de acordo com o alias. Realiza uma chamada REST e recupera os dados "social" que são passados para uma "callback". Pode ser um usuário ou uma comunidade.
getSocialUserLogged(cb)	Retorna o usuário logado. Realiza uma chamada REST e recupera os dados do usuário logado que são passados para uma "callback".
isSocialMember(alias, cb)	Retorna um objeto com informação se o usuário é membro da comunidade. Realiza uma chamada REST e recupera informação se o usuárioé membro da comunidade e é passado para uma "callback".
isSocialDocumentEnabled(alias, feature, cb)	Retorna objeto com informação se um recurso está habilitado. Realiza uma chamada REST e recupera os dados do recurso de acordo com o 'feature' e é passado para uma "callback". Os tipos de 'feature' são: DOCUMENT, GALLERY_PHOTO e GALLERY_VIDEO.
serviceSocialVOByAlias(alias, cb)	Realiza uma chamada REST (API Publica) e recupera os dados sociais.
serviceSocialUserLogged(cb)	Realiza uma chamada REST (API Publica) e recupera os dados do usuário logado.
serviceSocialMember(alias, cb)	Realiza uma chamada REST (API Publica) e recupera os dados que retornam informação se um usuário é membro de uma comunidade.
serviceSocialDocumentEnabled(alias, feature, cb)	Realiza uma chamada REST (API Publica) e recupera os dados de pastas de uma comunidade.
serviceCreatePost(options, cb)	Realiza uma chamada REST (API Publica) que envia dados para criação de um post.
baseAjax(url, options, cb)	Facilitador de uso do ajax
preventXSS(str)	Função que utiliza uma expressão regular que sobrescreve sinais de 'maior' e 'menor'.
mentions()	Função que aplica plugin 'mentionsInput' utilizado para 'menção' de usuários ou comunidades.
resetMentions()	Função que 'limpa' plugin 'mentionsInput'.
shareTextFocus(el, ev)	Ação do elemento data-post-share-text. Realiza tratamento quando área de post recebe foco.
closePostShare(el, ev)	Ação do elemento data-close-post-share Realiza tratamento ao fechar área de post.
shareTextBlur(el, ev)	Ação do elemento data-post-share-text. Realiza tratamento quando área de post recebe foco.
shareTextInput()	Ação do elemento data-post-share-text. Realiza tratamento quando área de post recebe foco.
shareTextKeyUp(el, ev)	Ação do elemento data-post-share-text. Realiza tratamento quando área de post recebe foco.
placeholderIE()	Realiza tratamento para criação de 'placeholder' para o navegador internet explorer.
resetCountText()	Realiza verificação da quantidade de caracteres digitadas no campo de post.
postFormSubmit(el, ev)	Ação do elemento data-post-share-form. Realiza a recuperação dos dados do post para criá-lo.
resetPostContent(el)	Ação que faz limpeza de todos os dados informados para criação do post.
postCreate()	Associa funções a eventos relacionados a recursos que podem ser incluídos no post. (Documentos, fotos e vídeos)
selectImageOpen()	Função que permite selecionar uma imagem de uma galeria.
selectImageDone(event, data)	Ação disparada pelo evento "selectImageEvent", que notifica a socialposter para adicionar imagem selecionada no campo de post.
thumbURL(documentId, version)	Função que faz a montagem do endereço de requisição de um documento de acordo com seu 'Id' e 'versão'.
selectVideoOpen()	Função que permite selecionar um vídeo de uma galeria.
selectVideoDone(event, data)	Ação disparada pelo evento "selectVideoEvent", que notifica a socialposter para adicionar vídeo selecionado no campo de post.
selectDocumentOpen()	Função que permite selecionar um documento da comunidade, do repositório e permite ainda que um documento seja enviado.
selectDocumentDone(event, object)	Ação disparada pelo evento "selectDocumentEvent", que notifica a socialposter para adicionar documento selecionado no campo de post.
removeAttachedMedia(el, ev)	Ação que faz tratamento para remoção de um recurso que foi adicionado.
attachMedia(el, ev)	Ação do elemento data-attach-media, responsável por identificar o tipo de anexo.
attachType(el)	Função que verifica tipo de anexo e delega para função específica para o tratamento necessário.