Download the PHP package laker-ls/yii2-pencil without Composer

On this page you can find all versions of the php package laker-ls/yii2-pencil. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package yii2-pencil

yii2-pencil

Stable Version Unstable Version License Total Downloads

ВНИМАНИЕ: Для работы необходим developeruz/yii2-db-rbac с существующей ролью.

Отображение текста, которое редактируется через модальное окно, когда пользователь авторизован как администратор. Не админ, видит обычный текст, в то же время администратор может взаимодействовать с ним, по нажатию на текст всплывает модальное окно с одним полем textarea, переносы в данном поле работают и конвертируются в <br />, вся стилизация текста должна задаваться через css.
Вы можете настраивать в каком теге выводить текст и передавать ему классы и другие атрибуты. Вид текста для администратора отличается и может быть дополнен атрибутами, которые выводят только для админа.

Отображение изображений, которые редактируются через модальное окна, когда пользователь авторизован как администратор. Все пользователи видят изображения, однако админу дополнительно отображается кнопка для редактирования изображений.

Установка

Рекомендуемый способ установки этого расширения является использование composer. Проверьте composer.json на предмет требований и зависимостей данного расширения.

Для установки запустите

или добавьте в composer.json в раздел require следующую строку

Смотрите список изменений для подробной информации о версиях.

Подключение

Выполните миграции в консоли:

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

В контроллере, в котором вызывается экшен с "карандашами" обязательно должно передаваться id текущей категории. Данный код служит примером, в каждом случае переданные параметры будут отличаться, но свойствой categoryId не должно менять своё имя.

Расширение готово к работе.

Использование виджета для текста

Использование виджета в layout:

С использованием дополнительных параметров:

id (string) - обязательный параметр, для удобства, id указывать строкой. Необходимы уникальные имена в пределах одной страницы. Повторное использование имен на других страницах не вызовет конфликта.

tag (string) - имя тега, в котором будет содержимое.

options (array) - параметры тега, которые видны как всем пользователям, так и администратору.

nonUnique (string) - необязательный параметр. Для отображения одного и того же текста на нескольких страницах необходимо передать строку, которая будет использоваться вместо id.

optionsAdmin (array) - параметры тега, которые видет только администратор. С помощью классов и стилей задается такой стиль текста, что бы было понятно, что он интерактивен (можно редактировать). По умолчанию синее подчеркивание.

textIsEmpty (string) - текст который виден админу если содержимое пусто или не существует, для возможности редактирования, т.к. текст единственный способ вызвать модальное окно администратору.

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

Размещайте виджет внутри тегов, которые ничего больше не содержат, т.к. при обновлении изображений всё содержимое тегов будет замещено.

Между begin и end передаем шаблон для каждого отдельного изображения. В этом шаблоне обязательно должен быть один пустой тег <img>, который будет заменен на реальное изображение.

Для использования виджета в layout'е обязательно передать параметром layout имя layout'a.

Передавая true или false параметру small выбираем вид кнопки для редактирования (видна только администратору).

ВАЖНО: используя значение true для параметра small обязательно указывайте родительскому элементу в котором расположено изображение стиль position: relative.

group (string) - обязательный параметр, который необходимо передавать для создания альбома изображений. Может использоваться кириллица.

thumbnail (array) - обязательный параметр, в котором передаем ширину и высоту миниатюры. Необязательным параметром является quality. Качество миниатюры которое задается в диапазоне 1 до 100, по умолчанию равно 50.

small (boolean) - необязательный параметр. По умолчанию false.
Если значение false, отображается большая кнопка для редактирования. Подходит для создания/редактирования альбомов.
Если значение true, кнопка имеет маленький размер и позицию absolute. Ни как не влияет на верстку, отображается в нижнем правом углу.

nonUnique (string) - необязательный параметр. Для отображения одних и тех же изображений на нескольких страницах необходимо передать строку, которая будет использоваться вместо id.

Удаление неиспользуемых изображений

Удаляя записи через базу данных останутся изображения, для этого реализовано удаление неиспользуемых изображений. В остальных случаях нет необходимости использовать данный контроллер.

В config/console.php необходимо подключить данный модуль следующим образом:

В консоли, из корня проекта исполнить следующую команду:

Лицензия

yii2-pencil выпущено по лицензии BSD-3-Clause. Ознакомиться можно в файле LICENSE.md.


All versions of yii2-pencil with dependencies

PHP Build Version
Package Version
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package laker-ls/yii2-pencil contains the following files

Loading the files please wait ....