Главная страница>Ресурсы для создания веб-сайтов>Другие ресурсы
Скачать

Imperavi Redactor виджет для YII 2

Imperavi Redactor Widget является оберткой для Imperavi Redactor 10.2.5, высококачественного редактора Wysiwyg.

Обратите внимание, что сам Imperavi Redactor является собственным коммерческим программным обеспечением, защищенным авторским правом, но, поскольку сообщество YII купило лицензию OEM, вы можете использовать его бесплатно с YII.

Установить

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

Либо беги 

$ php composer.phar require --prefer-dist vova07/yii2-imperavi-widget " * "

или добавить 

 "vova07/yii2-imperavi-widget" : " * "

в раздел require вашего файла composer.json .

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

Как только расширение установлено, просто используйте его в коде:

Как виджет 

 echo  vova07  imperavi Widget:: widget ([
    ' name ' => ' redactor ' ,
    ' settings ' => [
        ' lang ' => ' ru ' ,
        ' minHeight ' => 200 ,
        ' plugins ' => [
            ' clips ' ,
            ' fullscreen ' ,
        ],
        ' clips ' => [
            [ ' Lorem ipsum... ' , ' Lorem... ' ],
            [ ' red ' , ' <span class="label-red">red</span> ' ],
            [ ' green ' , ' <span class="label-green">green</span> ' ],
            [ ' blue ' , ' <span class="label-blue">blue</span> ' ],
        ],
    ],
]);

Как виджет ActiveForm 

 use vova07  imperavi  Widget ;

echo $ form -> field ( $ model , ' content ' )-> widget (Widget:: className (), [
    ' settings ' => [
        ' lang ' => ' ru ' ,
        ' minHeight ' => 200 ,
        ' plugins ' => [
            ' clips ' ,
            ' fullscreen ' ,
        ],
        ' clips ' => [
            [ ' Lorem ipsum... ' , ' Lorem... ' ],
            [ ' red ' , ' <span class="label-red">red</span> ' ],
            [ ' green ' , ' <span class="label-green">green</span> ' ],
            [ ' blue ' , ' <span class="label-blue">blue</span> ' ],
        ],
    ],
]);

Как виджет для предопределенного текста 

 echo  vova07  imperavi Widget:: widget ([
    ' selector ' => ' #my-textarea-id ' ,
    ' settings ' => [
        ' lang ' => ' ru ' ,
        ' minHeight ' => 200 ,
        ' plugins ' => [
            ' clips ' ,
            ' fullscreen ' ,
        ],
        ' clips ' => [
            [ ' Lorem ipsum... ' , ' Lorem... ' ],
            [ ' red ' , ' <span class="label-red">red</span> ' ],
            [ ' green ' , ' <span class="label-green">green</span> ' ],
            [ ' blue ' , ' <span class="label-blue">blue</span> ' ],
        ],
    ],
]);

Добавьте изображения, которые уже были загружены 

 // DefaultController.php
public function actions ()
{
    return [
        ' images-get ' => [
            ' class ' => ' vova07imperaviactionsGetImagesAction ' ,
            ' url ' => ' http://my-site.com/images/ ' , // Directory URL address, where files are stored.
            ' path ' => ' @alias/to/my/path ' , // Or absolute path to directory where files are stored.
            ' options ' => [ ' only ' => [ ' *.jpg ' , ' *.jpeg ' , ' *.png ' , ' *.gif ' , ' *.ico ' ]], // These options are by default.
        ],
    ];
}

// View.php
echo  vova07  imperavi Widget:: widget ([
    ' selector ' => ' #my-textarea-id ' ,
    ' settings ' => [
        ' lang ' => ' ru ' ,
        ' minHeight ' => 200 ,
        ' imageUpload ' => Url:: to ([ ' default/image-upload ' ]),
        ' imageManagerJson ' => Url:: to ([ ' /default/images-get ' ]),
        ' plugins ' => [
            ' imagemanager ' ,
        ],
    ],
]);

Добавьте файлы, которые уже были загружены 

 // DefaultController.php
public function actions ()
{
    return [
        ' files-get ' => [
            ' class ' => ' vova07imperaviactionsGetFilesAction ' ,
            ' url ' => ' http://my-site.com/files/ ' , // Directory URL address, where files are stored.
            ' path ' => ' @alias/to/my/path ' , // Or absolute path to directory where files are stored.
            ' options ' => [ ' only ' => [ ' *.txt ' , ' *.md ' ]], // These options are by default.
        ],
    ];
}

