JavaScript SDK – Configuração avançada

Leia o nosso guia de início rápido para saber como carregar e inicializar o SDK do Facebook para JavaScript. O início rápido usa padrões comuns para as opções disponíveis na inicialização do SDK. No entanto, você pode personalizar algumas dessas opções.

Como mudar o idioma

No trecho básico de configuração, a versão en_US do SDK é inicializada, o que significa que todos os botões e plugins gerados pelo Facebook usados no seu site estarão em inglês dos EUA. No entanto, os diálogos pop-up gerados pelo Facebook, como o diálogo Entrar, aparecem no idioma que a pessoa escolheu no Facebook, mesmo que seja diferente do que você selecionou. Você pode mudar o idioma alterando o valor src no trecho. Consulte Localização para ver os idiomas que podem ser usados. Por exemplo, caso o site esteja em espanhol, o uso do código a seguir para carregar o SDK fará com que todos os Plugins Sociais sejam exibidos em espanhol.

<script async defer crossorigin="anonymous" src="https://connect.facebook.net/es_LA/sdk.js"></script> 

Verificação do status de login

Se você definir status como true na chamada FB.init(), o SDK tentará obter as informações sobre o usuário atual imediatamente após a inicialização. Isso pode reduzir o tempo necessário para verificar o estado de um usuário conectado se você usar o Login do Facebook, mas não é útil para páginas que só têm plugins sociais.

É possível usar FB.getLoginStatus para obter o estado de login de uma pessoa. Continue a ler para mais informações sobre como usar o Login do Facebook com o SDK do JavaScript.

Como desativar a análise XFBML

Com xfbml definido como true, o SDK analisa o DOM da sua página para encontrar e inicializar plugins sociais que tenham sido adicionados usando XFBML. Se você não estiver usando plugins sociais na página, definir xfbml como false melhorará o tempo de carregamento da página. Saiba mais sobre isso em Plugins Sociais.

Como acionar o código quando o SDK carregar

A função atribuída a window.fbAsyncInit é executada assim que o SDK termina o carregamento. Qualquer código que você queira executar depois de carregar o SDK deve ser colocado nessa função e depois da chamada para FB.init. É possível usar qualquer tipo de JavaScript aqui, mas todas as funções de SDK devem ser chamadas após FB.init.

Como depurar

Para melhorar o desempenho, o SDK do JavaScript é carregado minificado. Você também pode carregar uma versão de depuração do SDK do JavaScript que inclui mais registros e verificação de argumentos mais rigorosa, além de não ser minificado. Para isso, altere o valor de src no código de carregamento para isto:

src="https://connect.facebook.net/en_US/sdk/debug.js"

A versão de depuração não deve ser usada no ambiente de produção, uma vez que a carga dela é maior e prejudica o desempenho da sua página.

Mais opções de inicialização

O documento de referência para a função FB.init fornece uma lista completa das opções de inicialização disponíveis.