This simple package has only one purpose: compacting the job of setting page titles to a single file.
It makes available a global variable $page_title in all blade templates and views using a Middleware.
You can install the package via composer:
composer require aon2003/laravel-page-titlesNext, you need to publish a config file and a language file:
php artisan vendor:publish --tag="laravel-page-titles"Lastly, you need to add the custom middleware to your web's middleware group in your app/Http/Kernel.php file.
'web' => [
...
\Aon2003\PageTitles\Middleware\PageTitles::class,
],For the library to work all your routes MUST be named.
After the installation a global variable $page_title will be available in all blade components.
It will contain the name of the current route,
which will be used to match a title that you can configure in the translation file: lang/en/page_titles.php.
By default, the page_titles.php file contains only two default page titles for route names 'index' and 'home'.
return [
'index' => env('APP_NAME', 'Home Page'),
'home' => env('APP_NAME', 'Home Page'),
];You can add your custom titles by adding lines in this file like this:
return [
...
'{route_name}' => '{page_title}',
];Then, in your blade files you should add the following line so the titles are displayed:
<title>{{ __($page_title) }}</title>If you want to be able to pass variables to your page titles, you should pass them as an array to the view,
add numbered placeholders to the title in the language files
and change the <title> tag in the blade files:
page_titles.php:
return [
...
'index' => 'Hello, :0!',
];Controller:
function index() {
$page_props = ['Alex'];
return view('{page}', compact('page_props'));
}{page}.blade.php:
<title>{{ __($page_title, $page_params ?? []) }}</title>The resulting page title should be: Hello, Alex!
If you want, you could use different translation file name.
The only thing you should do for it to work is to rename the translation files and change the translation_file_name variable
in the page_titles.php config file to the file name you want to use.
page_titles.php:
return [
/*
|--------------------------------------------------------------------------
| Translation File Name
|--------------------------------------------------------------------------
|
| Used to find the page titles translations.
| If you change the translation file name, you MUST change this variable, too!
|
*/
'translation_file_name' => 'page-titles',
];If your project supports internationalization, you can simply add more {language_code}/page_title.php files to your lang folder.
For more information check out the official Laravel docs.
Please see CHANGELOG for more information on what has changed recently.
The MIT License (MIT). Please see License File for more information.