Добавить виджет инстаграм на сайт

Недавно мне потребовалось интегрировать в сайт Instagram виджет. Чтобы пользователи видели последние опубликованные фотографии. Может даже подписывались.

Тут же выяснилось, что официального виджета у Instagram нет. Более того, с Instagram можно взаимодействовать исключительно через запросы к API. Никаких тебе jаvascript библиотек, генераторов кода и дизайна. Всё нужно делать руками.

Сразу нашлось множество сторонних сервисов разной степени платности и бесплатности. Объединяло их одно – клиент получает лишь код вызова виджета, всё остальное тянется с сервиса. Меня лично это не устраивало. Почему нет бесплатного standalone решения с открытым исходным кодом? Может быть я плохо искал? В общем, я решил внести свои пять копеек.

Инструкция по созданию виджета и готовое решение под катом.

Небольшое примечание. С момента написания этой статьи прошло уже семь месяцев. За это время виджет был установлен на около 80 ресурсах, создан репозиторий на GitHub, добрый человек подарил мне инвайт, виджет сменил механизм кэширования, обзавёлся собственным сайтом, добрые люди на его основе сделали плагин для CMS Битрикс, а я так и не нашёл аналогов в сети.

1. Требования к виджету:

Для начала сформулирую, что за виджет я хотел сделать.
Итак, виджет должен иметь:

• Иконку Instagram;
• Заголовок;
• Фотографию профиля;
• Статистику профиля;
• Кнопку перехода к странице профиля;
• Кликабельные фотографии;
• Настраиваемое количество фотографий (общее количество и сколько выводить в строку);
• Резиновый дизайн и автомаштаб фотографий в зависимости от нужной ширины виджета;
• Вывод фотографий по хэш-тегу (добавилось в процессе);
• Вставка виджета одной строчкой в HTML-код.

Вот, что получилось в итоге:
Демонстрация работы >

Пример в картинках:

А вот так вставляется в HTML:

Если заинтересовались, то приглашаю ознакомится с деталями реализации.

2. Регистрация сайта в Instagram:

На сайте Instagram есть документация к API. Вот прямая ссылка:
http://instagram.com/developer/

Сначала нас интересует раздел «Управлять программами». В нём на требуется зарегистрировать новое приложение (наш сайт), от лица которого и будет работать виджет. Так что переходим в этот раздел. Нажимаем кнопку «Регистрация новой программы» и заполняем форму:

• Application Name – Название нашего приложение. Можете написать название сайта;
• Description – Описание приложения;
• Website – URL-адрес нашего сайта;
• OAuth redirect_uri – URL на который перейдёт пользователь после авторизации. Т.к. у нас просто виджет и никого авторизовывать мы не будем, можно просто продублировать адрес нашего сайта.

Дальше нажимаем кнопку «Register».

После регистрации мы получаем два ключа. Нас интересует CLIENT ID. С ним мы будем работать в дальнейшем.

3. Получение данных через API:

Для того, чтобы получать данные через API нужно использовать т.н. «Конечные точки» описанные в документации. Это просто список URL адресов. Каждый адрес отвечает за выдачу определённых данных. Данные отдаются в формате JSON. Поскольку я хотел транслировать фотографии и статистику профиля, то я сразу пошёл в подраздел «пользователи». Авторизация для этого ненужна.

Тут выясняется, что для получения каких-либо данных по аккаунту, нужно знать идентификатор этого аккаунта. Пользователи знают только свой логин, но не ID. Где же его взять?

Идентификатор можно подсмотреть в HTML-коде страницы профиля, а можно отправить запрос на вот этот URL:

https://api.instagram.com/v1/users/search?q=LOGINclient_id=CLIENT_ID

Где LOGIN – это искомый логин в Instagram, а CLIENT_ID – это ключ, которые мы получили на этапе регистрация приложения. В результате мы получим JSON массив, который по мимо идентификатора также будет содержать URL аватарку пользователя.

Далее, для получения списка новых фотографий из нашего профиля, нужно отправить GET запрос на вот этот URL:

https://api.instagram.com/v1/users/USER_ID/media/recent/?client_id=CLIENT_ID

Где USER_ID – это идентификатор который мы получили из предыдущего запроса. Также в запрос можно добавить дополнительные аргументы. Перечень вы найдёте на странице документации.

Ну и последний запрос на получение статистики профиля:

https://api.instagram.com/v1/users/USER_ID/?client_id=CLIENT_ID

С получением данных разобрались. Приступаем к реализации.

4. Реализация виджета

