Índice

Objetivo

Este guia é destinado aos desenvolvedores internos e externos da plataforma que desejam utilizar o componente Compartilhar. O objetivo é apresentar o seu funcionamento e o detalhamento de todos os parâmetros de configuração.

Pré-requisitos

• Conhecer os conceitos dos componentes de negócio do TOTVS Fluig Plataforma, disponíveis na página Componentes de Negócio.

Compartilhar

O componente Compartilhar tem como objetivo facilitar o processo de compartilhamento de conteúdo encapsulando todas as configurações básicas necessárias para o compartilhamento, restando para o desenvolvedor somente configurar o plugin.

Estrutura Básica

A seguir é apresentada a estrutura básica do componente:

SOCIALBC.share(target, config);

O componente recebe dois parâmetros:

• o primeiro, um objeto target que pode ser um objeto ou uma string;
• e o segundo as configurações para o componente.

O primeiro parâmetro espera um objeto ou uma string:

// Pode ser um objeto resultante de um seletor jquery:
var obj = $('#meu_seletor');
 
// Pode ser uma string de um seletor jquery:
var obj = '#meu_seletor';

O segundo parâmetro espera um objeto com os valores: showOnlyLink, sourceType, type, preview, link e paramId.

{
    showOnlyLink: "exibe apenas o link ex.:true or false,"
    sourceType: "tipo ex.:SOCIABLE,"
    type: "tipo do conteúdo ex.:POST,"
    preview: "uma miniatura do conteúdo que será compartilhado,"
    link: "url para acessar o recurso,"
    paramId: "id social"
}

Utilização Básica

A utilização básica do componente é apresentada a seguir:

SOCIALBC.share('#seletor', {
    showOnlyLink: false,
    sourceType: 'SOCIABLE',
    type: 'POST',
    preview: '<div>Miniatura</div>',
    link: 'http://servidor/portal/p/1/post/usuario/12',
    paramId: 12
});

No application.info de seu widget, adicione o componente como dependência:

application.resource.component.2=social/socialshare

Tela exibida ao chamar o componente

Tela exibida ao selecionar a opção compartilhar

Mensagem exibida ao selecionar a opção copiar link

Tela exibida ao selecionar a opção compartilhar quando não existe o Flash no navegador