vis/image_storage_l5

Image storage for L5

Wednesday, January 17, 2018
by KGluschenko
Repository
1 Watchers
0 Stars
202 Installations

PHP
0 Dependents
0 Suggesters
1 Forks
0 Open issues
55 Versions
4 % Grown

The README.md

Image Storage

Пакет-медиахранилище для Laravel 5.4 предназначенный работы с изображением, видео и документами., _(*1)

Разделы 1. Установка 2. VIS-CMS 3. Настройка конфигов 1. Конфиг изображений 2. Конфиг документов 3. Конфиг видео * Конфиг видео API 4. Спецификация и примеры 1. Общая спецификация 3. Использование изображений 4. Использование фотогалереи 5. Использование документов 6. Использование видео * Использование видео API 7. Использование видеогалереи 8. Использование тэгов 5. Кэширование 6. Особенности управление в VIS CMS 1. Общее управление 2. Общее управление для изображений, видео и документов 1. Управление изображениями 2. Управление видео 3. Управление документами 3. Общее управление для фотогалерей и видеогалерей, _(*2)

Установка

Выполняем, _(*3)

    composer require "vis/image_storage_l5":"1.*"

Добавляем в config\app.php в массив providers, _(*4)

    Vis\ImageStorage\ImageStorageServiceProvider::class,

Выполняем миграцию таблиц, _(*5)

   php artisan migrate --path=vendor/vis/image_storage_l5/src/Migrations

Публикуем config, js, css, images, _(*6)

    php artisan vendor:publish --provider="Vis\ImageStorage\ImageStorageServiceProvider" --force

VIS-CMS

В файле config/builder/admin.php в массив menu в настройки добавляем, _(*7)

    array(
      'title' => 'Медиахранилище',
      'icon'  => 'picture-o',
      'check' => function() {
          return Sentinel::hasAccess('admin.image_storage.view');
      },
      'submenu' => array(
          array(
              'title' => "Изображения",
              'link'  => '/image_storage/images',
              'check' => function() {
                  return Sentinel::hasAccess('admin.image_storage.view');
              }
          ),
          array(
              'title' => "Галереи",
              'link'  => '/image_storage/galleries',
              'check' => function() {
                  return Sentinel::hasAccess('admin.image_storage.view');
              }
          ),
          array(
              'title' => "Видео",
              'link'  => '/image_storage/videos',
              'check' => function() {
                  return Sentinel::hasAccess('admin.image_storage.view');
              }
          ),
          array(
              'title' => "Видеогалереи",
              'link'  => '/image_storage/video_galleries',
              'check' => function() {
                  return Sentinel::hasAccess('admin.image_storage.view');
              }
          ),
          array(
              'title' => "Документы",
              'link'  => '/image_storage/documents',
              'check' => function() {
                  return Sentinel::hasAccess('admin.image_storage.view');
              }
          ),
          array(
              'title' => "Теги",
              'link'  => '/image_storage/tags',
              'check' => function() {
                  return Sentinel::hasAccess('admin.image_storage.view');
              }
          ),
      )
    ),

Добавляем права доступа в config/builder/tb-definitions/groups.php и добавляем их к группам., _(*8)

    'Медиахранилище' => array(
        'admin.image_storage.view'   => 'Просмотр',
        'admin.image_storage.create' => 'Создание',
        'admin.image_storage.update' => 'Редактирование',
        'admin.image_storage.delete' => 'Удаление',
    ),

Настройка конфигов

Все конфиги содержат 3 основных настройки:, _(*9)

Настройка title указывающее на имя раздела отображаемое в VIS-CMS, _(*10)

    'title' => "Галереи",

Настройка per_page указывающее количество записей отображаемых на странице в VIS-CMS, _(*11)

    'per_page' => 20,

Настройка fields соддержащее набор полей, которые будут выводиться в форме редактирования записи. Значения: text, textarea,checkbox, select, datetime. Определяются как и в VIS-CMS. Поддерживается динамическое создание новых полей и табов, _(*12)

    'fields' => array(
        ...
    ),

Конфиг изображений

