Интегрируем Twitter на сайт за 5 минут с @Anywhere

2 мая
2010

До недавнего времени, внедрение возможности взаимодействия с Twitter API на сайт было процессом не самым простым. Приходилось скачивать и разбираться с библиотеками, либо писать их самому, а потом еще запихивать все это в код и отлаживать. Ничего невозможного нет, но времени отнимало достаточно.
Теперь Твиттер представил нам новое решение под названием @Anywhere, которое позволит, с помощью нескольких строчек кода, добавить на Ваш сайт возможность работы с Twitter.

Пост получился достаточно громоздкий, но тут действует принцип (немного перефразирую) «Лучше час потерять, зато потом за пять минут долететь» .

Данная платформа очень проста в применении, но на данный момент обладает меньшим функционалом по сравнению с Twitter API.
Давайте посмотрим, что умеет @Anywhere, и как это применить на практике. Оригинальное описание системы можете найти здесь. Я постараюсь объяснить не менее понятно и попробую дополнить от себя. Начнем.

Регистрируем приложение @Anywhere

Для начала, нам нужно зарегистрировать приложение. Авторизуйтесь в Твиттере и переходите сюда, заполните форму, указав название и описание приложения (например, «Блог Дяди Яши»), его адрес и тип (browser). Default Access type устанавливайте в Read & Write.
После регистрации Вы получите API key, который в дальнейшем нам пригодится.

Загружаем код @Anywhere

Чтобы использовать возможности платформы @Anywhere, нам нужно добавить загрузку anywhere.js в код тех страниц, где планируем его применять:

<!DOCTYPE HTML>
<html>
  <head>
    <meta http-equiv="Content-type" content="text/html; charset=utf-8">
    <title>Anywhere Sample</title>
    <script src="http://platform.twitter.com/anywhere.js?id=ВАШ_API_KEY&v=1" type="text/javascript"></script>
  </head>
  <body>
    ...
  </body>
</html>

В качестве параметра передается API key и номер версии @Anywhere (на данный момент существует только версия 1).

Инициализируем @Anywhere

Скрипт создает объект twttr. Для использования @Anywhere, вызовите метод anywhere и получите экземпляр клиента Twitter API (решено называть его «T») в качестве аргумента. Все возможности платформы являются частью этого клиента и реализуются через вызов методов объекта «T».
Простейший пример, думаю, все объяснит:

<script type="text/javascript">

  twttr.anywhere(function (T) {
    T.hovercards();
  });
</script>

Метод hovercards позволяет автоматически превращать текст вида @uncleyaru в ссылку на одноименный твиттер-аккаунт, а также выводит информацию о данном аккаунте в виде всплывающего окна (для краткости, я назвал это окно «карточкой»). Я подготовил наглядный пример. Быстренько ознакомьтесь и продолжим.
Метод anywhere может вызываться неограниченное количество раз в коде страницы.

Возможности @Anywhere

Автоматическая замена текста @uncleyaru на ссылку вида @uncleyaru (Auto-linkification).
Карточки (Hovercards), мы познакомились с ними в первом примере.
Кнопки Follow.
Окно отправки сообщений (Tweet Box).
Авторизация и регистрация с помощью твиттер.

Auto-linkification

Для автозамены нам нужно вызвать метод T.linkifyUsers():

<script type="text/javascript">

  twttr.anywhere(function (T) {
    T.linkifyUsers();
  });
</script>

Данный код заменит на ссылки все подходящие (слова длиной от 1 до 20 символов, начинающиеся с @ и включающие символы a...zA...Z0...9 и символ «_») твиттер-ники в пределах тега <body>.
Чтобы ограничить действие метода, передайте в качестве параметра объекта CSS селектор. В результате, действие метода будет распространяться только на имена, расположенные внутри элемента с заданным селектором. Например:

<script type="text/javascript">

  twttr.anywhere(function (T) {
    T("#linkify-this-content").linkifyUsers();
  });
</script>

Здесь, воздействию подвергнутся имена, находящиеся внутри элемента с id="linkify-this-content".
По умолчанию, метод linkifyUsers() присваивает именам стилевой класс twitter-anywhere-user, т.е. они обрамляются тегом вида <a class='twitter-anywhere-user'></a>. Чтобы изменить имя класса, просто задайте свойство className при вызове метода:

<script type="text/javascript">

  twttr.anywhere(function (T) {
    T("#linkify-this-content").linkifyUsers({ className: 'my-tweep' });
  });
</script>

В данном случае, именам будет присвоен класс my-tweep.

Карточки Hovercards

Возможности данного метода мы рассмотрели в первом примере. Ниже я повторил код вызова метода:

<script type="text/javascript">

  twttr.anywhere(function (T) {
    T.hovercards();
  });
</script>

Более подробно об этом и других методах я расскажу в следующем посте. Не переключайтесь

Не забудьте подписаться на RSS.

Еще интересно почитать:

Рубрики: twitter
Теги: anywhere, twitter, твиттер

8 комментариев к Интегрируем Twitter на сайт за 5 минут с @Anywhere

Евгений

мая 2, 2010 | 22:15

Дядя Яша, баян какой-то гоните Видеоурок на youtube в буржнете с аналогичным названием

Дядя Яша

мая 2, 2010 | 22:37

Потерто...

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