// View.php
echo  vova07  imperavi Widget:: widget ([
    ' selector ' => ' #my-textarea-id ' ,
    ' settings ' => [
        ' lang ' => ' ru ' ,
        ' minHeight ' => 200 ,
        ' fileUpload ' => Url:: to ([ ' default/file-upload ' ]),
        ' fileManagerJson ' => Url:: to ([ ' /default/files-get ' ]),
        ' plugins ' => [
            ' filemanager ' ,
        ],
    ],
]);

Загрузить изображение 

 // DefaultController.php
public function actions ()
{
    return [
        ' image-upload ' => [
            ' class ' => ' vova07imperaviactionsUploadFileAction ' ,
            ' url ' => ' http://my-site.com/images/ ' , // Directory URL address, where files are stored.
            ' path ' => ' @alias/to/my/path ' , // Or absolute path to directory where files are stored.
        ],
    ];
}

// View.php
echo  vova07  imperavi Widget:: widget ([
    ' selector ' => ' #my-textarea-id ' ,
    ' settings ' => [
        ' lang ' => ' ru ' ,
        ' minHeight ' => 200 ,
        ' imageUpload ' => Url:: to ([ ' /default/image-upload ' ]),
        ' plugins ' => [
            ' imagemanager ' ,
        ],
    ],
]);

Загрузить файл 

 // DefaultController.php
public function actions ()
{
    return [
        ' file-upload ' => [
            ' class ' => ' vova07imperaviactionsUploadFileAction ' ,
            ' url ' => ' http://my-site.com/files/ ' , // Directory URL address, where files are stored.
            ' path ' => ' @alias/to/my/path ' , // Or absolute path to directory where files are stored.
            ' uploadOnlyImage ' => false , // For any kind of files uploading.
        ],
    ];
}

// View.php
echo  vova07  imperavi Widget:: widget ([
    ' selector ' => ' #my-textarea-id ' ,
    ' settings ' => [
        ' lang ' => ' ru ' ,
        ' minHeight ' => 200 ,
        ' fileUpload ' => Url:: to ([ ' /default/file-upload ' ]),
        ' plugins ' => [
            ' filemanager ' ,
        ],
    ],
]);

Загрузите и замените файл с тем же именем 

 // DefaultController.php
public function actions ()
{
    return [
        ' file-upload ' => [
            ' class ' => ' vova07imperaviactionsUploadFileAction ' ,
            ' url ' => ' http://my-site.com/files/ ' , // Directory URL address, where files are stored.
            ' path ' => ' @alias/to/my/path ' , // Or absolute path to directory where files are stored.
            ' uploadOnlyImage ' => false , // For any kind of files uploading.
            ' unique ' => false ,
            ' replace ' => true , // By default it throw an excepiton instead.
        ],
    ];
}

// View.php
echo  vova07  imperavi Widget:: widget ([
    ' selector ' => ' #my-textarea-id ' ,
    ' settings ' => [
        ' lang ' => ' ru ' ,
        ' minHeight ' => 200 ,
        ' fileUpload ' => Url:: to ([ ' /default/file-upload ' ]),
        ' plugins ' => [
            ' filemanager ' ,
        ],
    ],
]);

Загрузить файл и перевести его имя 

 // DefaultController.php
public function actions ()
{
    return [
        ' file-upload ' => [
            ' class ' => ' vova07imperaviactionsUploadFileAction ' ,
            ' url ' => ' http://my-site.com/files/ ' , // Directory URL address, where files are stored.
            ' path ' => ' @alias/to/my/path ' , // Or absolute path to directory where files are stored.
            ' uploadOnlyImage ' => false , // For any kind of files uploading.
            ' unique ' => false ,
            ' translit ' => true ,
        ],
    ];
}

// View.php
echo  vova07  imperavi Widget:: widget ([
    ' selector ' => ' #my-textarea-id ' ,
    ' settings ' => [
        ' lang ' => ' ru ' ,
        ' minHeight ' => 200 ,
        ' fileUpload ' => Url:: to ([ ' /default/file-upload ' ]),
        ' plugins ' => [
            ' filemanager ' ,
        ],
    ]
]);