Настройки валидации загружаемых изображений. В ошибки автоматически подставляются значения 'max_size' и 'extension_list', _(*13)

    'size_validation' => array(
        'enabled' => true,
        'max_size' => '1500000',
        'error_message' => "Превышен максимальный размер изображения в [size] MB"
    ),
    'extension_validation' => array(
        'enabled' => true,
        'allowed_extensions' => array('png', 'jpg', 'jpeg'),
        'error_message' => "Допустимы только изображения форматов: [extension_list]"
    ),

Настройка качества для загружаемых JPG изображений. Значение: 0-100, _(*14)

    'quality' => 85,

Настройка использования класса Vis\Builder\OptimizationImg для оптимизации загруженных изображений. Значение: true\false, _(*15)

    'optimization' => true,

Настройка использования исходного названия изображения для поля title. Значение: true\false, _(*16)

    'source_title' => true,

Настройка хранения метаданных изображения в базе данных. Применятся функция exif_read_data, данные хранятся в формате json. Значение: true\false, _(*17)

    'store_exif' => true,

Настройка удаления файлов изображений при удалении сущности изображения. Значение: true\false, _(*18)

    'delete_files' => true,

Настройка переименования файлов изображений при переименовании сущности изображения. Значение: true\false, _(*19)

    'rename_files' => true,

Настройка отображения кнопки генерации новых размеров для записей. Применяется при необходимости сгененировать новый размер для уже существующих записей. Значение: true\false, _(*20)

    'display_generate_new_size_button' => true,

