Create series

Author: joedixon

app/Http/Controllers/Articles/SeriesController.php

@@ -0,0 +1,35 @@
+<?php
+
+namespace App\Http\Controllers\Articles;
+
+use App\Http\Controllers\Controller;
+use App\Http\Middleware\Authenticate;
+use App\Http\Middleware\RedirectIfUnconfirmed;
+use App\Http\Requests\SeriesRequest;
+use App\Jobs\CreateSeries;
+use App\Models\Tag;
+
+class SeriesController extends Controller
+{
+    public function __construct()
+    {
+        $this->middleware([Authenticate::class, RedirectIfUnconfirmed::class], ['except' => ['index', 'show']]);
+    }
+
+    public function create()
+    {
+        $tags = Tag::all();
+        $selectedTags = old('tags') ?: [];
+
+        return view('articles.series.create', ['tags' => $tags, 'selectedTags' => $selectedTags]);
+    }
+
+    public function store(SeriesRequest $request)
+    {
+        $series = $this->dispatchNow(CreateSeries::fromRequest($request));
+
+        $this->success('series.created');
+
+        return redirect()->route('series.show', $series->id());
+    }
+}

app/Http/Requests/SeriesRequest.php

@@ -0,0 +1,32 @@
+<?php
+
+namespace App\Http\Requests;
+
+use App\User;
+
+class SeriesRequest extends Request
+{
+    public function rules()
+    {
+        return [
+            'title' => ['required', 'max:100'],
+            'tags' => 'array',
+            'tags.*' => 'exists:tags,id',
+        ];
+    }
+
+    public function author(): User
+    {
+        return $this->user();
+    }
+
+    public function title(): string
+    {
+        return $this->get('title');
+    }
+
+    public function tags(): array
+    {
+        return $this->get('tags', []);
+    }
+}

app/Jobs/CreateSeries.php

@@ -0,0 +1,53 @@
+<?php
+
+namespace App\Jobs;
+
+use App\Http\Requests\SeriesRequest;
+use App\Models\Series;
+use App\User;
+
+final class CreateSeries
+{
+    /**
+     * @var string
+     */
+    private $title;
+
+    /**
+     * @var \App\User
+     */
+    private $author;
+
+    /**
+     * @var array
+     */
+    private $tags;
+
+    public function __construct(string $title, User $author, array $tags = [])
+    {
+        $this->title = $title;
+        $this->author = $author;
+        $this->tags = $tags;
+    }
+
+    public static function fromRequest(SeriesRequest $request): self
+    {
+        return new static(
+            $request->title(),
+            $request->author(),
+            $request->tags()
+        );
+    }
+
+    public function handle(): Series
+    {
+        $series = new Series([
+            'title' => $this->title,
+        ]);
+        $series->authoredBy($this->author);
+        $series->syncTags($this->tags);
+        $series->save();
+
+        return $series;
+    }
+}

app/Models/Series.php

@@ -3,11 +3,12 @@
 namespace App\Models;
 
 use App\Helpers\HasAuthor;
