laravel-title maintained by kminek
Laravel Title
Probably the easiest way to add dynamic HTML title to Laravel app
Installation
Run the following command from your terminal:
composer require kminek/laravel-title
or add this to require section in your composer.json file:
"kminek/laravel-title": "^3.0"
then run composer update
Version compatibility
laravel/framework |
kminek/laravel-title |
|---|---|
| 13.x | 3.x |
| 11.x / 12.x | 1.x / 2.x |
Usage
Modify your layout view (for example resources/views/layouts/app.blade.php):
<!DOCTYPE html>
<html lang="{{ str_replace('_', '-', app()->getLocale()) }}">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>{{ title() }}</title>
</head>
<body>
<main>
@yield('content')
</main>
</body>
</html>
Modify your controller action view (for example resources/views/auth/register.blade.php):
@extends('layouts.app')
@title('Register')
@section('content')
<h1>
Register
</h1>
...
@endsection
Advanced usage
Change default separator (|):
<title>{{ title()->separator(' - ') }}</title>
Change default text (config('app.name')):
<title>{{ title()->default('AppName') }}</title>
Set a description which is displayed when no title is set inside controller action view:
<title>{{ title()->default('AppName')->description('This app will blow your mind!') }}</title>
You are not required to use @title() Blade directive, you can call
library directly which opens more possibilities:
@extends('layouts.app')
@php(title()->append('Register')) {{-- append (same behaviour as Blade directive) --}}
@php(title()->prepend('Register')) {{-- prepend --}}
@php(title()->set('Register')) {{-- replace whole stack --}}
@section('content')
<h1>
Register
</h1>
...
@endsection
You can have multiple title "stacks" under different keys. Default stack is using "default" as a key, but you are free to create new ones:
<title>{{ title('homepage') }}</title>
and later in Blade view:
@php(title('homepage')->append('Register'))