Создание блога

Suggest Edit

Этот документ является учебным пошаговом руководством в котором демонстрируется процесс создания блога на Laravel с помощью ORCHID. Примеры специально подобраны для того, что бы помочь новичку справляться с задачами от начала до конца.

Установка

Для начало установим сам Laravel и пакет ORCHID

Внешний вид

Для отображения нашего блога, возьмём чистую и спокойную тему Clean Blog на bootstrap.

Сначала поставим все стили и javascript скрипты, для того, что бы собрать их webpack’ом. Стандартно в папке assets создана директория для sass стилей, но в нашей теме используются less. Создадим новую директории вместо старой (Можно использовать sass, это ни как не повлияет на основной процесс) и скопируем файлы в js и less соответственно.

Установим сам bootstrap

npm install bootstrap --save

В файле app.js сделаем его подключение и файла темы:

require('./bootstrap');
require('clean-blog');

Для файла со стилями мы так же должны его подключить, для этого открываем clean-blog.less и добавим:

// Fonts
@import url(https://fonts.googleapis.com/css?family=Lora:400,400i,700,700i&subset=cyrillic);
@import url(https://fonts.googleapis.com/css?family=Open+Sans:300italic,400italic,600italic,700italic,800italic,400,300,600,700,800);

@import "../../../node_modules/bootstrap/less/bootstrap";
@import "variables.less";
@import "mixins.less";

Переименуем clean-blog.less в app.less для стандартизации. Всё, теперь мы можем собирать приложение.

Откроем webpack.mix.js и напишем инструкцию:

mix.js('resources/assets/js/app.js', 'public/js')
   .less('resources/assets/less/app.less', 'public/css');

Отлично, всё необходимые зависимости нашего блога готовы.

Шаблоны

Откроем главный шаблон нашего блога view/layouts/app.blade.php и приведём его к виду :

<!DOCTYPE html>
<html lang="{{ config('app.locale') }}">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">

    <title>@yield('title','Последние записи') - {{setting('site_title')}}</title>
    <meta name="description" content="{{setting('site_description')}}">
    <meta name="keywords" content="{{setting('site_keywords')}}">

    <link href="{{mix('css/app.css')}}" rel="stylesheet">
</head>



<body>

<!-- Navigation -->
<nav class="navbar navbar-default navbar-custom navbar-fixed-top">
    <div class="container-fluid">
        <!-- Brand and toggle get grouped for better mobile display -->
        <div class="navbar-header page-scroll">
            <button type="button" class="navbar-toggle" data-toggle="collapse">
                <span class="sr-only">Toggle navigation</span>
                Menu <i class="fa fa-bars"></i>
            </button>
            <a class="navbar-brand" href="/">{{config('app.name')}}</a>
        </div>

        @widget('menu','header')
    </div>
    <!-- /.container -->
</nav>

@yield('content')

<hr>

<!-- Footer -->
<footer>
    <div class="container">
        <div class="row">
            <div class="col-lg-8 col-lg-offset-2 col-md-10 col-md-offset-1">
                <p class="copyright text-muted">Copyright &copy; 2015 - {{date('Y')}}</p>
            </div>
        </div>
    </div>
</footer>

<script src="{{mix('js/app.js')}}"></script>

</body>

</html>

Помимо стандартных возможностей laravel, тут присутствуют новые:

  • setting — хелпер который позволяет выводить значения из хранилища.
  • widget — пользовательское представление и выполнение кода.

Виджет

Теперь давайте создадим наш виджет одноуровнего меню, для того, что бы мы могли управлять им из панели:

Для этого выполним команду:

php artisan make:widget MenuWidget

Artisan создаст пустой файл виджета в /app/Http/Widgets. Нам останется только зарегистрировать его в конфиге config/widget.php

'widgets' => [
    'menu' => App\Http\Widgets\MenuWidget::class,
],

Изменим его, что бы он собирал все элементы меню и передавал их на отображение:

namespace App\Http\Widgets;

use Orchid\Platform\Widget\Widget;
use Orchid\Platform\Core\Models\Menu;

class MenuWidget extends Widget {

    /**
     * @return mixed
     */
    public function handler($typemenu = 'header')
    {
        $menu = Menu::where('lang', config('app.locale'))
            ->where('parent',0)
            ->where('type', $typemenu)->get();

        return view('partials.menu', [
            'menu'  => $menu,
        ]);
    }

}

Тогда само отображение будет выглядеть так:

<!-- Collect the nav links, forms, and other content for toggling -->
<div class="collapse navbar-collapse">
    <ul class="nav navbar-nav navbar-right">
        @foreach($menu as $item)

            <li>
                <a href="{{$item->slug}}"
                   title="{{$item->title}}"
                   target="{{$item->target}}"
                   rel="{{$item->robot}}"
                   class="{{$item->style}}"
                >
                    {{$item->label}}
                </a>
            </li>

        @endforeach
    </ul>
</div>
<!-- /.navbar-collapse -->

Поведение

Отлично, давайте теперь выводить сами записи нашего блога, для этого воспользуемся множественными записями платформы:

php artisan make:manyBehavior Blog

По адресу /app/Behaviors/Many, будет создан пустой файл Blog.php, давайте наполним его :

namespace App\Behaviors\Many;

use Orchid\Platform\Behaviors\Many;
use Orchid\Platform\Fields\Field;
use Orchid\Platform\Http\Forms\Posts\BasePostForm;
use Orchid\Platform\Http\Forms\Posts\UploadPostForm;
use Orchid\Platform\Platform\Fields\TD;

class Blog extends Many
{
    /**
     * @var string
     */
    public $name = 'Blog';

    /**
     * @var string
     */
    public $description = 'Blog description';

    /**
     * @var string
     */
    public $slug = 'blog';

    /**
     * Slug url /news/{name}.
     *
     * @var string
     */
    public $slugFields = 'name';

    /**
     * Rules Validation.
     *
     * @return array
     */
    public function rules() : array
    {
        return [
            'id'             => 'sometimes|integer|unique:posts',
            'content.*.name' => 'required|string',
            'content.*.body' => 'required|string',
        ];
    }

    /**
     * @return array
     * @throws \Orchid\Platform\Exceptions\TypeException
     */
    public function fields() : array
    {
        return [
            Field::tag('input')
                ->type('text')
                ->name('name')
                ->max(255)
                ->required()
                ->title('Название статьи')
                ->help('Как называется статья?'),

            Field::tag('wysiwyg')
                ->name('body')
                ->required()
                ->rows(10),

            Field::tag('input')
                ->type('text')
                ->name('title')
                ->max(255)
                ->required()
                ->title('Залоголок страницы')
                ->help('Заголовок вкладки'),

            Field::tag('textarea')
                ->name('description')
                ->rows(5)
                ->required()
                ->title('Краткое описание'),

            Field::tag('tags')
                ->name('keywords')
                ->title('Ключевые слова'),
        ];
    }

    /**
     * @return array
     */
    public function modules() : array
    {
        return [
            BasePostForm::class,
            UploadPostForm::class,
        ];
    }

    /**
     * Grid View for post type.
     */
    public function grid() : array
    {
        return [
            TD::name('name')->title('Имя'),
            TD::name('publish_at')->title('Дата публикации'),
            TD::name('created_at')->title('Дата создания'),
        ];
    }
}

После описания можно регистрировать в платформе config/platform

/*
|--------------------------------------------------------------------------
| Many Behaviors
|--------------------------------------------------------------------------
|
*/

'many' => [
    App\Behaviors\Many\Blog::class,
],

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

Примечание Если в ролях пользователя не появилась возможность дать разрешение новому типу записи, то необходимо сбросить кэш конфигурации командой php artisan config:clear

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

Вывод данных

Но наши записи требуют отображения, для этого создадим контроллер c содержанием:

php artisan make:controller BlogController
namespace App\Http\Controllers;

use Orchid\Platform\Core\Models\Post;

class BlogController extends Controller
{
    /**
     * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
     */
    public function index()
    {
        $posts = Post::type('blog')
            ->status('publish')
            ->with('attachment')
            ->orderBy('publish_at','Desc')
            ->simplePaginate(5);
        return view('pages.main', [
            'posts' => $posts
        ]);
    }
    /**
     * @param Post $post
     *
     * @return \Illuminate\Contracts\View\Factory|\Illuminate\View\View
     */
    public function show(Post $post)
    {
        return view('pages.post', [
            'post' => $post
        ]);
    }
}

После этого изменим роутинг нашего блога:

$router->get('/','BlogController@index');

$router->get('/{blog}','BlogController@show')
    ->where('blog','^(?!dashboard).*$')
    ->name('blog.post');

Для отображения url адреса в человеко понятном виде добавим биндинг роута blog, в RouteServiceProvider:

Route::bind('blog', function ($value) {
    return Post::where('slug', $value)
        ->type('blog')
        ->with(['attachment'])
        ->firstOrFail();
});

Дело осталось за малым, создать отображение всех этих данных, в папке views создадим директорию pages с main.blade.php и post.blade.php

post.blade.php будет выглядеть так:

@extends('layouts.app')

@section('title',$post->getContent('title'))
@section('keywords',$post->getContent('keywords'))
@section('description',$post->getContent('description'))

@section('content')



<!-- Page Header -->
<!-- Set your background image for this header on the line below. -->
<header class="intro-header"
        style="background-image: url('{{$post->attachment->first()->url() }}')">
    <div class="container">
        <div class="row">
            <div class="col-lg-8 col-lg-offset-2 col-md-10 col-md-offset-1">
                <div class="post-heading">
                    <h1>{{$post->getContent('name')}}</h1>
                    <h2 class="subheading">{{$post->getContent('subname')}}</h2>
                    <span class="meta">
                        Опубликовано {{$post->publish_at->diffForHumans()}}
                    </span>
                </div>
            </div>
        </div>
    </div>
</header>

<!-- Post Content -->
<article>
    <div class="container">
        <div class="row">
            <div class="col-lg-8 col-lg-offset-2 col-md-10 col-md-offset-1">
                <main>
                {!! $post->getContent('body') !!}
                </main>
            </div>
        </div>
    </div>
</article>
@endsection

main.blade.php будет выглядеть так:

@extends('layouts.app')

@section('content')

<!-- Page Header -->
<!-- Set your background image for this header on the line below. -->
<header class="intro-header" style="background-image: url('img/home-bg.jpg')">
    <div class="container">
        <div class="row">
            <div class="col-lg-8 col-lg-offset-2 col-md-10 col-md-offset-1">
                <div class="site-heading">
                    <h1>Вселенная</h1>
                    <hr class="small">
                    <span class="subheading">Простыми словами о сложном</span>
                </div>
            </div>
        </div>
    </div>
</header>


<!-- Main Content -->
<div class="container">
    <div class="row">
        <div class="col-lg-8 col-lg-offset-2 col-md-10 col-md-offset-1">

            @foreach($posts as $post)
            <div class="post-preview">
                <a href="{{route('blog.post',$post->slug)}}">
                    <h2 class="post-title">
                        {{$post->getContent('name')}}
                    </h2>
                    <h3 class="post-subtitle">

                        {{ str_limit(strip_tags($post->getContent('body')),150) }}
                    </h3>
                </a>
                <p class="post-meta">
                    Опубликованно: {{$post->publish_at->diffForHumans()}}
                </p>
            </div>
            <hr>
            @endforeach


            <div class="row text-center">
                {{ $posts->links() }}
            </div>
        </div>
    </div>
</div>

@endsection

Тут тоже есть новая функция (Которой нет в Laravel) getContent, она возвращает значения которые мы указали в панели управления для записи.

Исходный код

Итого мы создали простой блог с использованием Laravel и ORCHID. Исходный код доступен на github.