Socialid.login.renderConnectWidget
Renato.neves (Talk | contribs) (→Description) |
Dirceu.tiegs (Talk | contribs) m |
||
Line 41: | Line 41: | ||
! align="left" width="200px" style="padding-left: 20px" | providers | ! align="left" width="200px" style="padding-left: 20px" | providers | ||
| width="200px" | opcional | | width="200px" | opcional | ||
− | | Array contendo um ou mais provedores disponíveis para os usuários fazerem login. Atualmente são suportados: "facebook", "twitter" | + | | Array contendo um ou mais provedores disponíveis para os usuários fazerem login. Atualmente são suportados: "facebook", "twitter", "linkedin" e "gplus". Default: [] (nenhum provedor). |
|+ | |+ | ||
! align="left" width="200px" style="padding-left: 20px" | language | ! align="left" width="200px" style="padding-left: 20px" | language | ||
Line 62: | Line 62: | ||
== Example == | == Example == | ||
− | Renderiza em "socialid_connect_container" um widget do Social Connect em português ("pt_br"), com Facebook, Twitter | + | Renderiza em "socialid_connect_container" um widget do Social Connect em português ("pt_br"), com Facebook, Twitter, LinkedIn e Google+ disponíveis para serem adicionados como nova conexão ao usuário logado atualmente no Social Login: |
socialid.login.init(1); | socialid.login.init(1); | ||
socialid.login.renderConnectWidget("socialid_connect_container", { | socialid.login.renderConnectWidget("socialid_connect_container", { | ||
theme: "bricks", | theme: "bricks", | ||
− | providers: ["facebook", "twitter", "linkedin"], | + | providers: ["facebook", "gplus", "twitter", "linkedin"], |
language: "pt_br", | language: "pt_br", | ||
showSocialIdLink: true, | showSocialIdLink: true, |
Revision as of 08:30, 4 August 2014
Contents |
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", "linkedin" e "gplus". 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, LinkedIn e Google+ 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", "gplus", "twitter", "linkedin"], language: "pt_br", showSocialIdLink: true, loadCss: true });
Teste os parâmetros em nosso playground: https://sid-examples.herokuapp.com/social_logins/playground