+use App\Helpers\HasTags;
 use Illuminate\Database\Eloquent\Model;
 
 class Series extends Model
 {
-    use HasAuthor;
+    use HasAuthor, HasTags;
 
     /**
      * {@inheritdoc}
@@ -16,6 +17,16 @@ class Series extends Model
         'title',
     ];
 
+    public function id(): int
+    {
+        return $this->id;
+    }
+
+    public function title(): string
+    {
+        return $this->title;
+    }
+
     public function articles()
     {
         return $this->hasMany(Article::class);

resources/lang/en/series.php

@@ -0,0 +1,7 @@
+<?php
+
+return [
+
+    'created' => 'Series successfully created!',
+
+];

resources/views/articles/series/_form.blade.php

@@ -0,0 +1,35 @@
+<form action="{{ route(...$route) }}" method="POST">
+    @csrf
+    @method($method ?? 'POST')
+
+    @formGroup('title')
+        <label for="title">Title</label>
+        <input 
+            type="text" 
+            name="title" 
+            id="title" 
+            value="{{ isset($series) ? $series->title() : null }}" 
+            class="form-control" 
+            required maxlength="60" 
+        />
+        <span class="text-gray-600 text-sm">Maximum 60 characters.</span>
+        @error('title')
+    @endFormGroup
+
+    @formGroup('tags')
+        <label for="tags">Tags</label>
+
+        <select name="tags[]" id="create-series" multiple x-data="{}" x-init="function () { choices($el) }">
+            @foreach($tags as $tag)
+                <option value="{{ $tag->id }}" @if(in_array($tag->id, $selectedTags)) selected @endif>{{ $tag->name }}</option>
+            @endforeach
+        </select>
+
+        @error('tags')
+    @endFormGroup
+
+    <div class="flex justify-end items-center">
+        <a href="{{ isset($series) ? route('series.show', $series->id()) : route('series') }}" class="text-green-darker mr-4">Cancel</a>
+        <button type="submit" class="button button-primary">{{ isset($series) ? 'Update series' : 'Create series' }}</button>
+    </div>
+</form>

resources/views/articles/series/create.blade.php

@@ -0,0 +1,15 @@
+@title('Create a series')
+
+@extends('layouts.default')
+
+@section('content')
+    <div class="container mx-auto p-4 flex justify-center">
+        <div class="w-full md:w-2/3 xl:w-1/2">
+            <div class="md:p-4 md:border-2 md:rounded md:bg-gray-100">
+                @include('articles.series._form', [
+                    'route' => ['series.store'],
+                ])
+            </div>
+        </div>
+    </div>
+@endsection

routes/bindings.php

@@ -24,3 +24,6 @@
 Route::bind('article', function (string $slug) {
     return App\Models\Article::findBySlug($slug);
 });
+Route::bind('series', function (string $id) {
+    return App\Models\Series::findOrFail($id);
+});

routes/web.php

@@ -79,6 +79,12 @@
 
 // Articles
 Route::prefix('articles')->namespace('Articles')->group(function () {
+    // Series
+    Route::prefix('series')->group(function () {
+        Route::get('/create', 'SeriesController@create')->name('series.create');
+        Route::post('/', 'SeriesController@store')->name('series.store');
+    });
+
     Route::get('/', 'ArticlesController@index')->name('articles');
     Route::get('/create', 'ArticlesController@create')->name('articles.create');
     Route::post('/', 'ArticlesController@store')->name('articles.store');

tests/Feature/SeriesTest.php

@@ -0,0 +1,47 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Models\Article;
+use App\Models\Tag;
+use Illuminate\Foundation\Testing\DatabaseMigrations;
+
+class SeriesTest extends BrowserKitTestCase
+{
+    use DatabaseMigrations;
+
+    /** @test */
+    public function users_cannot_create_a_series_when_not_logged_in()
+    {
+        $this->visit('/articles/series/create')
+            ->seePageIs('/login');
+    }
+
+    /** @test */
+    public function users_can_create_a_series()
+    {
+        $tag = factory(Tag::class)->create(['name' => 'Test Tag']);
+
+        $this->login();
+
+        $this->post('/articles/series', [
+            'title' => 'A developers guide to SVG',
+            'tags' => [$tag->id()],
+        ])
+            ->assertRedirectedTo('/articles/series/1')
+            ->assertSessionHas('success', 'Series successfully created!');
+    }
+
+    /** @test */
+    public function users_cannot_create_a_series_with_a_title_that_is_too_long()
+    {
+        $this->login();
+
+        $response = $this->post('/articles/series', [
+            'title' => 'A developers guide to SVG which is an image format written in XML which is highly customisable and flexible',
+        ]);
+
+        $response->assertSessionHas('error', 'Something went wrong. Please review the fields below.');
+        $response->assertSessionHasErrors(['title' => 'The title may not be greater than 100 characters.']);
+    }
+}