SDK для JavaScript: расширенная настройка

Прочтите наше руководство по началу работы и узнайте, как загрузить и инициализировать Facebook SDK для JavaScript. Для параметров, доступных на момент инициализации SDK, в руководстве используются значения по умолчанию, но вы можете настроить некоторые из них.

Поддерживаемые браузеры

Facebook SDK для JavaScript поддерживает по две последние версии самых популярных браузеров: Chrome, Firefox, Edge, Safari (в том числе на устройствах с iOS) и Internet Explorer (только версия 11).

Изменение языка

В базовом фрагменте кода для настройки инициализируется версия SDK en_US. Это означает, что все генерируемые Facebook кнопки и плагины на вашем сайте будут на американском английском. Исключение составляют генерируемые Facebook всплывающие диалоги (например, диалог входа). Они будут представлены на языке, который пользователь выбрал на Facebook, даже если вы указали другой язык. Чтобы изменить язык, укажите нужное значение src. Список доступных языков и регионов можно найти в статье о локализации. Например, если вы разработали сайт с интерфейсом на испанском языке и хотите, чтобы все социальные плагины тоже отображались на испанском, используйте при загрузке SDK следующий код:

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

Проверка статуса входа

Если в вызове FB.init() задать для параметра status значение true, SDK попытается получить информацию о текущем пользователе сразу после инициализации. Это позволяет быстрее проверить статус пользователя, авторизованного с помощью входа через Facebook, но этот способ неудобен для страниц, на которых содержатся только социальные плагины.

Чтобы получить статус входа пользователя, используйте FB.getLoginStatus. Подробнее об использовании входа через Facebook с SDK для JavaScript см. в этом разделе.

Отключение анализа XFBML

Если для xfbml установлено значение true, SDK проанализирует модель DOM на вашей странице и инициализирует социальные плагины, добавленные с использованием XFBML. Если вы не используете на странице социальные плагины, установите для xfbml значение false, чтобы ускорить загрузку. Подробнее об этом см. в разделе Социальные плагины.

Запуск кода при загрузке SDK

Функция, назначенная window.fbAsyncInit, запускается сразу же после загрузки SDK. Если вы хотите выполнить какой-то код после загрузки SDK, поместите его в эту функцию после вызова FB.init. Здесь можно использовать любой код JavaScript, но все функции SDK можно вызывать только после FB.init.

Отладка

Чтобы повысить производительность, SDK для JavaScript загружается в минифицированном виде. Для отладки можно загрузить неминифицированную версию SDK для JavaScript, в которой используется больше уровней журналов и более строгая проверка аргументов. Чтобы это сделать, замените значение src в коде загрузки следующим образом:

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

Версию для отладки не следует использовать для полноценной работы. Ее полезная нагрузка больше, что негативно скажется на производительности страницы.

Другие параметры инициализации

В справке по функции FB.init приведен полный список доступных параметров инициализации.