Интеграция с ЭБС Лань позволяет авторизовать пользователей ELiS в ЭБС Лань и отобразить учебники из ЭБС Лань на сайте ELiS как удаленный ресурс.
Содержание
Как работает для пользователя[править]
- Пользователь заходит на сайте ELiS и по метаданным находит учебник.
- ELiS автоматически авторизует пользователя в ЭБС Лань. Если у пользователя не был создан аккаунт в ЭБС Лань, он автоматически создается.
- ELiS показывает удаленный учебник из ЭБС Лань в своем сайте (пользователю один раз надо будет принять пользовательское соглашение ЭБС Лань при первом просмотре учебника).
- Пользователь может открыть учебник в новой вкладке на весь экран, перейдя на сайт ЭБС Лань, или читать его в ELiS.
Когда нужна интеграция с ЭБС Лань[править]
Интеграция оптимальна при покнижном комплектовании, когда в ЭБС Лань закупается относительно небольшое число учебников.
Интеграцию также можно использовать и при покупке больших коллекций, но система автоматического импорта не импортирует иерархию и все книги будут в плоском каталоге.
Плюсы:
- пользователю не надо вводить логин и пароль в ЭБС Лань и не надо его знать. Также поиск по метаданным будет находить учебники Лань в ELiS.
Минусы:
- необходимо импортировать учебники Лань в ELiS как удаленный ресурс и администрировать их;
- книги из ЭБС Лань в ELiS доступны только для авторизованных пользователей;
- есть подсистема массового импорта, но не удаления учебников, срок действия аренды на которые истёк.
Настройка интеграции[править]
- В ЭБС Лань надо получить API-токен (token - секретный пароль) http://developers.lanbook.com;
- Включить в ELiS модуль ELiS Lan;
- Ввести в настройках модуля ELiS Lan полученные настройки на сайте https://example.com/admin/config/content/elis_lan.
ELiS настроена, можно приступать к импорту удаленных ресурсов.
Импорт[править]
Вы можете импортировать в ручном режиме и автоматическом.
При ручном режиме обратитесь к документации создания удаленных ресурсов с простановкой корректных ссылок на книги.
При автоматическом импорте:
- создайте папку каталога, в которую произведёте импорт всех изданий плоским списком;
- перейдите в папку и нажмите кнопку "Импорт";
- добавьте к URL "/lanbook" так, чтобы получилось URL вида: https://example.com/node/$nid/import/lanbook, где вместо $nid будет стоять идентификатор ноды каталога в который будет произведён импорт;
- вы увидите команду, которую надо выполнить на сервере для запуска импорта (подключившись к серверу по SSH). Пример команды:
;sudo -u elis php /usr/lib64/elis/drupal/importFromLanbook.php catalogNid=221680 - выполните команду на сервере и дождитесь окончания импорта. В случае сбоя импорта команду можно запустить повторно.
Внимание! Если вы импортируете слишком много книг в один каталог ELiS, этот каталог начнёт медленно открываться или не сможет открыться вообще. Перед автоматическим импортом уточните число импортируемых книг у технической поддержки Лани. Не рекомендуется превышать число импортированных книг больше 100. При импорте более 1000 книг пользователь может не дождаться открытия каталога с таким количеством книг.
Авторизованный в приложении пользователь также окажется авторизован и в ЭБС для чтения удалённых книг:
Кнопка бесшовной авторизации[править]
Вместо встраивания ресурсов, можно создать кнопку бесшовной авторизации, перебрасывающей на главную страницу ЭБС