oreolek
/
yii2-private-messages
Архивировано
1
0
Форкнуть 0
Yii2Private messages, simple chat
This repository has been archived on 2024-03-18. You can view files and clone it, but cannot push or open issues or pull requests.
Перейти к файлу
Alexander Yakovlev 2f1d354227 Namespace / composer fix 2016-02-24 21:10:16 +07:00
actions Namespace / composer fix 2016-02-24 21:10:16 +07:00
assets Namespace / composer fix 2016-02-24 21:10:16 +07:00
components Namespace / composer fix 2016-02-24 21:10:16 +07:00
events Namespace / composer fix 2016-02-24 21:10:16 +07:00
exceptions Namespace / composer fix 2016-02-24 21:10:16 +07:00
migrations fix error group send 2015-07-02 20:54:24 +03:00
models Namespace / composer fix 2016-02-24 21:10:16 +07:00
web CSS for our design 2016-02-24 21:05:40 +07:00
widgets Namespace / composer fix 2016-02-24 21:10:16 +07:00
.gitignore add actions, component, events, exception 2015-06-02 11:51:24 +03:00
README.md Namespace / composer fix 2016-02-24 21:10:16 +07:00
composer.json Namespace / composer fix 2016-02-24 21:10:16 +07:00

README.md

Private messages

Private messages

Приватные сообщения (не чат).

Обновление сообщений при отправке или в фоне каждые 30 секунд (это можно изменить в "vendor\oreolek\yii2-private-messages\js\private_mess_pooling.js"). Есть возможность отправлять копию сообщения на email пользователя. Возможен режим когда пользователи будут видеть и смогут писать сообщения только указанным администраторам. Также возможно в фоне проверять кол-во новых сообщений + их авторов.

скрин http://prntscr.com/8mmqed или http://prntscr.com/7dt6tf

Установка

Выполните

php composer.phar require --prefer-dist vision/yii2-private-messages "dev-master"

или добавьте в ваш composer.json

"vision/yii2-private-messages": "dev-master"

Использование

После установки расширения необходимо выполнить миграцию:

yii migrate --migrationPath=@vendor/vision/yii2-private-messages/migrations/

В контроллере через который будут передаваться данные добавляем action

    public function actions()
    {
        return [
            'private-messages' => [
                'class' => \oreolek\messages\actions\MessageApiAction::className()
            ]
        ];
    }

Далее прописываем в конфиге:

'components' => [...
        'mymessages' => [
                //Обязательно
            'class'    => 'oreolek\messages\components\MyMessages',
                //не обязательно
                //класс модели пользователей
                //по-умолчанию \Yii::$app->user->identityClass
            'modelUser' => 'common\models\User',
                //имя контроллера где разместили action
            'nameController' => 'site',
                //не обязательно
                //имя поля в таблице пользователей которое будет использоваться в качестве имени
                //по-умолчанию username
            'attributeNameUser' => 'username',
                //не обязательно
                //можно указать роли и/или id пользователей которые будут видны в списке контактов всем кто не подпадает 
                //в эту выборку, при этом указанные пользователи будут и смогут писать всем зарегестрированным пользователям
            'admins' => ['admin', 7],
                //не обязательно
                //включение возможности дублировать сообщение на email
                //для работы данной функции в проектк должна быть реализована отправка почты штатными средствами фреймворка
            'enableEmail' => true,
                //задаем функцию для возврата адреса почты
                //в качестве аргумента передается объект модели пользователя
            'getEmail' => function($user_model) {
                return $user_model->email;
            },
                //задаем функцию для возврата лого пользователей в списке контактов (для виджета cloud)
                //в качестве аргумента передается id пользователя
            'getLogo' => function($user_id) {
                return '\img\ghgsd.jpg';
            },
                //указываем шаблоны сообщений, в них будет передаваться сообщение $message
            'templateEmail' => [
                'html' => 'private-message-text',
                'text' => 'private-message-html'
            ],
                //тема письма
            'subject' => 'Private message'
        ],
    ...]

Для работы достаточно во вьюхе вывести виджет

<?= oreolek\messages\widgets\CloadMessage::widget() ?>

или

<?= oreolek\messages\widgets\PrivateMessageKushalpandyaWidget::widget() ?>

Если необходимо в фоне проверять новые сообщения мы можем зарегестрировать oreolek\messages\assets\PrivateMessPoolingAsset

и добавить нужный нам слушатель

<?php
$base_script = "var baseUrlPrivateMessage ='" . \Yii::$app->mymessages->nameController . "';";
$this->registerJs($base_script, yii\web\View::POS_BEGIN);
?>

<script>
var listener = new privateMessPooling();
listener.addListener('newData', function(result){
    console.log(result);
});
listener.start();
</script>