Добавьте пользовательские плагины 

 echo  vova07  imperavi Widget:: widget ([
    ' selector ' => ' #my-textarea-id ' ,
    ' settings ' => [
        ' lang ' => ' ru ' ,
        ' minHeight ' => 200 ,
        ' plugins ' => [
            ' clips ' ,
            ' fullscreen '
        ]
    ],
    ' plugins ' => [
        ' my-custom-plugin ' => ' appassetsMyPluginBundle ' ,
    ],
]);

Включить пользовательский менеджер изображений с функциональностью удаления 

 // DefaultController.php
public function actions ()
{
    return [
        ' images-get ' => [
            ' class ' => ' vova07imperaviactionsGetImagesAction ' ,
            ' url ' => ' http://my-site.com/images/ ' , // Directory URL address, where files are stored.
            ' path ' => ' @alias/to/my/path ' , // Or absolute path to directory where files are stored.
        ],
        ' image-upload ' => [
            ' class ' => ' vova07imperaviactionsUploadFileAction ' ,
            ' url ' => ' http://my-site.com/images/ ' , // Directory URL address, where files are stored.
            ' path ' => ' @alias/to/my/path ' , // Or absolute path to directory where files are stored.
        ],
        ' file-delete ' => [
            ' class ' => ' vova07imperaviactionsDeleteFileAction ' ,
            ' url ' => ' http://my-site.com/statics/ ' , // Directory URL address, where files are stored.
            ' path ' => ' /var/www/my-site.com/web/statics ' , // Or absolute path to directory where files are stored.
        ],
    ];
}

// View.php
echo  vova07  imperavi Widget:: widget ([
    ' selector ' => ' #my-textarea-id ' ,
    ' settings ' => [
        ' lang ' => ' ru ' ,
        ' minHeight ' => 200 ,
        ' imageUpload ' => Url:: to ([ ' /default/image-upload ' ]),
        ' imageDelete ' => Url:: to ([ ' /default/file-delete ' ]),
        ' imageManagerJson ' => Url:: to ([ ' /default/images-get ' ]),
    ],
    ' plugins ' => [
        ' imagemanager ' => ' vova07imperavibundlesImageManagerAsset ' ,              
    ],
]);

Включить пользовательский файловый диспетчер с функциональностью удаления 

 // DefaultController.php
public function actions ()
{
    return [
        ' files-get ' => [
            ' class ' => ' vova07imperaviactionsGetFilesAction ' ,
            ' url ' => ' http://my-site.com/images/ ' , // Directory URL address, where files are stored.
            ' path ' => ' @alias/to/my/path ' , // Or absolute path to directory where files are stored.
        ],
        ' file-upload ' => [
            ' class ' => ' vova07imperaviactionsUploadFileAction ' ,
            ' url ' => ' http://my-site.com/files/ ' , // Directory URL address, where files are stored.
            ' path ' => ' @alias/to/my/path ' , // Or absolute path to directory where files are stored.
            ' uploadOnlyImage ' => false , // For any kind of files uploading.
        ],
        ' file-delete ' => [
            ' class ' => ' vova07imperaviactionsDeleteFileAction ' ,
            ' url ' => ' http://my-site.com/statics/ ' , // Directory URL address, where files are stored.
            ' path ' => ' /var/www/my-site.com/web/statics ' , // Or absolute path to directory where files are stored.
        ],
    ];
}

// View.php
echo  vova07  imperavi Widget:: widget ([
    ' selector ' => ' #my-textarea-id ' ,
    ' settings ' => [
        ' lang ' => ' ru ' ,
        ' minHeight ' => 200 ,
        ' fileUpload ' => Url:: to ([ ' /default/file-upload ' ]),
        ' fileDelete ' => Url:: to ([ ' /default/file-delete ' ]),
        ' fileManagerJson ' => Url:: to ([ ' /default/files-get ' ]),
    ],
    ' plugins ' => [
        ' filemanager ' => ' vova07imperavibundlesFileManagerAsset ' ,              
    ],
]);

Тестирование 

$ phpunit

Дополнительная информация

Пожалуйста, проверьте документацию Imperavi Redactor V10 для получения дополнительной информации о ее параметрах конфигурации.

Внося

Пожалуйста, смотрите для получения подробной информации.

Кредиты

  • Василь Круду
  • Все участники

Лицензия

Лицензия BSD (BSD). Пожалуйста, смотрите файл лицензии для получения дополнительной информации.

Руководство по обновлению

Пожалуйста, проверьте Руководство по обновлению для получения подробной информации.

Расширять
Дополнительная информация
Связанные приложения
Рекомендуем вам
Связанные новости Все