Начну с неприятной новости. API Instagram явно ориентирован на полноценные приложения, а не простенькие виджеты для сайтов. От сюда вытекает две проблемы: К API можно отправить лишь 5000 запросов в час от одного CLIENT_ID или авторизованного пользователя; Нежелательно, чтобы CLIENT_ID был в свободном доступе, т.к. любой желающий может делать запросы на получение данных от имени вашего приложения.
Т.к. для просмотра виджета глупо просить авторизацию у посетителей, отправка/получение запроса занимает время, а наш сайт имеет 700 тыс. просмотров в день (до 80 000 запрос в час в вечернее время), нужно реализовать механизм кэширования данных.

В результате я решил, что виджет должен отрисовываться сервером. Поэтому релизация будет на PHP HTML CSS.
Подключать виджет будем через iframe.

4.1 Кэширование:

Первая версия виджета записывала кэш в БД MySQL, но затем я одумался и перенёс кэш в файл.
Как итог — выше скорость работы, меньше телодвижений с настройками, и не у всех есть MySQL.

Кэш хранится в формате JSON. Актуальность проверяется по дате последней модификации файла. Если кэш устарел, то происходит запрос к API на получение актуальных данных.

Если при отправке запроса происходит ошибка, то она с пояснением записывается в кэш как обычный текст. Если в кэше обычный текст, то он выводится вместо виджета. Запросы к API не будут отправляться пока кэш снова не устареет. Тем самым виджет не будет нагружать сервер регулярными запросами к API, если что-то пойдёт не так. И можно будет понять, почему виджет перестал работать.

4.2 Исходный код:

Отправляем запросы cURL, записываем данные в кэш, рисуем виджет с помощью HTML CSS, пишем подробную инструкцию и занимаемся перфекционизмом ещё несколько бессонных ночей. В результате получилось вот это:

Репозиторий на GitHub >

Самое интересное происходит в файле inwidget.php
config.php – отвечает за настройки, а template.php за вёрстку.
И, конечно, всё бесплатно. Всё для народа.

4.3 Как подключить виджет к сайту?:

Инструкция по шагам: Зарегистрируйте сайт в Instagram (обсудили в начале статьи). Скачайте исходный код виджета. Загрузите папку с виджетом на сервер. Установите права на запись для папки /inwidget/cache. Настройте параметры виджета (файл config.php). Вставьте виджет в сайт с помощью следующего кода:
Примеры вставки с различным отображением виджета
По своему вкусу можете настроить параметры вставки, которые передаются как GET параметры при обращении к скрипту:

• width – ширина виджета (по умолчанию 260px).
• inline – количество фотографий в строке (по умолчанию 4 шт.).
• view – сколько фотографий отображать в виджете (по умолчанию 12 шт., максимально 30 шт., можно исправить в confing.php).
• toolbar – отобразить тулбар с аватаркой и статистикой (значения true/false, по умолчанию true).
• preview – размер и качество изображений (small – маленькие до 150px, large – большие до 306px, fullsize – полноразмерые до 640px, по умолчанию small).
• lang – язык виджета (значения ru/en, по умолчанию берутся настройки из config.php). Приоритет этого параметра выше чем для настроек в config.php.

При изменении ширины или количества фотографий не забудьте изменить размер iframe.

Вот, собственно, и всё.

Сайт виджета: http://inwidget.ru
Репозиторий на GitHub: https://github.com/aik27/inwidget

P.S.: Буду рад отзывам, комментариям и обратной связи.

Пасхалка!Это мой кот. Каждая строчка виджета написана под его неусыпным контролем. Несколько раз котэ вносил корректировки в процесс пробегая по клавиатуре. Уделяйте больше времени своим питомцам! Ловите смешные моменты с ними. Фотографируйте больше!

добавить виджет инстаграм на сайт
Причины появленияСамая быстрорастущая социальная сеть в России, в прошлом социальная сеть про едуp>Сегодня про инстаграм знает каждый пользователь рунета. Если не использует сам, то, как минимум слышит о нем из-за дня в день. С бурным развитием этой социальной сети все большее количество веб-разработчиков хотят взаимодействовать с ней любыми доступными способами, только вот сам инстаграм не торопится с кем то дружитьp>

Одних администрация социальной сети Instagram не допускает к работе с API, а другим без предупреждения ограничивает объём данных, доступных для полученияp>

У нас же более простые задачи, которые необходимо решать ежедневно.

«Виджет инстаграма для вашего сайта» был разработан для простых веб-разработчиков, начинающих IT сотрудников, создателей домашних страниц и системных администраторовpОписание работы сервиса     nbspВопросы и ответы     nbspПримеры использованияbr>

 

Из этого материала вы узнаете:

О том, что такое виджет Инстаграма для сайта и как его установить правильно, полезно знать всем, кто занимается бизнесом в интернете. Так уж сложилось, что готового способа установки от официальных создателей приложения нет, поэтому нужно искать другие варианты. Зачем это вообще необходимо?

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

