- get_avatar() – возвращает аватар пользователя
- Примеры
- get_avatar_data() WP 4.2.0
- Возвращает
- Использование
- Вывести фотографию автора в WordPress
- Как поставить плагин user photo
- Как включить отображения блока об Авторе в WordPress
- Как назначить фотографии и описание автора в WordPress
- get_avatar() WP 2.5.0
- Возвращает
- Использование
- Примеры
- #1. Выведем Аватар текущего комментатора:
- #2 Вывод аватара автора текущего поста
- #3 Добавление атрибута stylе
- #4 Вариант аватарки по умолчанию в настройки обсуждения
- #5 Аватар по умолчанию
get_avatar() – возвращает аватар пользователя
Наглядный пример использования этой функции вы можете найти в моём видеоуроке.
Если быть точными, то функция возвращает тег аватара (Gravatar) для пользователя.
Если вы пока что немного не в теме (но надеюсь я ошибаюсь), WordPress.org, WordPress.com, также и другие движки/сервисы используют сервис Gravatar для унификации аватаров юзеров, суть заключается в том, что вы используете разные сервисы в интернет, а аватар у вас везде один и не нужно напрягаться, чтобы каждый раз его ставить.
Это было небольшое отступление.
$id_or_email О, этот параметр поддерживает много чего:
- Так как граватары регаются на емайл, то прежде всего вы можете передать сюда любой емайл, не обязательно этот емайл должен быть зарегистрирован на сайте.
- ID пользователя или объект WP_User – тогда будет использован емайл из профиля пользователя.
- MD5 хэш, который использует граватар (ведь он же не может палить емайлы своих пользователей).
- Объект WP_Post – тогда будет взят емайл автора поста.
- Объект WP_Comment – соответственно емайл автора коммента.
$size (целое) ширина и высота картинки в пикселях. $default (целое) Что следует отображать в качестве аватара, если у пользователя его нет (он не зареган в Gravatar). По умолчанию отображается то, что указано в Настройки > Обсуждение в админке WordPress:
Соответственно вы можете перезаписать эту настройку и передавать в функцию get_avatar() , параметр $default одно из следующих значений:
- mystery , mm или mysterman – Человек-загадка
- 404 – Пустой,
- gravatar_default – Логотип Gravatar,
- indenticon – Identicon,
- wavatar – Wavatar,
- monsterid – MonsterID,
- retro – Ретро.
$alt (строка) Какой текст указывать в качестве alt атрибута теги img. По умолчанию он есть и имеет пустое значение. $args (массив) Ещё целый набор параметр, и вот каких: height (целое) Можно отдельно указать значение высоты в пикселях, по умолчанию равно значению параметра $size width (целое) Можно отдельно указать значение ширины в пикселях, по умолчанию равно значению параметра $size force_default (логическое) Если установить значение этго параметра true , то можем зафорсить отображение монстриков стандартных Gravatar, и не выводить фотки самих пользователей. По умолчанию равен false , кэп. scheme (строка) Протокол URL, который будет использоваться по умолчанию, например http , https и т.д. Предполагаю, что лучше не шаманить и использовать значение по умолчанию. Хотя возможно в вашей ситуации этот параметр может и понадобиться. class (массив|строка) А ещё мы можем вкинуть CSS-классов в выводимый тег – один или несколько в виде массива. force_display (логический) Если указать true , то аватары будут отображаться всегда и значение этой опции в Настройки > Обсуждение будет игнорироваться: extra_attr (строка) Можно вкинуть дополнительные атрибуты в тег , например title=»привет» , единственное только учтите, что внутри функции это никак не очищается и в некоторых ситуациях вам не помешает воспользоваться функцией esc_attr() ко всему причему. rating (строка) Тут суть в том, что когда люди закидывают свои фото в сервис Gravatar, они могут выбрать рейтинг – G, PG, R или X – ведь мы знаем, как это бывает – по-любому кто-то захочет использовать в качестве аватара дик. По сути этот параметр позволяет переопределить значение из настроек обсуждения:
Примеры
Самый изишный пример – попробуем вывести аватар пользователя с и высотой/шириной в 50px:
А теперь значительно усложним этот пример, для начала сделаем так, чтобы это был аватар текущего пользователя – для этого получим при помощи get_current_user_id() его ID и передадим в функцию:
Источник
get_avatar_data() WP 4.2.0
Получает массив данных об аватаре, по переданному email, ID, объекту пользователя, объекту поста или комментария.
Эта функция не проверят если ли реально аватар, она просто собирает URL на сервис gravatar.com. Чтобы проверить если ли у email аватар, вам нужно отдельно обработать полученный URL. Нужно указать в default 404, затем получить URL и попробовать получить картинку по этому URL через get_headers(). Если ответ вернет 404, то аватарки у email нет.
Смотрите также функцию get_avatar().
Хуки из функции
Возвращает
Массив . Массив данных полученного аватара. Массив будет содержать все переданные в параметр $args данные а также дополнительные поля:
‘found_avatar’ — (логический) true — если аватар пользователя найден, false или пусто — если не найден.
Возвращаемый параметр ‘found_avatar’ определен всегда, когда удалось получить картинку аватара, даже если параметр default=404. ‘found_avatar’ не указывает на то, есть ли у пользователя реальный аватар.
Использование
Идентификатор по которому будет определяться аватар. Может быть:
- email — asd@asd.ru
- gravatar md5 хэш (md5 хэш мыла)
- ID пользователя — получит аватар пользователя по мылу
- WP_User объект — получит аватар пользователя по мылу
- WP_Post объект — получит аватар автора поста
- WP_Comment объект — получит аватар комментатора
$args(массив)
Параметры получаемого аватара. По умолчанию:
- size(число)
Высота и ширина аватара в пикселях.
По умолчанию: 96
default(строка)
УРЛ на картинку по умолчанию — если не удалось получить аватар. Вместо УРЛ можно указать следующие значения:
- 404 — вернет 404 вместо дефолтной картинки.
- retro — пиксельная картинка 8bit:
- monsterid — монстрик:
- wavatar — мульт лицо:
- indenticon — картинка-узор:
- mystery , ‘mm’ или ‘mysterman’ — неизвестный человек:
- blank — прозрачная GIF картинка.
- gravatar_default — логотип Gravatar:
По умолчанию: значение опции ‘avatar_default’ или ‘mystery’
force_default(логический)
Ставим true, если нужно всегда показывать дефолтную картинку и не показывать аватары совсем.
По умолчанию: false
rating(строка)
Максимально допустимый рейтинг выводимой аватарки. Может быть:
- G — Подходит для любой аудитории;
- PG — Может содержать оскорбительные элементы, обычно для аудитории старше 13 лет;
- R — Рассчитан на взрослую аудиторию старше 17 лет;
- X — Для ещё более зрелой аудитории;
По умолчанию: значение опции ‘avatar_rating’
scheme(строка)
Схема УРЛ, которая будет использоваться. Может быть: ‘http’, ‘https’, ‘login’, ‘login_post’, ‘admin’, or ‘relative’. Подробнее смотрите функцию set_url_scheme() .
По умолчанию: null
processed_args(массив)
Дополнительные опции для передачи. При фильтрации и возврате данных функцией get_avatar_data() эти параметры будут добавлены в возвращаемый массив.
По умолчанию: null
HTML атрибуты для добавления к элементу IMG. Не очищаются.
По умолчанию: »
Источник
Вывести фотографию автора в WordPress
В статье об монетизации сайта с помощью обращений посетителей я рассказал что блок «об авторе» и фотография автора это необходимы атрибуты для того чтобы посетители обращались к вам за помощью и подключали к своим проектам. А брать деньги или нет, это конечно ваше дело :-). В этой статье я расскажу как вывести фотографию автора под каждой статьей и как назначить описание.
Для того чтобы поставить аватарку автора, нам надо будет сделать три вещи.
- Поставить плагин user photo
- Включить блок «об авторе»
- Назначить фотографии и описание
Начнем как всегда с самого простого.
Как поставить плагин user photo
- Скачайте архив с плагином. Разархивировать его не надо
- Заходим в админ панель нашего сайта
- Переходим в левом меню по маршруту «Плагины->Добавить новый»
- Перейдите на вкладочку «Загрузить» как показно на картинке ниже
- Установите и активируйте плагин.
Все. Плагин мы поставили. Осталось только чуть его донастроить. Для этого:
- Все в том же левом меню перейдите на вкладочку «Параметры->User Photo»
- Максимальный размер и Размер тамбнейла укажите на ваше усмотрение, но чтобы они гармонично вписались в ваш блог
- Галчоки Serve Avatar as Fallback и Override Avatar with User Photo обязательно поставьте, иначе аватарки автора будут загружаться, но вот отображаться нет.
- В следующем пункте рекомендую выбрать вашу учетную запись чтобы вам на почту падали уведомления, если чей-то аватар надо промодерировать. Это сделано для того чтобы пользователи не вешали на аватарки нецензурные картинки, которые будут вредить конверсии вашего сайта. Также чуть ниже вы можете выбрать для какого типа учетной записи надо модерировать, а какие учетные записи могут самостоятельно выставлять их себе. Про роли и как их назначать вы можете прочитать в статье добавление нового пользователя в WordPress
После того как вы внесли все изменения не забудьте сохранить их нажав на кнопку «Update optoins»
Как включить отображения блока об Авторе в WordPress
После того как мы разобрались с установкой плагина который нам поможет выводить фотографии нам осталось сделать всего две простые вещи, которые уже встроены в движок WordPress. Первая связанна с админ панелью — включить вывод фотографии и описания. Вторая связанна с внешней частью сайта — назначить фотографию автора и написать описание — краткую биографию. В этом абзаце мы включим вывод блока, а уже в следующем назначим описание и фотку. Итак:
- В админ панели перейдите в «Внешний вид->Опции темы»
- Перейдите на вкладку страница с записью и включите ползунок «об авторе» как показано на картинке ниже
- Нажмите на кнопку «Сохранить изменения»
Если мы все сделали правильно, то под каждой статьей вы увидите блок «об авторе», но пока что фотографии нет, да и описание пустое. Но мы это сейчас быстро исправим.
Как назначить фотографии и описание автора в WordPress
Мы с вами прошли самые тяжелое технические шаги и нам остался последний рывок. На цей раз никаких технический заморочек, а только голое творчество, что мы в принципе и любим делать, ведь не зря мы ведем свои блоги.
- Заходите в «Пользователи->Все пользователи»
- Нведите на себя и нажмите на кнопку «изменить» которая должна появиться.
- Нас интересует всего два поля — первый «Биография» где мы пишем про себя
- И поле в самом низу «Ваше фото». С помощью него мы сможем выбрать картинку которая и будет нашей аватаркой.
Как я уже писал в статье монетизации сайта с помощью обращений посетителей к своей фотографии и описании на блоге нужно подойти со всей серьезностью, потому что именно это поле дает представление что представляет из себя автор. Поэтому если ваш ресурс на спортивную тематику то имеет смысл повесить себя в тренажерном зале или с голым торсом. Если же у вас бизнес ресурс то понятное дело что фотография должна быть официальной. Не допускаются всякие кошечки, собачки и прочие картинки. Если конечно вы не хотите скрыть свое лицо или вас не очень итересуют обращение ваших посетителей с предложением проектов, как к примеру мне.
С такой же ответственностью нужно подойти и к описанию. В нем лучше всего написать ваши сертификаты, регалии, увлечения, достижения и прочую информацию которая поможет вашим посетителям понять что вы профессионал высокого уровня.
Как вседа если у вас остались вопросы и пожелания вы можете написать комментарий или email (его вы можете найти в разделе контакты)
Источник
get_avatar() WP 2.5.0
Получает html код аватара ( ) комментатора, если пользователь авторизирован или указал email при комментировании. Обычно используется в разделе комментариев.
Используется внутри Цикла комментариев или обязательно нужно передать первый параметр!
Используйте фильтр get_avatar, когда нужно изменить результат функции.
Это pluggable функция — т.е. её можно заменить из плагина. Это значит, что она будет работать (подключается) только после подключения всех плагинов, а до этого момента функция еще не определена. Поэтому нельзя вызывать эту и зависящие от неё функции прямо из кода плагина. Их нужно вызывать через хук plugins_loaded или позднее, например хук init.
Замена функции (переопределение) — в плагине можно создать функцию с таким же названием, тогда она заменит текущую функцию.
Хуки из функции
Возвращает
Строку|false . HTML тег . false если не удалось отправить запрос. Если нет аватара, но запрос отправился, то вернет аватарку по дефолту — не false.
Использование
ID или email юзера, для которого нужно получить аватар. Также можно указать объекты: WP_User , WP_Post , WP_Comment или md5 хэш gravatar.
В большинстве шаблонов в этом параметре можно указать глобальную переменную $comment . Если функция не работает (вызывает ошибку), то запишите в неё email комментатора, например:
$size(число) Размер картинки. Указанное число станет шириной и высотой в пикселях.
По умолчанию: 96 $default(строка)
УРЛ на картинку по умолчанию, для пользователей, которые не имеют аватарки в сервисе gravatar.
- 404 — вернет 404 вместо дефолтной картинки.
- retro — пиксельная картинка 8bit:
- monsterid — монстрик:
- wavatar — мульт лицо:
- indenticon — картинка-узор:
- mystery , ‘mm’ или ‘mysterman’ — неизвестный человек:
- blank — прозрачная GIF картинка.
- gravatar_default — логотип Gravatar:
По умолчанию: » (значение опции ‘avatar_default’ или ‘mystery’)
$alt(строка) Текст для атрибута ‘alt’ тега .
По умолчанию: » $args(массив)
Дополнительные аргументы для получения аватара:
- height — Число. Высота в пикселях. По умолчанию $size .
- width — Число. Ширина в пикселях. По умолчанию $size .
- force_default — Логический. Всегда показывать дефолтную картинку и никогда аватар.
- rating — Строка. Минимальный рейтинг аватара для отображения. Может быть: ‘G’, ‘PG’, ‘R’, ‘X’. По умолчанию значение опции ‘avatar_rating’.
- scheme — Строка. Схема URL которая будет использоваться. Смотрите set_url_scheme() .
- class — Массив/строка. Дополнительные классы для тега img.
- force_display — Логический. Всегда показывать аватар? Игнорирует опцию show_avatars.
- extra_attr — Строка. Дополнительные HTML атрибуты для тега IMG. Не очищаются перед выводом на экран.
- loading — Строка lazy .
По умолчанию: null
Примеры
#1. Выведем Аватар текущего комментатора:
#2 Вывод аватара автора текущего поста
#3 Добавление атрибута stylе
Параметр ‘extra_attr’ позволяет добавлять любые атрибуты тега IMG:
#4 Вариант аватарки по умолчанию в настройки обсуждения
Это код добавления еще одной картинки (опции) в настройках обсуждения, которую можно выбрать как аватарку по умолчанию. Такая аватарка хранится в опции get_option(‘avatar_default’) .
В результате получим такую дополнительную опцию:
#5 Аватар по умолчанию
Если для прошлого варианта, нужно добавить хук, потом зайти в настройки и выбрать дефолтный аватар, то этот вариант установит аватарку по дефолту сразу же.
Этот вариант устанавливает аватар по умолчанию «налету», для функций: get_avatar_url() и get_avatar_data(). Дефолтный аватар будет установлен только если в функции не указан дефолтный аватар, т.е. не установлен параметр ‘default’.
Источник