Настройка генерируемых размеров изображений. Позволяет при загрузке изображений автоматически генерировать изображение в других размерах. Использует пакет для работы с изображениями Intervention. Модифицировать изображение можно в помощью настройки Modify принимающей параметры Intervention, _(*21)

    'sizes' => array(
        'source' => array(
            'caption' => 'Оригинал',
            'default_tab' => true,
        ),
        'cms_preview' => array(
            'caption' => 'Превью в ЦМС',
            'default_tab' => false,
            'modify' => array(
                'fit' => array(160, 160, function (\Intervention\Image\Constraint $constraint) {
                    $constraint->upsize();
                }),
            ),
        ),

Конфиг документов

Все параметры настройки аналогичны изображениям, кроме Настройка позволяющая хранить несколько файлов под одной сущности "документа". Может быть использовано когда необходимо выводить разные файлы на разных языках сайта При загрузке документа во все размеры устанавливается ссылка на исходный файл, которую потом можно заменить, _(*22)

    'sizes' => array(
        'source' => array(
            'caption' => 'Основной файл',
            'default_tab' => true,
        ),
        'ua' => array(
            'caption' => 'Файл на укр',
            'default_tab' => false,
        ),
        'en' => array(
            'caption' => 'Файл на англ',
            'default_tab' => false,
        ),

    ),

Конфиг видео

В массиве настройки fields два обязательных поля отвечающие за сервис и идентификатор видео, _(*23)

    'api_provider' => array(
        'caption' => 'Видео сервис',
        'type' => 'select',
        'options' => config('image-storage.video_api.provider_names')
    ),
    'api_id' => array(
        'caption' => 'Идентификатор видео',
        'type' => 'text',
        'field' => 'string',
        'placeholder' => 'Идентификатор видео',
    ),

Конфиг видео API

Настройка управляющая отправление запрос к видео API, которые требуют ключи Значение: true\false, _(*24)

    'enabled' => true,

Настройка времени кэширования ответа от видео API Значение: x, 0 (прим. 0 - вечность), false, _(*25)

    'cache_minutes' => 60,

Настройка автоматического заполнения полей title&description из ответа видео API Значение: true\false, _(*26)

    'set_data' => true,

Настройка имен провайдеров предоставляющих видео API. Выводится в select создании\редактировании видео, _(*27)

    'provider_names' => array(
        'youtube' => 'Youtube',
        'vimeo'   => 'Vimeo',
    ),

Настройка провайдеров предоставляющих видео API, _(*28)

    'providers' => array(
        'youtube' => array(
         ...
        ),
        'vimeo' => array(
        ...
        ),
     )

Настройки каждого из видео API провайдеров, _(*29)

Настройка проверки существования видео на сервисе (не требует ключа API), _(*30)

    'video_existence_url' => '',

Настройка ссылки на изображение-превью на сервисе (не требует ключа API), _(*31)

    'preview_url' => '',

Настройка качества изображения-превью на сервисе, _(*32)

    'preview_quality' => '',

Настройка ссылки на просмотр видео (не требует ключа API), _(*33)

    'watch_url' => '',

Настройка ссылки на встраиваемое видео (не требует ключа API), _(*34)

    'embed_url' => '',

Настройка ссылки на сервис API, _(*35)

    'api_url' => '',

Настройка данных которые будут запрошены у сервиса API, _(*36)

    'api_part' => '',

Настройка ключа для подключения к сервису API, _(*37)

    'api_key' => '',

Спецификация и примеры

Общая спецификация

Для подключения необходимого нужно определить его вызов в начале своего класса., _(*38)

    use Vis\ImageStorage\Gallery;
    use Vis\ImageStorage\Image;
    use Vis\ImageStorage\Tag;
    use Vis\ImageStorage\VideoGallery;
    use Vis\ImageStorage\Video;
    use Vis\ImageStorage\Documents;

Ко всем моделям можно применять стандартный принцип написания запросов, поскольку они наследуются от модели Eloquent. Так же все модели используют трейты VIS CMS \Vis\Builder\Helpers\Traits\TranslateTrait и \Vis\Builder\Helpers\Traits\SeoTrait , _(*39)

Для всех записей генерируется уникальных слаг, его значение можно получить с помощью метода, _(*40)

    public function getSlug()

Общие scope фильтры для всех моделей (\Models\Traits\FilterableTrait.php) Фильтр сортировки по id., _(*41)

    public function scopeOrderId(Builder $query, $order = "desc")

Фильтр выведения только активных записей., _(*42)

    public function scopeActive(Builder $query)

Фильтр выведения записей согласна массива активностей Значение: массив $activity[0,1], _(*43)

   public function scopeFilterByActivity(Builder $query, array $activity = [])

Фильтр по slug записи, _(*44)

    public function scopeSlug(Builder $query, $slug = '')

Фильтр по title записи, _(*45)

    public function scopeFilterByTitle(Builder $query, $title = '')

Фильтр по дате создания записи. Значение: массив $date['from' => '', to => ''], _(*46)

    public function scopeFilterByDate(Builder $query, array $date = [])

Фильтр по связанным тэгам. Значение: массив $tags[$idTags], _(*47)

    public function scopeFilterByTags(Builder $query, array $tags = [])

Eloquent связь с тэгами. Получает все связанные тэги с сущностями, _(*48)

    public function tags()

Использование изображений

Eloquent связь с галереями. Получает все связанные галереи с изображением, _(*49)

    public function galleries()

Фильтр изображений по галереям. Значение: массив $galleries[$idGalleries], _(*50)

    public function scopeFilterByGalleries(Builder $query, array $galleries = [])

Метод получения ссылки на изображение по именному роуту. Роут необходимо определить самостоятельно, _(*51)

    public function getUrl()
    {
        return route("vis_images_show_single", [$this->getSlug()]);
    }

Наследует от абстракции src/Models/AbstractImageStorageFile.php следующие методы Получить путь изображения в указанном размере Значение: один из указаных в конфиге размеров, по умолчанию - source, _(*52)

    public function getSource($size = 'source')

Получить разрешение файла изображения Значение: один из указаных в конфиге размеров, по умолчанию - source, _(*53)

    public function getFileExtension($size = 'source')

Получить название файла изображения Значение: один из указаных в конфиге размеров, по умолчанию - source, _(*54)

    public function getFileName($size = 'source')

Получить размер файла изображения Значение: один из указаных в конфиге размеров, по умолчанию - source, _(*55)

    public function getFileSize($size = 'source')

Получить mime-type файла изображения Значение: один из указаных в конфиге размеров, по умолчанию - source, _(*56)

    public function getFileMimeType($size = 'source')

Использование фотогалереи

Eloquent связь с изображения. Получает все связанные изображения с галереей, _(*57)

    public function images()

Фильтр галерей по наличию изображений, _(*58)

    public function scopeHasImages(Builder $query)

Фильтр галерей по наличию активных изображений, _(*59)

    public function scopeHasActiveImages(Builder $query)

Метод получения ссылки на галерею по именному роуту. Роут необходимо определить самостоятельно, _(*60)

    public function getUrl()
    {
        return route("vis_galleries_show_single", [$this->getSlug()]);
    }

Метод получения превью-изображения для галереи Значение: один из указаных в конфиге изображений размеров, по умолчанию - cms_preview, _(*61)

    public function getGalleryPreviewImage($size = 'cms_preview')

Использование документов

Наследует от абстракции src/Models/AbstractImageStorageFile.php следующие методы Получить путь документа в указанном размере Значение: один из указаных в конфиге размеров, по умолчанию - source, _(*62)

    public function getSource($size = 'source')

Получить разрешение файла документа Значение: один из указаных в конфиге размеров, по умолчанию - source, _(*63)

    public function getFileExtension($size = 'source')

Получить название файла документа Значение: один из указаных в конфиге размеров, по умолчанию - source, _(*64)

    public function getFileName($size = 'source')

Получить размер файла документа Значение: один из указаных в конфиге размеров, по умолчанию - source, _(*65)

    public function getFileSize($size = 'source')

Получить mime-type файла документа Значение: один из указаных в конфиге размеров, по умолчанию - source, _(*66)

    public function getFileMimeType($size = 'source')

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

Eloquent связь с изображением-превью. Получает объект установленного изображения-превью, _(*67)

    public function preview()

Eloquent связь с изображения. Получает все связанные изображения с галереей, _(*68)

    public function videoGalleries()

Связь с API провайдером. Получает объект API provider в зависимости от типа видео., _(*69)

    public function api()

Фильтр видео по видеогалереям галереям. Значение: массив $galleries[$idGalleries], _(*70)

    public function scopeFilterByVideoGalleries(Builder $query, array $galleries = [])

Метод получения id видео, _(*71)

    public function getSource()

Метод получения ссылки на видео по именному роуту. Роут необходимо определить самостоятельно, _(*72)

    public function getUrl()
    {
        return route("vis_videos_show_single", [$this->getSlug()]);
    }

Метод получения ссылки на изображение-превью видео. Получает или установленное изображение-превью или обращается API за изображением., _(*73)

    public function getPreviewImage($size = 'source')

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

Видео API реализует интерфейс /Models/Interfaces/VideoAPIInterface.php и имеет следующие методы , _(*74)

Метод получения ссылки на видео, _(*75)

    public function getWatchUrl(array $urlParams);

Метод получения ссылки на встраиваемое видео, _(*76)

    public function getEmbedUrl(array $urlParams);

Метод получения ссылки на изображени-превью из API, _(*77)

    public function getPreviewUrl();

Метод получения всех данных о видео из API, _(*78)

    public function getApiResponse();

Метод получения названия видео из API, _(*79)

    public function getTitle();

Метод получения описание видео из API, _(*80)

    public function getDescription();

Метод получения количества просмотров видео из API, _(*81)

    public function getViewCount();

Метод получения количества лайков видео из API, _(*82)

    public function getLikeCount();

Метод получения количества дизлайков видео из API, _(*83)

    public function getDislikeCount();

Метод получения количества favorite для видео из API, _(*84)

    public function getFavoriteCount();

Метод получения количества комментариев для видео из API, _(*85)

    public function getCommentCount();

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

Eloquent связь с видео. Получает все связанные видео с видеогалереей, _(*86)

    public function videos()

Фильтр видеогалерей по наличию изображений, _(*87)

    public function scopeHasVideos(Builder $query)

Фильтр видеогалерей по наличию активных видео, _(*88)

    public function scopeHasActiveVideos(Builder $query)

Метод получения ссылки на видеогалерею по именному роуту. Роут необходимо определить самостоятельно, _(*89)

    public function getUrl()
    {
        return route("vis_video_galleries_show_single", [$this->getSlug()]);
    }

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

Eloquent связь с изображения. Получает все связанные изображения с тэгом, _(*90)

    public function images()

Eloquent связь с документами. Получает все связанные изображения с тэгом, _(*91)

    public function documents()

Eloquent связь с видео. Получает все связанные изображения с тэгом, _(*92)

    public function videos()

Eloquent связь с галереями. Получает все связанные изображения с тэгом, _(*93)

    public function galleries()

Eloquent связь с видеогалереями. Получает все связанные изображения с тэгом, _(*94)

    public function videoGalleries()

Кэширование

Медиахранилище использует ряд тегов для работы кэширования. При внесении измений в записи медиахранилища происходит автоматическое сбрасывание существующего кэша связанного с этими тегами. Перечень тэгов для каждой из сущностей: * image-storage.video * image-storage.document * image-storage.video_gallery * image-storage.gallery * image-storage.image * image-storage.tag, _(*95)

Особенности управление в VIS CMS

Общее управление

Интерфейс максимально приближен к интерфейсу VIS-CMS. В шапке каждого из разделов находится инструментальная панель с фильтами(с некоторым уникальными для разделов) и кнопкой создания новой записи, которая вызовет модальное окно создания. В нижней части страницы находится пагинация, _(*96)

Общее управление для изображений, видео и документов

При клике на уже добавленный объект вызовется модальное окно редактирования записи Которое содержит вкладки размеров и поля указанные в соотв. конфиге. Возможно прямо управление связями конктретного изображения., _(*97)

При выделении области с объектами будет отображена панель множественного управления объектами. После выделения область возможно точечное добавление\удаление объектов с помощью нажатия на них мышкой при зажатой кнопке ctrl. , _(*98)

Управление изображениями

При клике на поле "Загрузить изображение" появится окон выбора загружаемых изображений. Поддерживается множественная загрузка изображений. После загрузки всех изображений и созданиях их дополнительных размеров будет отправлен запрос на их оптимизацию. Если какое-либо из сгенирированных изображений-размеров не устаривает, тогда его можно заменить в вкладке этого размера., _(*99)

Управление видео

При создании нового видео достаточно указать видео сервис и идентификатор видео. Если видео существует - оно будет добавлено в общий список. Поля title и description автоматически будут заполнены, если установлена соотв. настройка в конфиге. Если изображение-превью предоставляемое видео сервисом не устаривает, тогда можно загрузить собственное в вкладке "Превью"., _(*100)

Управление документами

При клике на поле "Загрузить документ" появится окон выбора загружаемых документов. Поддерживается множественная загрузка документов. После загрузки всех документов во все дополнительные поля файлов будет установлена ссылка на исходный файл. Если есть необходимость заменить файл для какого-либо из размеров, тогда его можно заменить в вкладке этого размера., _(*101)

Общее управление для фотогалерей и видеогалерей

После создания галереи и добавления изображений\видео в неё возможно управление порядком изображений\видео путем перетягивания их между собой. Возможно установление одного из изображений\видео как превью для галереи с помощью нажатия на него мышкой при зажатой кнопке ctrl., _(*102)

The Versions

17/01 2018

dev-master

9999999-dev

Image storage for L5

library image_storage_l5

Image storage for L5

vis/image_storage_l5

The README.md

Image Storage

Установка

VIS-CMS

Настройка конфигов

Конфиг изображений

Конфиг документов

Конфиг видео

Конфиг видео API

Спецификация и примеры

Общая спецификация

Использование изображений

Использование фотогалереи

Использование документов

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

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

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

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

Кэширование

Особенности управление в VIS CMS

Общее управление

Общее управление для изображений, видео и документов

Управление изображениями

Управление видео

Управление документами

Общее управление для фотогалерей и видеогалерей

The Versions

dev-master

The Requires

by vis

1.4.11

The Requires

by vis

1.4.10

The Requires

by vis

1.4.9

The Requires

by vis

1.4.8

The Requires

by vis

1.4.7

The Requires

by vis

1.4.6

The Requires

by vis

1.4.5

The Requires

by vis

1.4.4

The Requires

by vis

1.4.3

The Requires

by vis

1.4.2

The Requires

by vis

1.4.1

The Requires

by vis

1.3.14

by vis

1.3.13

by vis

1.3.12

by vis

1.3.11

by vis

1.3.10

by vis

1.3.9

by vis

1.3.8

by vis