Что такое виджет Инстаграма для сайта

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

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

«ВКонтакте» и Facebook предлагают всем собственникам интернет-площадок воспользоваться официальными плагинами для установки виджетов на свои ресурсы. Инстаграм не последовал примеру этих соцсетей, поэтому готовый код найти не удастся. Чтобы установить его виджет, придется воспользоваться плагинами других разработчиков.

Настройка виджета Инстаграм выполняется владельцем сайта исходя из его требований к внешнему виду приложения. Можно регулировать ширину блока, формат отображения фотографий, их количество, выбирать цвета графических элементов. По желанию шапку снабжают названием, в ней же размещают краткие сведения об аккаунте.

Вот как выглядит виджет Инстаграма на сайт:

Читайте другие статьи по теме виджеты для сайта

Подробная инструкция, как создать и добавить виджет Инстаграма на сайт

1. Требования к виджету

Обязательные элементы приложения:

• иконка Инстаграм;
• заголовок;
• фотография профиля;
• статистика профиля;
• кнопка перехода к странице профиля;
• кликабельные фотографии;
• настраиваемое количество фотографий (общее количество и сколько выводить в строку);
• резиновый дизайн и автомасштаб фотографий в зависимости от нужной ширины виджета;
• вывод фотографий по хэштегу;
• вставка widget одной строчкой в HTML-код.

Для вставки виджета в HTML применяется следующая команда:

2. Регистрация сайта в Инстаграм

Документация к API размещена на сайте Instagram, найти ее можно по ссылке:

http://instagram.com/developer/

Комментарий эксперта

«Мы обязаны делать клиентов довольными
любыми доступными способами!»

Алексей Молчанов,
основатель международной IT-компании Envybox

Текущая ситуация в стране и мире с каждым днем набирает все больше и больше оборотов.

Сегодня каждый предприниматель задается вопросом: “А что же сейчас будет с моим бизнесом?”

Если вы поддадитесь всеобщей панике и “заморозите” деятельность компании, то ни к чему хорошему это не приведет. Если вы видите, что кризис неизбежен и доход компании уже начинает сокращаться — не приостанавливайте свою деятельность. Ни в коем случае не сокращайте расходы на рекламу и не прекращайте продвижение (если вас, конечно, не закрыли из-за Постановления правительства).

Направляйте максимум усилий и внимания на продвижение своей компании и увеличение потока новых клиентов.

Для того, чтобы у вас было понимание, как следует себя вести во время кризиса — поделюсь с вами полезными инструментами, которые помогли нам не только преодолеть кризис, но и выйти из него победителями.

Ниже вы можете скачать чек-лист из простых и доступных для любой компании инструментов привлечения стабильного потока новых клиентов или возвращения существующих. А также в качестве бонуса получить бесплатное использование наших сервисов для увеличения заявок с сайта в течение 7 дней и 30% скидку на их подключение. Желаем вам удачи, новых клиентов и больших продаж!

Первым делом находим раздел «Управлять программами», где происходит регистрация сайта, чтобы Инстаграм разрешил установить свой виджет на вашей веб-площадке. Заполняем форму, которая появляется после нажатия кнопки «Регистрация новой программы»:

• Application Name – вводите название своего ресурса;
• Description – добавляете описание приложения;
• Website – указываете URL-адрес нашего сайта;
• OAuth redirect_uri – вписываете URL, на который перейдет пользователь попадет после авторизации. Для обычного виджета опознавать посетителя не требуется, поэтому в этом поле повторяем адрес сайта.

Завершаем эту процедуру нажатием кнопки «Register».

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

3. Получение данных через API

Для получения данных через API задействуются «Конечные точки», описание которых дано в документации. Они представляют собой перечень URL-адресов, каждый из которых курирует выдачу данных определен

ного типа в формате JSON. Чтобы обеспечить трансляцию фотографий и статистики профиля, можно, минуя авторизацию, перейти в подраздел «Пользователи».

На этом этапе вас ожидает небольшая сложность: чтобы получать сведения об аккаунте, необходим его идентификатор. Однако ничего кроме собственного логина пользователям неизвестно. Как решить эту проблему?

Идентификатор содержится в HTML-коде страницы профиля, и его можно скопировать оттуда. Второй вариант – отправить запрос на следующий URL:

https://api.instagram.com/v1/users/search?q=LOGINclient_id=CLIENT_ID

Вместо LOGIN подставляем логин в Инстаграм, а вместо CLIENT_ID – ключ, выданный вам при регистрации приложения. Полученный в итоге JSON массив включает идентификатор и URL аватарку пользователя.

