Как настроить приложение для чтения RSS-лент Facebook для вашего блога

Версия 1.0
Автор: Фалко Тимме

Этот гид показывает, как вы можете создать приложение для чтения RSS-лент для социальной сети Facebook, которое будет отображать RSS-ленту вашего блога/веб-сайта на страницах профилей пользователей Facebook (которые установили приложение для чтения RSS-лент). Каждый элемент RSS-ленты будет иметь кнопку «Поделиться», чтобы люди могли поделиться историей со своими друзьями, а приложение будет иметь ссылку «Пригласить», чтобы люди могли пригласить до десяти друзей сразу установить это приложение для чтения лент. Я буду использовать PHP5 для создания приложения для чтения RSS-лент. Для разбора RSS-ленты и генерации HTML из нее я буду использовать Magpie RSS.

Вы можете увидеть это приложение в действии, установив HowtoForge RSS Feed Reader для Facebook.

Этот документ предоставляется без каких-либо гарантий! Я не даю никаких гарантий, что это будет работать для вас!

1 Предварительная заметка

Этот гид основан на реальном примере, HowtoForge RSS Feed Reader для Facebook, и я буду использовать реальные URL и скрипты в этом примере (заменяя только секретные данные, такие как API-ключ и Секрет).

Как я уже упоминал, я использую PHP5 для создания этого приложения, используя библиотеку PHP-клиента Facebook. Теоретически вы также можете использовать PHP4, но клиентская платформа оптимизирована для PHP5, поэтому вам следует использовать его, если это возможно.

Я использую хост fb.howtoforge.com в этом примере для размещения приложения; это веб-сайт, поддерживающий PHP5.

Прежде чем вы сможете начать писать свое собственное приложение для Facebook, вы должны зарегистрироваться на Facebook (если у вас еще нет учетной записи) и добавить приложение разработчика Facebook в свою учетную запись, как описано на http://developers.facebook.com/get_started.php:

После этого вы должны начать с этих примеров, чтобы привыкнуть к созданию приложений Facebook. Тем не менее, я снова использую эти примеры в этом руководстве (в начале), чтобы убедиться, что все работает так, как ожидалось, прежде чем я попытаюсь написать что-то свое.

2 Настройка нового приложения

Прежде чем мы начнем программировать наше приложение, мы должны сообщить Facebook о нем, и Facebook затем даст нам API-ключ и Секрет, которые нам нужны для создания приложения.

Теперь, когда вы добавили приложение разработчика Facebook в свою учетную запись, перейдите на свою страницу Facebook - теперь вы должны увидеть приложение разработчика в левой навигации. Нажмите на него. Откроется страница разработчика, где вы нажмете кнопку + Настроить новое приложение (рядом с верхним правым углом):

Теперь мы на странице нового приложения. Я хочу назвать свое приложение HowtoForge RSS Feed Reader, поэтому я заполняю это в качестве имени приложения. Я отмечаю флажок под этим полем, чтобы показать, что я согласен с условиями платформы Facebook. Затем я заполняю адрес электронной почты для поддержки (это должен быть адрес, по которому вы или ваши коллеги-разработчики могут быть связаны). URL обратного вызова - это место, где будет размещено приложение. Мое будет размещено по адресу http://fb.howtoforge.com/fb/htf_feed_reader/, поэтому я заполняю это. URL страницы Canvas - это адрес Facebook, который вы хотите, чтобы ваше приложение имело. Заполните желаемый адрес (например, http://apps.facebook.com/htf_feed_reader), и форма затем сообщит вам, доступен ли адрес или нет. Затем выберите Использовать FBML и Веб-сайт (оба должны быть уже выбраны по умолчанию):

Важно отметить, что URL обратного вызова: абсолютно важно, чтобы URL заканчивался слешем (/); если этого не сделать, люди позже получат известную ошибку The URL … did not respond, когда они посетят ваше приложение в своих учетных записях, как это:

Далее, все еще на странице нового приложения, заполните другие параметры. Ответьте на вопрос Может ли ваше приложение быть добавлено на Facebook? - Да. Вы можете оставить поле URL TOS пустым, если у вас нет условий обслуживания. Добавьте дополнительных разработчиков, если они есть. В качестве URL Post-Add используйте URL страницы Canvas (http://apps.facebook.com/htf_feed_reader в моем случае). Заполните описание для вашего приложения. URL Post-Remove также можно оставить пустым. В поле Default FBML вы можете ввести текст, который вы хотите, чтобы появлялся на профилях пользователей, если ваше приложение не предоставляет контент для страницы профиля. Затем выберите, в каком столбце профиля вы хотите, чтобы ваш контент появлялся. Поскольку в RSS-лентах много текста, широкий столбец - хороший выбор в нашем случае:

Далее на странице нового приложения есть только одно другое поле, которое мы должны заполнить, URL боковой навигации. Снова это то же самое, что и URL страницы Canvas (http://apps.facebook.com/htf_feed_reader в моем случае). Все остальные поля можно оставить пустыми. Нажмите на Отправить после этого:

Теперь вы должны быть на странице Мои приложения, где вы можете найти API-ключ и Секрет для вашего приложения. Скопируйте их, они нам понадобятся для нашего приложения позже.

Далее на странице Мои приложения вы увидите ссылку на библиотеку PHP (4 и 5) клиента: