Socialid.login.renderConnectWidget

Description

Renderiza o widget do Social Connect dentro de um elemento do DOM.

O uso deste widget pode disparar os eventos:

• socialid.events.onConnectStart
• socialid.events.onConnectSuccess
• socialid.events.onConnectCancel
• socialid.events.onConnectError
• socialid.events.onLoginSuccess
• socialid.events.onDisconnectSuccess
• socialid.events.onDisconnectError

Este widget permite adicionar credenciais de múltiplas redes sociais a um mesmo usuário do Social Login. Por exemplo, o usuário pode logar com o Facebook e adicionar sua credencial do Twitter, desta forma nas próximas vezes que ele logar no website com o Social Login integrado ele poderá escolher em usar tanto o Facebook como o Twitter.

O funcionamento do widget é assim:

• se há um usuário logado no momento, a nova credencial é adicionada a este usuário e o evento de socialid.events.onConnectSuccess é disparado.
• se não há um usuário logado no momento, um novo login é feito (mesmo comportamento do widget de login) e o evento de socialid.events.onLoginSuccess é disparado.

Portanto, é importante gerenciar estes dois eventos. No caso do socialid.events.onLoginSuccess torna-se importante checar o token via server-side para certificar que o usuário logado é o mesmo associado à sessão atual do website.

Usage

 socialid.login.renderConnectWidget(containerId, options)

Parameters

containerId	obrigatório	id do elemento DOM onde será inserido o widget
options	opcional	um objeto contendo parâmetros adicionais
theme	opcional	Pode ser "icons", "bricks" ou "labeled_icons". Especifica que tema será usado para montar o widget. Default: "icons".
providers	opcional	Array contendo um ou mais provedores disponíveis para os usuários fazerem login. Atualmente são suportados: "facebook", "twitter" e "linkedin". Default: [] (nenhum provedor).
language	opcional	Pode ser "pt_br" ou "en". Define que tradução será usada nos widgets. Default: "en".
showSocialIdLink	opcional	Pode ser true ou false (boolean). Especifica se o link "Powered by Social-ID NOW" será automaticamente mostrado ou não. Default: true.
loadCss	opcional	Pode ser true ou false (boolean). Especifica se o arquivo CSS de temas será automaticamente inserido no documento como um <link>. Default: true.
cssUrl	opcional	Especifica a url do arquivo CSS de temas que será automaticamente inserido no documento como um <link> caso loadCss seja true. Default: "https://app.socialidnow.com/assets/api/themes.css".

Example

Renderiza em "socialid_connect_container" um widget do Social Connect em português ("pt_br"), com Facebook, Twitter e LinkedIn disponíveis para serem adicionados como nova conexão ao usuário logado atualmente no Social Login:

 socialid.login.init(1);
 socialid.login.renderConnectWidget("socialid_connect_container", {
   theme: "bricks", 
   providers: ["facebook", "twitter", "linkedin"],
   language: "pt_br",
   showSocialIdLink: true,
   loadCss: true
 });

Teste os parâmetros em nosso playground: https://sid-examples.herokuapp.com/social_logins/playground