创建页面

优质
小牛编辑
120浏览
2023-12-01

我们已经设计好了数据表,创建的 Blog 已经安装到了 Plus 程序上,这一章,我们来编写前台所需要的 UI 和逻辑部分。注意,这里不是去拓展 PC 的 UI,而是使用 Bootstrap 3 编写 Blog 的页面,因为我这里拟定你是使用开源版的 Plus 程序。

从这里开始,需要用到的 Laravel 知识 Blade 模板引擎

布局设计

在编写页面前,我们先来设计一下页面大体布局,我们先设想一下我们需要哪些页面:

  • 博客广场:用于浏览全部人的 Blogs,按照最新发布排序。页面顶部始终提醒用户创建自己的 Blog。
  • 博客主页:和「博客广场」类似,但是需要展示 Blog 信息以及这个 Blog 下的博客列表。
  • 投稿页面:共用页面,博主操纵是发布文章,其他用户是投稿文章
  • 文章阅读:文章阅读页面,底部还有评论列表。
  • 审核页面:博主审核他人文章投稿。

Layout 编写

首先,我们的前台 UI 应该有一个总图布局,所以我们在应用的 resources/views 目录下新建下面的文件并写入内容:

layout.blade.php

@extends('layouts.bootstrap')
@section('head')
  @parent
  <style>
    .blog-container {
      margin-top: 70px;
    }
  </style>
@endsection
@section('body')
  @include('plus-blog::header')
  <main class="container blog-container">
    @yield('container')
  </main>
  @include('plus-blog::footer')
  @parent
  @stack('footer-scripts')
@endsection
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

header.blade.php

<header class="navbar navbar-inverse navbar-fixed-top">
  <div class="container">
    <div class="navbar-header">
      <a class="navbar-brand" href="#">Blog</a>
    </div>
    <ul class="nav navbar-nav">
      <li class="{{ Route::currentRouteName() === 'home' ? 'active' : '' }}">
        <a href="{{ route('home') }}">博客广场</a>
      </li>
      <li class="{{ Route::currentRouteName() === 'blog:me' ? 'active' : '' }}">
        <a href="{{ route('blog:me') }}">我的博客</a>
      </li>
    </ul>
    @include('plus-blog::headers.user')
  </div>
</header>

footer.blade.php

@section('head')
  @parent
  <style>
    .blog-footer {
      width: 100%;
      background-color: #2a2730;
      color: #99979c;
      margin-top: 100px;
      padding: 50px 0;
    }
  </style>
@endsection

<footer class="blog-footer text-center">
  The Blog package MIT Licensed | Copyright © 2018-Present <a href="https://github.com/medz" target="_blank">Seven Du</a> All rights reserved.
</footer>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

home.blade.php

@extends('plus-blog::layout')
@section('title', '博客广场')
1
2

然后我们打开 routes/web.php 文件,将其默认生成的路由前缀进行修改,默认生成的是 plus-blog 我们修改为 blogs

<?php

use Illuminate\Support\Facades\Route;
use SlimKit\Plus\Packages\Blog\Web\Controllers as Web;
use Illuminate\Contracts\Routing\Registrar as RouteRegisterContract;

/*
|--------------------------------------------------------------------------
| Web Routes
|--------------------------------------------------------------------------
|
| Here is where you can register web routes for your application. These
| routes are loaded by the RouteServiceProvider within a group which
| contains the "web" middleware group. Now create something great!
|
*/

Route::group(['prefix' => 'blogs'], function (RouteRegisterContract $route) {

  // Home Router.
  $route->get('/', Web\HomeController::class.'@index');
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

接着我们打开包中 src/Web/Controllers/HomeController.php 文件,修改为下面的内容:

<?php

declare(strict_types=1);

namespace SlimKit\Plus\Packages\Blog\Web\Controllers;

class HomeController
{
  public function index()
  {
    return view('plus-blog::home');
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13

顶栏用户图标

我们上面创建玩基础模板了,我们来处理下顶部用户状态吧,当用户没有登录的时候我们显示「登录按钮」,登录成功后我们显示用户头像和名字。

现在我们打开包的 resources/views/header.blade.php 文件,修改为下面的内容:

<header class="navbar navbar-inverse navbar-fixed-top">
  <div class="container">
    <div class="navbar-header">
      <a class="navbar-brand" href="#">Blog</a>
    </div>
    <ul class="nav navbar-nav">
      <li class="{{ Route::currentRouteName() === 'home' ? 'active' : '' }}">
        <a href="{{ route('home') }}">博客广场</a>
      </li>
      <li class="{{ Route::currentRouteName() === 'blog:me' ? 'active' : '' }}">
        <a href="{{ route('blog:me') }}">我的博客</a>
      </li>
    </ul>
    @include('plus-blog::headers.user')
  </div>
</header>
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

然后我们创建一个 resources/views/headers/user.blade.php 文件内容如下:

<ul class="nav navbar-nav navbar-right">
  @if (Auth::guest())
  <li><a href="{{ route('login') }}">登入</a></li>
  @else
  <li class="dropdown">
    <a
      href="#"
      class="dropdown-toggle"
      data-toggle="dropdown" 
      role="button" 
      aria-haspopup="true" 
      aria-expanded="false"
    >
      @if (Auth::user()->avatar instanceof \Zhiyi\Plus\FileStorage\FileMetaInterface)
        @php
          $avatarUrl = Auth::user()->avatar->url();
          switch (Auth::user()->avatar->getVendorName()) {
            case 'local':
              $avatarUrl .= '?rule=h_50,w_50';
              break;
            case 'aliyun-oss':
              $avatarUrl .= '?rule=image/resize,h_50,w_50';
              break;
          }
        @endphp
        <img
          src="{{ $avatarUrl }}"
          alt="{{ Auth::user()->name }}的头像"
          style="
            width: 20px;
            height: 20px;
          "
        >
      @else
        {{ Auth::user()->name }}
      @endif
      <span class="caret"></span>
    </a>
    <ul class="dropdown-menu">
      @if (Auth::user()->ability('admin: login'))
        <li><a href="{{ url('/admin') }}">进入后台</a></li>
      @endif
      <li><a href="{{ route('logout') }}">退出登录</a></li>
    </ul>
  </li>
  @endif
</ul>

然后保存,我们就完成了用户的登录与退出(因为 Plus 自带登录页面,所以无需再写登录页面)

开源版设置 Blog 默认进入

我们的开发教程是在开源版本的 Plus 程序上进行的,是不是觉得每次都要在 URL 输入 /blogs 进入很麻烦?我们现在就来设置默认用户打开就进入 Blog 首页即可!

我们打开拓展包的 routes/web.php 文件:

use Illuminate\Support\Facades\Route;
use SlimKit\Plus\Packages\Blog\Web\Controllers as Web;
use Illuminate\Contracts\Routing\Registrar as RouteRegisterContract;

Route::get('/', Web\HomeController::class.'@index');
Route::group(['prefix' => 'blogs'], function (RouteRegisterContract $route) {
  // TODO
});

后台入口

我们覆盖了默认首页,我们自定义的页面没有了默认首页的提供的后台入口,所以我们在顶部用户图标下拉菜单中增加后台入口吧!

我们先打开包的 resources/views/headers/user.blade.php 中。在「退出登录」的 li 标签前面增加:

@if (Auth::user()->ability('admin: login'))
  <li><a href="{{ url('/admin') }}">进入后台</a></li>
@endif

页面预览

我们这一步就开发完成了所有页面公用的 Layout 部分,我们来看看效果吧!