Доброго времени суток, уважаемое сообщество ICMS!
Представляю вам интеграцию сайтов на Инстант кмс с игровой платформой NEXTGAME.
Итак, для начала о платформе. Информацию можно получить по ссылке.
Меня привлекли прежде всего многопользовательские игры и приложения, которые могут быть полезны для сайтов(видеочат, читалка книг Тарино, гороскоп и разыграйка). Возможность интеграции сайта с платформой. Это означает, что пользователь, авторизовавшийся на сайте автоматом авторизуется на платформе и при этом, не покидает сайт. Также интересно и то, что пользователи могут играть с пользователями с других сайтов, которые тоже подключены к платформе.Также к плюсам можно отнести и то, что при интеграции автоматом подключается партнерская программа. 45% транзакций ваших пользователей идут в ваш карман.
Минусы. Не прикрытое навязывание платных услуг. Не очень удобный сайт по юзабилити. Имеется ввиду сайт платформы. Приложения удобны и открываются во всплывающем окне. Платформа новая, развивается. Приложений пока маловато. Хотя техподдержка и работает нормально, оперативно реагирует на заявки, могут также без предупреждения поменять документацию по интеграции. Что и произошло со мной. Почти четыре дня не могли разобраться, почему нет интеграции. Оказывается они поменяли документацию, где изменился немного порядок подключения. Я писал по старой, а у них уже другие условия. Слава богу, разобрались.
По той же причине в файлах интеграции отсутствуют некоторые функции(появились только в новой версии). Хотя они и необязательны. Это отправка приглашения другу с приложения и запись на стену пользователя.Со временем доработаю.
В полной мере протестировать не смог, маленькая посещаемость на сайте. Надеюсь на помощь в тестировании со стороны сообщества.
Кстати, по ссылке найдете документацию по интеграции.
Порядок подключения:
1.Забираем архив для версий 1.8-1.9здесь.
2.Распаковываем в корень сайта. То есть в корне сайта должна появиться папка /api/ и должны прописаться два файла в /includes/
3.Регистрируемся на сайте платформыкак партнер.
4.Создаем площадку и получаем id вашего сайта и секретный ключ API_SECRET_KEY.
5.Прописываем эти данные в файле /includes/nextgame.inc.php 20-21 строки:
за место звездочек нужно вписать ваши данные. Апострофы должны остаться на месте, только вместо звездочек.
6.Подключаем файл /includes/myphp/nextgame.php в модуль внешний файл (нужно прописать {ФАЙЛ=nextgame.php}) и выводим где нужно.
7.Заходим в личный кабинет на сайте nextgame.ru и во второй вкладке "Интеграция площадки" настраиваем интеграцию. Для этого переключатель "На моем сайте есть пользователи, и я хочу, чтобы они входили в игру под учетными записями моего сайта: " ставим "да". Переключатель "Я могу предоставить функции для работы с API NextGame.RU:" тоже ставим "да" и в первое поле прописываем:
ваш сайт/api/getprofile.php
Ниже ставим галочку для каждого метода и прописываем методы:
URL функции получения списка друзей пользователя: ваш сайт/api/getfriends.php
URL функции отправки сообщения пользователю: ваш сайт/api/sendmessage.php
URL функции отправки сообщения на стену пользователя: ваш сайт/api/wallpost.php"
URL функции отправки приглашения в игру: ваш сайт/api/invite.php
Внизу нажимаем кнопку "сохранить" и наслаждаемся тем, как пользователи Вашего сайта "режутся в игры".
В личном кабинете в 3-ей вкладке при втором типе интеграции теперь можно получить код для перехода в приложение для авторизованного юзера. Если не нравится, как выводятся игры при подключении файла nextgame.php, можете брать код для определенной игры с кабинета и вставлять в любое место. Правда для формирования сигнатуры(подписи) придется подключать и использовать функции с файла nextgame.inc.php. Таким же образом можете подключать если у вас не выводится список приложений (не выполняются требования указанные ниже).
В файле nextgame.php выводится весь список приложений. При желании можно вывести по аналогии отдельное приложение или выборочно те, которые нужно. Для неавторизованных предоставляется ссылка на гостевой вход с id вашего сайта. Тем, кто авторизован, выдается ссылка на приложение с автоматической авторизацией. Демо можно посмотреть у меня на на сайте. В файле nextgame.inc.php есть три функции для формирования кода вывода. Можно выводить в виде ссылок с названием приложения, в виде логотипа игры со ссылкой и в iframe. Ширина iframe должна быть не менее 760px. Можете использовать их для того чтобы вывести приложения как вам нужно. Первая и третья работают точно. Вторую не проверял. Допустим, видеочат можно привязать к отдельному пункту меню и выводить в ифрейме. Тут уж фантазия ваша.
Требования:
Права на папку /api/ у меня 755, на файлы 644 и всё работает. У вас возможно нужно будет по другому в зависимости от конфигурации сервера и пхп.
Требуются следующие расширения php (можете посмотреть в phpinfo)iconv support enabled (в php5 имеется уже в ядре),json support enabled. Директива allow_url_fopen on .
Ну и всё. Приятной эксплуатации. Буду рад замечаниям. Сильно не пинайте начинающего кодера.
Скачиваем архив и заменяем файл /includes/myphp/nextgame.php файлом с архива.
Скачать файл nextgame.php.
Представляю вам интеграцию сайтов на Инстант кмс с игровой платформой NEXTGAME.
Итак, для начала о платформе. Информацию можно получить по ссылке.
Меня привлекли прежде всего многопользовательские игры и приложения, которые могут быть полезны для сайтов(видеочат, читалка книг Тарино, гороскоп и разыграйка). Возможность интеграции сайта с платформой. Это означает, что пользователь, авторизовавшийся на сайте автоматом авторизуется на платформе и при этом, не покидает сайт. Также интересно и то, что пользователи могут играть с пользователями с других сайтов, которые тоже подключены к платформе.Также к плюсам можно отнести и то, что при интеграции автоматом подключается партнерская программа. 45% транзакций ваших пользователей идут в ваш карман.
Минусы. Не прикрытое навязывание платных услуг. Не очень удобный сайт по юзабилити. Имеется ввиду сайт платформы. Приложения удобны и открываются во всплывающем окне. Платформа новая, развивается. Приложений пока маловато. Хотя техподдержка и работает нормально, оперативно реагирует на заявки, могут также без предупреждения поменять документацию по интеграции. Что и произошло со мной. Почти четыре дня не могли разобраться, почему нет интеграции. Оказывается они поменяли документацию, где изменился немного порядок подключения. Я писал по старой, а у них уже другие условия. Слава богу, разобрались.
По той же причине в файлах интеграции отсутствуют некоторые функции(появились только в новой версии). Хотя они и необязательны. Это отправка приглашения другу с приложения и запись на стену пользователя.Со временем доработаю.
В полной мере протестировать не смог, маленькая посещаемость на сайте. Надеюсь на помощь в тестировании со стороны сообщества.
Кстати, по ссылке найдете документацию по интеграции.
Порядок подключения:
1.Забираем архив для версий 1.8-1.9здесь.
2.Распаковываем в корень сайта. То есть в корне сайта должна появиться папка /api/ и должны прописаться два файла в /includes/
3.Регистрируемся на сайте платформыкак партнер.
4.Создаем площадку и получаем id вашего сайта и секретный ключ API_SECRET_KEY.
5.Прописываем эти данные в файле /includes/nextgame.inc.php 20-21 строки:
за место звездочек нужно вписать ваши данные. Апострофы должны остаться на месте, только вместо звездочек.
6.Подключаем файл /includes/myphp/nextgame.php в модуль внешний файл (нужно прописать {ФАЙЛ=nextgame.php}) и выводим где нужно.
7.Заходим в личный кабинет на сайте nextgame.ru и во второй вкладке "Интеграция площадки" настраиваем интеграцию. Для этого переключатель "На моем сайте есть пользователи, и я хочу, чтобы они входили в игру под учетными записями моего сайта: " ставим "да". Переключатель "Я могу предоставить функции для работы с API NextGame.RU:" тоже ставим "да" и в первое поле прописываем:
ваш сайт/api/getprofile.php
Ниже ставим галочку для каждого метода и прописываем методы:
URL функции получения списка друзей пользователя: ваш сайт/api/getfriends.php
URL функции отправки сообщения пользователю: ваш сайт/api/sendmessage.php
URL функции отправки сообщения на стену пользователя: ваш сайт/api/wallpost.php"
URL функции отправки приглашения в игру: ваш сайт/api/invite.php
Внизу нажимаем кнопку "сохранить" и наслаждаемся тем, как пользователи Вашего сайта "режутся в игры".
В личном кабинете в 3-ей вкладке при втором типе интеграции теперь можно получить код для перехода в приложение для авторизованного юзера. Если не нравится, как выводятся игры при подключении файла nextgame.php, можете брать код для определенной игры с кабинета и вставлять в любое место. Правда для формирования сигнатуры(подписи) придется подключать и использовать функции с файла nextgame.inc.php. Таким же образом можете подключать если у вас не выводится список приложений (не выполняются требования указанные ниже).
В файле nextgame.php выводится весь список приложений. При желании можно вывести по аналогии отдельное приложение или выборочно те, которые нужно. Для неавторизованных предоставляется ссылка на гостевой вход с id вашего сайта. Тем, кто авторизован, выдается ссылка на приложение с автоматической авторизацией. Демо можно посмотреть у меня на на сайте. В файле nextgame.inc.php есть три функции для формирования кода вывода. Можно выводить в виде ссылок с названием приложения, в виде логотипа игры со ссылкой и в iframe. Ширина iframe должна быть не менее 760px. Можете использовать их для того чтобы вывести приложения как вам нужно. Первая и третья работают точно. Вторую не проверял. Допустим, видеочат можно привязать к отдельному пункту меню и выводить в ифрейме. Тут уж фантазия ваша.
Требования:
Права на папку /api/ у меня 755, на файлы 644 и всё работает. У вас возможно нужно будет по другому в зависимости от конфигурации сервера и пхп.
Требуются следующие расширения php (можете посмотреть в phpinfo)iconv support enabled (в php5 имеется уже в ядре),json support enabled. Директива allow_url_fopen on .
Ну и всё. Приятной эксплуатации. Буду рад замечаниям. Сильно не пинайте начинающего кодера.
UPDATE 27.02.2012
Сделал файлик для вывода приложений витриной как в комментарии.Скачиваем архив и заменяем файл /includes/myphp/nextgame.php файлом с архива.
Скачать файл nextgame.php.
++++
Когда авторизуетесь на сайте и запускаете любое приложение, происходит автоматическая регистрация в некстгейме. Достижения в приложениях сохраняются, добавляются ваши друзья с сайта. Если они тоже запустили приложение, которое запустили вы, появляются новые возможности. В скором времени добавлю еще два файла. Можно будет отправлять приглашение друзьям с сайта прямо из приложения и писать на их стену в профиле. В дальнейшем, при авторизации с сайта, ваш профиль сохраняется. Естественно, если авторизуетесь с другого сайта, будет другой профиль.
Не путать с профилем партнера, это если вы добавляете свою площадку. Партнерам нужно регистрироваться отдельно.
и куда игры вставлять я тоже не понял
запись на стену и сообщения/приглашения уже протестировали
пока еще в работе, потом тоже выложу
Интересно, как реализовали пост на стену. Самый сложный момент.
1.Отправка приглашения с приложения
2.Пост на стену пользовател.
Архив и инструкцию обновил.
Тем, кто уже установил, нужно скачать новый архив и залить два файла из папки /api/, это файлы invite.php и wallpost.php. Затем нужно написать службе поддержки платформы, чтобы включили 2 метода:
http://ваш сайт/api/invite.php
http://ваш сайт/api/wallpost.php
Тестировалось только по прямому доступу. Как будет из приложений пока неизвестно. О выявленных ошибках прошу сообщить.
Проблема возникла в вашем плагине. При запросе пользователя
http://...../api/getprofile.php?
uid=95&time=1314179845&sig=bd94d33948ae3b19547f02a6c87be4e8 вы отдаете такую XML:
<?xml version="1.0" encoding="UTF-8"?>
<profiles>
<user>
<uid>95</uid>
<nick_name>ueuktfd ueuktfd</nick_name>
<sex>M</sex>
<country>Россия</country>
<city>qwe</city>
</user>
</profiles>
Поле nickname вы пишете через подчеркивание, однако согласно документации
http://api2.nextgame.ru/doc/#int_api_getProfile это поле должно передаваться
слитно - nickname.
Отписался саппорту уже. У меня также. Скорее всего что-то у них не так. По прямому запросу всё работает.
В саппорте выделили отдельного человека, будем с ним работать. Там у них ещё некорректный запрос идет. Подождем, что ответят. Они тоже заинтересованы.
Кроме того, теперь стало намного удобнее подключать сайты. Инструкцию в блоге обновил. В личном кабинете добавилась возможность самому указывать методы. Теперь писать в службу поддержки не надо. Кроме того, у кого не выводился список игр, в треьей вкладке личного кабинета теперь можно получить код для вывода определенной игры. Правда нужно будет вставлять сигнатуру туда. Но это тоже не сложно.
Радуют приятные изменения и хорошая работа техподдержки.
Чтобы найти причину, нужно выяснить есть ли запрос. Засеките время, когда отправляете приглашение. Затем в логах доступа ищите запрос к файлу /api/invite.php в это же время. Если запрос есть, скиньте мне в личку его. Посмотрю что там. Возможно некорректные данные в запросе. Если всё нормально, значит будем искать причину в файле. ок?
С аккаунта админа работает только профиль.
с другого аккаунта работает приглашение, стена не работает, отправка сообщений тоже.
не знаю в чем проблема.
<Подпись> это $sig
пост на стену нашел только в одном приложении. с профайла вообще нет возможности постить. может быть у меня только так?
где смотреть запросы?
для начала скажите, при регистрации какой формат данных, "никнейм" или "имя фамилия"? дальше будем разбираться. и ещё,20 августа я перезалил архив. была ошибка при формате "никнейм". можете посмотреть выше в комментариях. у вас точно обновилось? может быть до этого скачали?
Попробуйте, отключить поочередно брандмауэр и антивирусник, если стоят. Если после отключения, подключение осуществилось, тогда нужно добавить указзанные порты в исключения. Как это сделать.. Это для встроенного в Винду брандмауера. Для антивиря, читайте в инструкции.
Если и после отключения брандмауэра и антивиря не сработало, обратитесь к своему провайдеру интернета. Возможно он закрыл порты.
method : users.getFriends
errdescr : array_keys() expects parameter 1 to be array, boolean given
result : false
errno : 1
это по этой причине ошибка, что id группы число из 2х знаков, а требуется 1? или я что-то не пойму
Группа тут непричем. id группы нигде не используется.
Все работает :)
На их сайте (http://www.nextgame.ru) пишут так:
Код для вставки:
<script type='text/javascript' src='http://api2.nextgame.ru/iframe/js/?app_id=27&site_id=394&user_id=<ID пользователя>&t=<Токен>&sig=<Подпись>'></script>
Что вставлять вместо <ID пользователя>, <Токен> и <Подпись> так и не понял...
define('APP_ID', '**');Примерно так. В профиле ссылка «мои приложения» пользователь жмет и попадает в «мои приложения» на nextgame…. Т.е попадал не в «приложения», а в «мои приложения».
Есть ли такая возможность попасть сразу в «мои приложения»?
Попробуйте сами. Откройте файл /includes/includes/nextgame.php. В этом файле посредством метода apps.getInfo получается список всех игр платформы, затем данные(в формате json) парсятся и выводятся. У платформы есть ещё несколько методов для получения всякой информации. apps.getUserApps как раз для получения списка игр пользователя. Подробнее можете прочитать по ссылке.. По подобию нужно передать данные на сервер. Про сигнатуру можете прочитать выше в комментариях и в апи уже есть методы для получения сигнатуры. Ну и нужно будет распарсить полученную информацию. Тоже по подобию. Думаю разберетесь. Несложно. Ну затем уже где нужно подключите файл(например в статью) и с профиля юзера ссылку на то место. Вот и всё.
Хочу тоже себе такое сделать. Когда доберусь, выложу файл.
Спасибо за разработку
посмотреть можно на my-pautina.ru
логин test
пароль test11
Наконец то решил вопрос с разделом "Развлечения". Интеграция с моим сайтом просто слов нет! Теперь пользователи рубятся друг с другом.Я сам на пару часов завис в "морской бой",короче для удержания пользователей,инструмент то что надо,+ качественно завуалированная монетизация вашего ресурса! Другие игровые платформы нагло либо рекламу пичкают либо скачать игру постоянно рекомендуют.
Опробовав сразу самые интересные приложения, везде заметил один "КОСЯЧОК" и думаю, решить его необходимо всем,кто эту платформу юзает. Суть проблемы:
Когда заходишь в приложение,оно интегрируется с твоим профилем.И в окне приложения(на верху) можно видеть свою аву(ту что на сайте),сообщения,настройки,...и список друзей. Вот только друзей в профиле, внутри приложения выводится 7шт ,т.е те первые,что были добавлены в друзья.Приложение НЕ ВИДИТ весь список друзей,что бы их пригласить в игру.Кто подскажет,что делать?
Данный вопрос решился каким то образом сам собой. После того как я написал последний комментарий,у меня было еще пару дел по сайту и я ковырялся в админке своего детища.Когда же решил заняться вопросом почему в игровом профиле загружает только 7 первых друзей,полез еще раз, что бы убедится в наличии этой проблемы.Но к моему удивлению,в моем игровом профиле в списке друзей появились все остальные. Список листается -1,2,3,4... итак далее.Т.е все ок.Как должно и быть. Игровую площадку прикрепил только вчера,может быть нужно было время для полной интеграции.Так,что если у вас после прикрепления возникнет ТАКАЯ ЖЕ проблема,не спешите бить в колокола, а просто выждите сутки.
В целом я просто мего доволен этой игровой площадкой и всем рекомендую, кто содержит порталы.Задерживает пользователей и заставляет возвращаться на ваш ресурс.
Марату за данную находку и инструктаж огромное СПАСИБО! Удачи тебе в твоих начинаниях! С такими людьми,наше сообщество далеко пойдет! :)
Сутки ждать, конечно, не имеет смысла. Просто возможно был разовый глюк системы.
По посетителям, у меня есть один такой. Каждый день упорно ходит. Задумался, чем он занимается, посмотрел в логах доступа по айпишнику. Оказалось, режется в игры нектсгейма. Пользователям нравится, а это главное.
Я думаю биллинг прикупить и вознаграждать пользователей по реф.системе баллами.Понятно,что будут злоупотребления программой,потому хотелось бы знать варианты отслеживания посещений с одного айпишника.Заранее благодарю за ответ.
Подробности и файл в самом посте. См.UPDATE.
Спасибо Марат +1
Установил, работает отлично... Спасибо Марат...
Вопрос проблема имеет место или у меня что то не так.
Ифрейм и игры грузятся с сайта платформы. Отпишитесь им, может подправят.
Если не ошибаюсь данная партнерка стоит на Loveplanet и там все без фреймов.
Также огромное спасибо, Марат, за инструкцию... с ней гораздо проще! Интересно, можно ли организовать вывод игр по жанрам?
Некоторое время назад появилось приложение Видеочат бутылочка - оно начало постить пользователям на стену ссылки на сайт bottlegame.ru - Навм это надо? Пользователю это надо? Он считает приложение частью нашего сайта, к чему это? После того как в ответ на мое письмо суппорт вежливо послал меня, я отключил постинг на стену вообще для некст гейм. Но теперь еще лучше. Вчера обнаружил что при запуске приложения выдает такую картину: Авторизация через платформу Next Game возможна только с площадок Mamba.ru и Loveplanet.ru. Нет, ну разве это не свинство?! Хотя бы уведомить можнго было что правила игры меняются что бы мы могли решить надо нам или нет. Вам надо отсылать пользователей на мамбу?! Мне нет.
Написал в суппорт.
Ответ:
--------
Здравствуйте.
Вход в игру возможен только с данных платформ.
NextGame.RU
--------
Все, даже извиниться никто не считает нужным. В общем ничего хорошего от этой партнерки не ждите, вот это все показатель как они намерены с вами работать. Буду снимать ихние приложения полностью.
Это с моего старого сайта, где даже друзей нельзя было приглашать.. а с инстантой это вдвойне красиво будет
Это данные за месяц (сейчас уже 1950) с посещаемостью в ~300 с сайта на cms Dle ArsGame.ru
Будет набрана карма - создам Блог с темой о том как делал и развивал сайты и натыкался на большие ошибки...
У меня стоит 1.10, вроде все файлы в utf-8 перекодировал, но все равно в приложениях кракозябры
1.10.1
И что ни будь типо вывода популярных игр?
1. Файлы залили из архива в конце поста? Проверьте в файлах нет ли строки типа:
2. Если с первым пунктом всё в порядке, проверяем дальше. Открываем файл /api/getfriends.php и комментируем строки 35-44
Если возвращается xml файл с корректными заполненными данными, значит всё в порядке. Не забудьте посмотреть кодировку возвращемого файла.
Если что-то отображается некорректно, напишите в личку или здесь.
http://tomskdating.ru/api/getprofile.php?uid=1
пишет 1Неверные параметры запроса
А в играх тоже пишет Имя неизвестно
Это не должно влиять. id пользователя же есть у вас? А этот пользователь с id = 1, которого проверяете, он существует? Главного админа не удаляли с базы?
Icms 1.10 стоит.
Приношу свои извинения. Вина моя, ошибка заключалась опять же в <nick_name>, а нужно <nickname>. Спасибо Dobriu за помощь в выявлении ошибки!
написал в поддержку но в некстгейме поддержка мертвая отвечают через пару месяцев а на некоторые вапросы так и не ответили(((
На сайте написано:
По умолчанию приложение открывается во всплывающем окне (лайтбоксе). Если вы хотите встроить приложение прямо в страницу, то немного измените код:
Для каталога такого способа выбора нет. Только во всплывающем окне.
Скоро буду переходить на 1.10.3 думаю тоже интересует вопрос поддержки.
Если делать по полной с помощью интеграции сделанной Маратом (за что ему спасибо конечно) то в nextgame.inc.php сначала укажи ID своей площадки и секретный ключ, потом возьми в папке /myphp файл app.php в нем здесь
Потом все залить на хостинг а в статье выбери "Вставить файл"
/includes/myphp/ далее укажи app105.php
Как то так должно работать)