IN Team WP Registry grade A. No security issues foundWP RegistryNo security issues foundOpen the reportA

Версия 1.1

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

Для вывода используется любая страница сайта. В ее слаг (URL) будет дописываться url пользователя команды. Например, есть страница со слагом team. Тогда информация о пользователе ivan будет выведена как /team/ivan/. Если пользователь не входит в роль команды, то будет произведена безусловная переадресация на слаг команды.

Начальная настройка

1. Установите и активируйте плагин.
2. Создайте страницу "Наша Команда" и установите для нее желаемый слаг, например, team.
3. Перейдите в настройки плагина: Пользователи -> Наша команда
4. Укажите созданную вами страницу и роль пользователей, которая должна отображаться, как команда.
5. Обязательно сохраните настройки.

Сортировка сотрудников

По умолчанию сотрудники сортируются по алфавиту по полю display_name. Однако параметрами шорткода inteam_members можно установить произвольную сортировку сотрудников. См. описание шорткода. Для того чтобы включить сортировку в произвольном порядке необходимо установить следующие параметры шорткода:

[inteam_members orderby=meta_value]

В этом случае порядковый номер сотрудника задается в его профиле в поле Порядок сортировки.

ВАЖНО! Сотрудники с незаданными или пустыми номерами сортировки в этом случае НЕ ВЫВОДЯТСЯ!

Аватары -- фотографии пользователей

Для вывода фотографий плагин использует стандартную функцию get_avatar(). Пользователи могут изменить свои фотографии следующим образом:

1. Зарегистрироваться и установить фото для своих E-mail на сайте gravatar.com. (рекомендуется).
2. Используя плагины управления аватарами на сайте, например:
   • ProfilePress
   • PublishPress Authors
   • и другие

Шаблоны плагина

Для вывода информации плагин использует следующие шаблоны:

• profile.php -- вывод информации о сотруднике на странице сотрудника
• member.php -- вывод карточки сотрудника на странице "Наша команда"

Шаблоны находятся в папке плагина templates и могут быть переопределены темой. Для этого их надо скопировать в папку your_theme/in-teams и далее редактировать их там.

Шорткоды

Плагин определяет несколько шорткодов:

inteam_members -- вывод списка сотрудников по указанной в настройках роли

Возможные параметры шорткода:

• before -- Вывод любой строки перед результатом
• after -- Вывод любой строки после результата
• number -- Число возвращаемых пользователей, по умолчанию -- 20
• paged -- Номер страницы списка возвращаемых пользователей
• paged -- Запрос для поиска пользователей, например, Иван* или *Викторович или *Виктор*
• orderby -- способ сортировки сотрудников. Возможные значения:
  • nicename -- Сортировка по имени
  • display_name -- Сортировка по отображаемому имени (Используется по умолчанию)
  • email -- Сортировка по E-mail
  • url -- Сортировка по URL
  • registered -- Сортировка по дате регистрации
  • post_count -- Сортировка по количеству записей
  • meta_value -- Сортировка по произвольному мета-полю пользователя
• meta_key -- Какое мета-поле используется для сортировки. По умолчанию sort_order
• order -- Порядок сортировки. По умолчанию ASC

Пример шорткода

[inteam_members number=30]

inteam_field -- вывод отдельного поля любого сотрудника

Возможные параметры шорткода:

• field -- Поле для вывода
• before -- Вывод любой строки перед результатом
• after -- Вывод любой строки после результата
• user_id -- ID пользователя

Пример шорткода

[inteam_field field="position" user_id="123"]

Дополнительные поля профиля пользователя

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

• position -- должность сотрудника
• work_phone -- рабочий телефон
• telegram -- аккаунт в Телеграмме
• sort_order -- порядок сортировки

Список полей можно изменить с помощью хука inteam_extra_fields, например:

add_filter( 'inteam_extra_fields', 'my_inteam_extra_fields' );
function my_inteam_extra_fields( $fields ) {
    // Удалим Телеграмм
    unset( $fields[ 'telegram' ] );

    // Добавим WhatsApp
    $fields[ 'whatsapp' ] = 'Аккаунт WhatsApp';

    return $fields;
}

Хуки плагина

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

Формирование произвольных подстраниц на странице члена команды

Начиная с версии 1.1 плагин может формировать любые подстарницы автора (члена команды) по типу

• /team/author/bio/
• /team/author/contacts/
• /team/author/info/

Отображение таких страниц ПОЛНОСТЬЮ управляется шаблоном profile.php. Чтобы сформировать отдельный вывод подстраницы, необходимо получить ее слаг (часть URL) следующим кодом:

$subpage = get_query_var( 'subpage' );

Для указанных примеров URL выше это будут значения:

• bio
• contacts
• info

Для программно выводятся нужные компоненты, например:

<?php if ( 'bio' == $subpage ): ?>
  <?php
    /**
     * inteam_before_user_description hook
     */
    do_action( 'inteam_before_user_description' );
  ?>    
  <div class="member__descr">
    <h3>Биография</h3>
    <?php echo apply_filters('inteam_user_description' , $user->user_description, $user ); ?>
  </div>
  <?php
    /**
     * inteam_after_user_description hook
     */
    do_action( 'inteam_after_user_description' );
  ?>
<?php endif; ?>