0011-views-collections-dates.md

Loops and including partial templates

Iterating over elements of collection or array

@foreach ($posts as $post)
	{{ $post->title }}
@endforeach

Iterating over elements of collection or array and rendering a value when collection is empty (zero length)

@forelse ($posts as $post)
	{{ $post->title }}
@empty
	<p>No blog posts</p>
@endforelse

Including a sub-view (included views inherit the data of parent view)

@include('post')

Passing additional data to included view

@include('post', ['some' => 'data'])

Including multiple views at once for a collection

@each('post', $posts, 'post')

The first argument is the partial view template name, second the collection, third the variable name that would be available inside included view

Conditional rendering

The @if directive

@if ($post->id === 1)
    Post one!
@elseif ($post->id === 2)
    Post two!
@else
    Something else
@endif

The @unless directive

@unless ($post->id === 1)
    Post one!
@endunless

Dates

Date mutators

https://laravel.com/docs/7.x/eloquent-mutators#date-mutators

By default the created_at and updated_at will be converted to Carbon date objects

It can be configured using dates field of the model

class BlogPost extends Model
{
    protected $dates = [
        'created_at',
        'updated_at',
        'deleted_at'
    ];
}

Date format

By default date columns are stored as Y-m-d H:i:s format

It can be customized using dateFormat field of the model.

Warning! This will change how date is stored inside the database and how it is being formatted by default!

class BlogPost extends Model
{
    protected $dateFormat = 'Y-m-d';
}

Carbon

Carbon is a PHP library that extends the base \DateTime class. It's extensively used in Laravel.

Full API documentation https://carbon.nesbot.com/docs/

Formatting the date in the "time ago" format (in Blade template)

{{ $post->created_at->diffForHumans() }}

Checking for time difference (https://carbon.nesbot.com/docs/#api-difference)

In the below example we check if the time passed between now, and the post created_at date is less than 5 minutes. Only then we render the "New!" badge.

@unless (now()->diffInMinutes($post->created_at) < 5)
    <strong>New!</strong>
@endunless