PHPackages                             nepster-web/yii2-faceviewer-widget - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. nepster-web/yii2-faceviewer-widget

ActiveYii2-widget[Utility & Helpers](/categories/utility)

nepster-web/yii2-faceviewer-widget
==================================

Виджет для отображения представления пользователя

v1.0.1(10y ago)72944BSD-3-ClausePHP

Since Mar 7Pushed 10y ago2 watchersCompare

[ Source](https://github.com/nepster-web/yii2-faceviewer-widget)[ Packagist](https://packagist.org/packages/nepster-web/yii2-faceviewer-widget)[ RSS](/packages/nepster-web-yii2-faceviewer-widget/feed)WikiDiscussions master Synced 3d ago

READMEChangelogDependencies (1)Versions (3)Used By (0)

FaceViewer Widget for Yii 2
===========================

[](#faceviewer-widget-for-yii-2)

Виджет для отображения представления пользователя (например аватарки или фотографии).
FaceViewer может быть полезен, в случае, когда необходимо показывать представление пользователей по различным шаблонам и делать это частно. Например: аватарки в сообщениях пользователей, фотографии в отзывах, изображение профиля и др.

Пример отображения
------------------

[](#пример-отображения)

[![alt text](images/15fi39d.jpg.png)](images/15fi39d.jpg.png)

Установка
---------

[](#установка)

Предпочтительный способ установки этого виджета через [composer](http://getcomposer.org/download/).

Запустите в консоле

```
php composer.phar require --prefer-dist nepster-web/yii2-faceviewer-widget "*"

```

или добавьте

```
"nepster-web/yii2-faceviewer-widget": "*"

```

в файл `composer.json` в секцию require.

Конфигурации
------------

[](#конфигурации)

**Все настройки:**

`template` - Шаблон представления. Может принимать как строку, так и callback функцию.

{face} - Приобразуется в изображение.

Дополнительные атрибуты должны соответствовать атрибутам в `data`. Например, если указать в шаблоне {name}, то поиск значения name будет выполнен либо в массиве `data`, либо в атрибутах модели пользователя, если указан его идентификатор (`userId`).

`templateUrl` - Заключает шаблон представление в URL адрес.

`templateUrlOptions` - Если шаблон представления заключен в URL адрес, то можно добавить любые атрибуты к ссылке.

`data` - Массив данных, которые подставляются в шаблон ({name} будет соответствовать $data\['name'\]).

`userId` - Если мы работаем с пользователями, то вместо `data` можно указать идентификатор пользователя, тогда faceviewer сам получит всю необходимую информаци.

`userModel` - неймспейс модели пользователя.

`userProfileRelated` - название реляции на профиль пользователя.

`userModelAttributes` - Атрибуты пользователя, которые будут получены при запросе.

`faceField` - Название атрибута, который указывает на изображение (Например: avatar\_url).

`facePath` - Полный путь к директории, например с аватарками (@statics/uploads/avatars).

`faceUrl` - URL адрес к папке, например с аватарками (/statics/uploads/avatars).

`faceUrlDefault` - URL адрес к папке, например с аватарками по умолчанию (/statics/templates/default/avatars).

`faceDefault` - Имя изображения по умолчанию, например аватарки (no-avatar.png).

`faceSexField` - Название атрибута, который указывает на пол (Например: sex).

`faceSexDefaultAvatar` - Изображения по умолчанию на основе пола пользователя (Например \[1 => 'male.png', 2 => 'female.png'\]).
Где 1 - Мужской пол, 2 - Женский пол. В качестве идентификатора 1 или 2 выступает поле указанное в `faceSexField`.

`faceImgOptions` - Атрибуты изображения.

`onlyUrl` - Вернуть только изображение без дополнительных тегов.

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

```