Идем дальше. Чтобы получить список свежих фотографий из вашего профиля, посылаем GET запрос на этот URL:

https://api.instagram.com/v1/users/USER_ID/media/recent/?client_id=CLIENT_ID

USER_ID заменяем идентификатор, полученный после предыдущего запроса. На этом этапе вами могут быть добавлены дополнительные аргументы из списка, расположенного на странице документации.

Получать статистику профиля вы сможете после отправки еще одного запроса:

https://api.instagram.com/v1/users/USER_ID/?client_id=CLIENT_ID

Как получать данные, теперь понятно. Следующий этап – реализация.

4. Реализация widget

Для начала придется вас расстроить: API Инстаграма создан для полноценных приложений, а мы собираемся всего лишь установить на сайт простой виджет.

В связи с этим предстоит обойти две проблемы:

• Количество запросов к API ограничено 5000 в час от одного CLIENT_ID или авторизованного пользователя.
• CLIENT_ID в свободном доступе позволяет любому пользователю использовать ваше приложение для получения данных, а это крайне нежелательно.

Просить посетителей авторизоваться только для того, чтобы просмотреть виджет, как минимум, странно: чтобы отправить или получить запрос, нужно время, при этом число просмотров сайта вечером может достигать 90 тысяч в час и 800 тысяч в день. Следовательно, необходимо кэширование данных.

При отрисовке widget Инстаграм сервером реализация будет на PHP HTML CSS.

Для подключения можно использовать iframe.

• Кэширование

Для хранения кэша задействуется формат JSON. Для проверки актуальности смотрят на дату последней модификации файла. При устаревании кэша и необходимости получить свежие данные направляется запрос к API.

При обнаружении ошибки в ходе отправки запроса она сохраняется в кэше в виде обычного текста и сопровождается пояснением. В этом случае вместо виджета пользователь видит просто текст. Только когда кэш снова потеряет актуальность, к API будет направлен новый запрос, то есть в случае возможных проблем сервер не будет перегружен постоянными запросами к API. Это позволит установить причину, по которой виджет не работает.

• Исходный код

После отправки запросов с URL записываем в кэш полученные данные, для отрисовки виджета применяем HTML CSS, затем составляем детальную инструкцию и тратим еще некоторое время, пока результат нас полностью не устроит.

Наибольший интерес представляет файл inwidget.php.

За настройки отвечает config.php, за верстку – template.php.

5. Подключение widget к сайту

Подробная инструкция, как вставить виджет Инстаграм на сайт:

• Регистрируете свой ресурс в Инстаграм.
• Скачиваете исходный код виджета.
• Загружаете папку с widget на сервер.
• Устанавливаете права на запись для папки /inwidget/cache.
• Настраиваете параметры виджета (файл config.php).
• Устанавливаете виджет Инстаграм в сайт, используя код.

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

При обращении к скрипту они передаются как GET параметры:

• width – ширина widget Инстаграм (базовая настройка – 260 px);
• inline – количество фотографий в строке (по умолчанию 4 шт.);
• view – сколько снимков будет показываться в виджете Инстаграм (по умолчанию 12 шт., максимум 30, в confing.php можно задать собственные параметры);
• toolbar – отобразить тулбар с аватаркой и статистикой (значения true/false, по умолчанию true);
• preview – размер и качество изображений (small – маленькие до 150 px, large – большие до 306 px, fullsize – полноразмерные до 640 px, по умолчанию small);
• lang – язык виджета Инстаграм (значения ru/en, в качестве базовых задействуются настройки из config.php);

Изменяя ширину или количество снимков, важно внести коррективы в размер iframe.

Как легко и быстро установить виджет Инстаграма для сайта на WordPress

Процедура установки на WordPress очень проста, благодаря нашей инструкции с этим справится любой желающий.

Проходим авторизацию в админпанели WordPress, используя учетную запись администратора. Открываем вкладку «Внешний вид» -> «Виджеты». Текстовый блок из раздела «Доступные виджеты» перетаскиваем в один из контейнеров справа. Заполняем поля настроек widget Инстаграм в верхней части страницы, указываем аккаунт или хэштег для показа фотографий, нажимаем «Сгенерировать код вставки» и копируем то, что получили. Выданный нам код вставляем в текстовое поле и сохраняем.

На этом процесс установки виджета Инстаграм на WordPress завершен.

Как видите, все предельно просто. В результате несложных действий у вас на сайте появляется привлекательный виджет, в котором есть миниатюрные снимки, ссылка на ваш аккаунт в этой соцсети, счетчик подписчиков и другие полезные элементы. Позаботьтесь о том, чтобы его оформление гармонировало с дизайном вашей веб-площадки, и можете смело рассчитывать на рост пользовательского интереса.