laravel-widgets

KO | EN

gitlite — search

#react #go #deep-learning #linux #nodejs #java #cli #kubernetes #awesome-list #vue #pytorch #security #ios #open-source

laravel-widgets

(★ 9)

Пакет для удобного создания и использования виджетов в Laravel-5

laravel-widgets 최신버젼 다운로드

최종 버전 다운로드 (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

laravel-widgets
=================
[![Laravel 5](https://img.shields.io/badge/Laravel-5-orange.svg?style=flat-square)](http://laravel.com)
[![License](http://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square)](https://tldrlegal.com/license/mit-license)

Пакет для удобного создания и использования виджетов в Laravel-5

* Удобный синтаксис - вызов любого виджета из шаблона с помощью простой директивы @widget, которая в качестве первого аргумента принимает название виджета, например:
```php
@widget('menu')
```
  * Простые правила создания виджетов.
  * Создание объекта виджета только в случае непосредственного его запроса.
  * Только самый необходимый функционал, разработанный с учетом архитектуры Laravel-5.4

Установка
------------------
Установка пакета с помощью Composer.

```
composer require klisl/laravel-widgets
```

Если версия Laravel меньше чем 5.5 - добавьте в файл `config/app.php` вашего проекта в конец массива `providers` :

```php
Klisl\Widgets\WidgetServiceProvider::class,
```
Для версии >=5.5 данный шаг можно пропустить.

После этого выполните в консоли команду публикации нужных ресурсов:

```
php artisan vendor:publish --provider="Klisl\Widgets\WidgetServiceProvider"
```

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

В файле `config\widgets.php` находится массив, в котором, в качестве ключей нужно указать названия для виджетов которые вы будете создавать, а в качестве значений названия классов виджетов (с пространством имен). Например:
```php
'test' => 'App\Widgets\TestWidget'
```

Классы для своих виджетов нужно создавать в папке `app\Widgets`. Для размещения шаблонов виджетов предназначена папка `app\Widgets\views`.

Класс виджета должен иметь соответствующее пространство имен: `namespace App\Widgets`. Так же класс виджета должен включать интерфейс ContractWidget и реализовывать его метод execute(). 
Если виджет должен, для своей работы, получить какие-то данные из контроллера и тд. (передаются в шаблоне), то необходимо предусмотреть метод конструктор для класса виджета с получением аргумента в виде массива параметров.

Примеры
-------------

Пример минимального класса виджета:

```php
<?php

namespace App\Widgets;

use Klisl\Widgets\Contract\ContractWidget;

class TestWidget implements ContractWidget{
	
	public function execute(){
				
		return view('Widgets::test');
		
	}	
}
```

Шаблон данного виджета, файл test.blade.php (с произвольным контентом) должен находиться в папке `app\Widgets\views`.

Вызов данного виджета (из основного шаблона нужного контроллера):
```php
@widget('test')
```

Пример с передачей параметров:
```php
<?php

namespace App\Widgets;

use Klisl\Widgets\Contract\ContractWidget;

class TestWidget implements ContractWidget{
	
	public $num;
		
	public function __construct ($data){
		$this->num = $data['num'];
	}
		
	public function execute(){
				
		return view('Widgets::test', [
			'num' => $this->num
		]);
		
	}	
}
```

Вызов данного виджета с передачей параметров для обработки:
```php
@widget('test', ['num' => 5])
```

В каталоге `app\Widgets` уже находится тестовый виджет. Вы можете создавать свои на его основе.

Мой блог: [klisl.com](https://klisl.com)

laravel-widgets

laravel-widgets 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

laravel-widgets

laravel-widgets 최신버젼 다운로드

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README