UserBox 1.5.1 : вывод информации о любом пользователе в любом месте сайта

Модуль будет полезен тогда, когда нужно вывести информацию о каком-либо пользователе в произвольном месте сайта. Например кулинарным сайтам, где нужно вывести информацию об авторе рецепта непосредственно в рецепт или личным (коллективным) блогам.


Возможности:

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

Особенности:

• Одна обязательная переменная в строке подключения - &userName. Именно через эту переменную модуль определяет для какого юзера выводить информацию.
  
• Добавляет один запрос на каждого выводимого модулем пользователя. Т.е. если выводить информацию об авторе новости в кратких новостях и на главной странице сайта выводится 30 новостей, которые опубликовали 10 пользователей (по три новости каждый) - то модуль при первом обращении к странице добавит 10 запросов в БД, после чего данные будут браться уже из кеша (при включенном кешировании на сайте). Если на второй странице попадётся пользователь с первой страницы, то запрос в БД на этого пользователя делаться не будет.
  
• Собственные теги для вывода в шаблоне. Отдельные теги сделаны для того, что бы не было конфликтов и для упрощения обработки этих тегов в модуле, что сократило кода процентов на 10-15 точно.
  
• Собственная папка с шаблонами. Так же для удобства использования.
  
• Выводятся не все данные. Т.к. выводить все данные о пользователе не имеет смысла, а так же в целях экономии ресурсов сервера выводятся следующие данные:
  
  1. email - Email пользователя
     
  2. name - Логин
     
  3. news_num - Кол-во новостей
     
  4. user_id - ID пользователя
     
  5. comm_num - Кол-во комментариев
     
  6. user_group - Группа (форматированный вывод с префиксами и суффиксами)
     
  7. lastdate - Дата последнего посещения сайта
     
  8. reg_date - Дата регистрации
     
  9. info - Информация о пользователе
     
  10. foto - URL аватарки (или настраиваемая заглушка)
      
  11. fullname - Полное имя
      
  12. land - Место проживания
      
  13. icq - Номер ICQ
      
  14. Дополнительные поля

Полный список поддерживаемых модулем UserBox тегов приведён в шаблоне userbox/dafault.tpl.

Установка:
1. Распаковать содержимое папки upload из архива в корень сайта, при этом не забыть переименовать папку THEME в соответствии с названием текущего шаблона сайта.

2. В нужном месте любого шаблона сайта прописать:

{include file="engine/modules/userbox.php?&userName=login"}

где login - логин пользователя.

Готово!


Примеры использования:

{include file="engine/modules/userbox.php?&userName={login}"}

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

{include file="engine/modules/userbox.php?&userName=this"}

Выведет информацию о текущем пользователе, эту конструкцию можно использовать для вывода информации о текущем пользователе вне шаблона login.tpl.

{include file="engine/modules/userbox.php?&userName=thisNewsId"}

Выведет информацию об авторе новости при просмотре полной новости (при этом добавится один запрос). Подобная конструкция нужна на случай вывода вне шаблона полной новости (например в main.tpl). При выводе в шаблоне полной новости используйте
&userName={login}

{include file="engine/modules/userbox.php?&userName=Бот&template=newtemplate&defAvatar=images/picture.jpg"}

Выведет информацию о пользователе с логином Бот, для вывода будет использован шаблон, лежащий в папке userbox/newtemplate.tpl, при этом если у пользователя нет аватарки (или не задан gravatar в настройках) - будет выведено изображение из папки images/picture.jpg.


• Версия DLE: 9.8-10.х
• Кодировка: utf-8
• Автор: ПафНутиЙ
• Источник