Socialid.login.renderConnectWidget
Renato.neves (Talk | contribs) (→Description) |
Renato.neves (Talk | contribs) (→Description) |
||
Line 14: | Line 14: | ||
O funcionamento do widget é assim: | 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 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 [[ | + | * se não há um usuário logado no momento, um novo login é feito (mesmo comportamento do widget de [[socialid.login.renderLoginWidget|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. | 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. |
Revision as of 13:33, 18 March 2013
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.onLoginSuccess
- socialid.events.onConnectCancel
- socialid.events.onConnectError
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