Skip to content

Latest commit

 

History

History
152 lines (142 loc) · 8.44 KB

README.md

File metadata and controls

152 lines (142 loc) · 8.44 KB
Raw

Модуль рейтинга laravel >= 8.0

Работа с рейтингом на сайте. Вывод и сохранение рейтинга.

Установка модуля с помощью composer

composer require avxman/ratings

Настройка модуля

После установки модуля не забываем объязательно запустить команды artisan: php artisan vendor:publish --tag="avxman-ratings-config", php artisan vendor:publish --tag="avxman-ratings-migrate" и после php artisan migrate. Это установит таблицу рейтинга для получения и сохранения данных.

Команды artisan

  • Выгружаем все файлы
php artisan vendor:publish --tag="avxman-ratings-all"
  • Выгружаем миграционные файлы
php artisan vendor:publish --tag="avxman-ratings-migrate"
  • Выгружаем файлы моделек
php artisan vendor:publish --tag="avxman-ratings-model"
  • Выгружаем шаблонные файлы
php artisan vendor:publish --tag="avxman-ratings-view"
  • Выгружаем конфигурационные файлы
php artisan vendor:publish --tag="avxman-ratings-config"

Методы

Дополнительные (очерёдность вызова метода - первичная)

  • setEnabled() - перезаписываем вкл./откл. рейтинга определённой модели
  • setIp() - перезаписываем Ip адрес пользователя
  • setUserAgent() - перезаписываем User agent пользователя
  • setType() - перезаписываем тип рейтинга
  • setView() - перезаписываем шаблоны рейтинга
  • setModelName() - перезаписываем модель рейтинга
  • setModelUserName() - перезаписываем модель рейтинга пользователя
  • setExceptModel() - перезаписываем исключение моделей, которые не будут участвовать в рейтинге
  • reset() - сбор параметров рейтинга

Инициализация или сохранение рейтинга (очерёдность вызова метода - второстепенная)

  • isError() - найдена ли ошибка или отключён рейтинг
  • getOne() - получение рейтинга одиночного результата из модели
  • getMany() - получение рейтинга множественного результата из модели
  • save() - сохранение рейтинга определённой модели

Вывод (очерёдность вызова метода - последняя, при условии одиночной модели)

  • toCollection() - получаем результат в виде коллекции
  • toArray() - получаем результат в виде массива
  • toJson() - получаем результат в виде json
  • toHtml() - получаем результат в виде html

Использование метода getMany()

При использовании данного метода в классе модели которую привязываем к рейтингу нужно добавить трейт Avxman\Rating\Traits\RatingModelTrait. Когда в модели уже ранее Вами был написан метод rating(), тогда его нужно переименовать, так как трейт использует данный метод

Использование метода save($collection, $isPermission):bool

Метод может наследовать Дополнительные методы (очерёдность первичная) перед вызовом save()
К примеру:
\Avxman\Rating\Facades\RatingFacade::save(collect([ 'model'=>\App\Models\User::class, 'model_id'=>'1', 'rating'=>'1' ]));
\Avxman\Rating\Facades\RatingFacade::save(collect([ 'model'=>\App\Models\AnyModel::class, 'model_id'=>'1', 'rating'=>'1', 'type'=>'five' ]), true);

  • $collection - коллекция входных данных ['model'=>string,'model_id'=>string|int,'rating'=>string|int,'type'=>string]
    model - имя модели;
    model_id - ID модели;
    rating - оценка рейтинга;
    type - тип рейтинга, type_list данные из ключа конфигурационного файла rating.php.
    Обязательных данных ['model','model_id','rating']
  • $isPermission - [false, true]
    false - сохраняем рейтинг, при условии, что рейтинг с указанной моделью уже существует в таблице рейтингов
    true - сохраняем рейтинг в любом случаи, даже при отсутствии модели в таблице рейтингов. При отсутствии - создается новая запись в таблице (будьте осторожны, так как можно записать не существующую модель)
  • return bool - возвращает логический результат, при удачной записи - true

Примеры получения результатов

Вызов в controllers

use App\Models\User;
use Avxman\Rating\Facades\RatingFacade;

//Получаем одиночный рейтинг (только одна модель)
$user = User::with('rating')->first();
RatingFacade::setEnabled(false)->getOne($user);
RatingFacade::setIp('111.111.111.111')->getOne($user);
RatingFacade::setUserAgent('a new user agent')->getOne($user);
RatingFacade::setType('ten')->getOne($user);
RatingFacade::setView('vendor.rating.ten.items', 'vendor.rating.ten._item')->getOne($user);
RatingFacade::setModelName(RatingNewModel::class)->getOne($user);
RatingFacade::setModelUserName(RatingUserNewModel::class)->getOne($user);
RatingFacade::setExceptModel([User::class])->getOne($user);
RatingFacade::reset()->getOne($user);
RatingFacade::isError();
RatingFacade::getOne($user)->toCollection();
RatingFacade::getOne($user)->toArray();
RatingFacade::getOne($user)->toJson();
RatingFacade::getOne($user)->toHtml();

//Получение множественного рейтинга (коллекция из одного типа модели)
//Для работы с множественным рейтингом нужно подключить трейт к модели
//для использования связей (читаем "Использование метода getMany()")
$users = User::with('rating')->get();
RatingFacade::setEnabled(false)->getMany($users, 'toHtml');
RatingFacade::setIp('111.111.111.111')->getMany($users, 'toHtml');
RatingFacade::setUserAgent('a new user agent')->getMany($users, 'toHtml');
RatingFacade::setType('ten')->getMany($users, 'toHtml');
RatingFacade::setView('vendor.rating.ten.items', 'vendor.rating.ten._item')->getMany($users, 'toHtml');
RatingFacade::setModelName(RatingNewModel::class)->getMany($users, 'toHtml');
RatingFacade::setModelUserName(RatingUserNewModel::class)->getMany($users, 'toHtml');
RatingFacade::setExceptModel([User::class])->getMany($users, 'toHtml');
RatingFacade::reset()->getMany($users, 'toHtml');
RatingFacade::getMany($users, 'toCollection');
RatingFacade::getMany($users, 'toArray');
RatingFacade::getMany($users, 'toJson');
RatingFacade::getMany($users, 'toHtml');
$this->result['ratings'] = $users->first()->getRating??'';

Вызов во views

Одиночный рейтинг
// Все вышеуказанные функция одиночного рейтинга работают и в шаблонах
{{RatingFacade::getOne($user)->toHtml()}}
// или
{{RatingFacade::setType('ten')->getOne($user)->toJson()}}
Множественный рейтинг
// Все вышеуказанные функция множественного рейтинга работают и в шаблонах
{{RatingFacade::getMany($users, 'toHtml')}}
// или
{{RatingFacade::setType('ten')->getMany($users, 'toJson')}}