Laravel Seo Manager

lionix/seo-manager package will provide you an interface from where you can manage all your pages metadata separately and get dynamically changing content. Let's see how.

After updating to version > v1.2.* you have to run:
php artisan vendor:publish --provider="Lionix\SeoManager\SeoManagerServiceProvider" --tag=config --force
php artisan vendor:publish --provider="Lionix\SeoManager\SeoManagerServiceProvider" --tag=assets --force
and
php artisan migrate
to publish the latest configs and new migration files.

In version v1.2.* you will have the availability to localize your metadata and set translates to your data.
For that, you just should add your available locales with the top right button "Add Locales" and chose the locale for which you want to add translations.
That's it, Package will automatically detect your locale from website and will set needed translations, you don't need to do any other configs. Easy, isn't it?

You can install the package via composer:
composer require lionix/seo-manager
Publishing package files
php artisan vendor:publish --provider="Lionix\SeoManager\SeoManagerServiceProvider"
This command will create config/seo-manager.php file and will copy package assets directory to public/vendor/lionix.
Configurations
In config/seo-manager.php file you can do the following configurations:
return [
/**
* Database table name where your manager data will be stored
*/
'database' => [
'table' => 'seo_manager',
'locales_table' => 'seo_manager_locales',
'translates_table' => 'seo_manager_translates'
],
/**
* Set default locale,
* It will be added as default locale
* when locales table migrated
*/
'locale' => 'en',
/**
* Path where your eloquent models are
*/
'models_path' => '',
/**
* Route from which your Dashboard will be available
*/
'route' => 'seo-manager',
/**
* Middleware array for dashboard
* to prevent unauthorized users visit the manager
*/
'middleware' => [
// 'auth',
],
/**
* Routes which shouldn't be imported to seo manager
*/
'except_routes' => [
'seo-manager',
'admin'
//
],
/**
* Columns which shouldn't be used ( in mapping )
*/
'except_columns' => [
// "created_at",
// "updated_at",
],
/**
* Set this parameter to true
* if you want to have "$metaData" variable
* shared between all views in "web" middleware group
*/
'shared_meta_data' => false
];
After finishing with all configurations run php artisan migrate to create SEO manager table.
That's it, now your SEO manager will be available from /seo-manager URL (or, if you changed route config, by that config URL)

After visiting your dashboard URL you have to import your routes to start to manage them.
Route importing will store all your GET routes into the database ( except the ones which specified in "except_routes" configs).

Mapping
To get dynamically changing metadata you should map your route params to the correct Models.
Param: Route param
Model: Eloquent Model which you are using to get the record by route param
Find By: Database table column name which you are using to get the record by route param
Use Columns: Database table columns which we should use for further mapping
Note: If you have appended attributes inside your model via protected $appends and you want to use them in mapping you have to use Lionix\SeoManager\Traits\Appends; trait inside your model.
Mapping available only if your route has params
Next steps you can do, is to set Keywords, Description, Title, URL, Author, Title Dynamic, OpenGraph Data.
About "Title Dynamic":
Here you can drag & drop your mapped params, your title and write custom text to generate the dynamic title for your page. Every time your "title" will be changed or your mapped params value changed, the dynamic title will be changed automatically.
About "Open Graph":
Here you can write your open graph data or map your fields to mapping based on params.

use Lionix\SeoManager\Facades\SeoManager;
This will return an array with all your SEO Manager data
SeoManager::metaData();
Example:
array:13 [▼
"keywords" => "First Keyword, Second, Third"
"description" => "Test Description"
"title" => "Test Titile"
"url" => "http://example.com/users/1"
"author" => "Sergey Karakhanyan"
"title_dynamic" => "Test Titile - Custom Text - Test User Name "
"og:url" => "http://example.com/users/1"
"og:type" => "website"
"og:image:url" => "https://wallpaperbrowse.com/media/images/3848765-wallpaper-images-download.jpg"
"og:title" => "Test Titile - Custom Open Graph Text"
"og:locale" => "en_GB"
"og:site_name" => "Seo Manager Package"
"og:description" => "Open Graph Description"
]
SeoManager::metaData(); method can receive property variable to get the value of some property
Example:
SeoManager::metaData('keywords'); will return "First Keyword, Second, Third"
To get only OpenGraph data array:
SeoManager::metaData('og_data');
Example
array:7 [▼
"og:url" => "http://example.com/users/1"
"og:type" => "website"
"og:image:url" => "https://wallpaperbrowse.com/media/images/3848765-wallpaper-images-download.jpg"
"og:title" => "Test Titile - Custom Open Graph Text"
"og:locale" => "en_GB"
"og:site_name" => "Seo Manager Package"
"og:description" => "Open Graph Description"
]
Aliases
SeoManager::metaKeywords()
SeoManager::metaTitle()
SeoManager::metaDescription()
SeoManager::metaUrl()
SeoManager::metaAuthor()
SeoManager::metaTitleDynamic()
SeoManager::metaOpenGraph() - Can receive property variable to get the value of some OG property
Example
SeoManager::metaOpenGraph('og:image:url')
Will return "https://wallpaperbrowse.com/media/images/3848765-wallpaper-images-download.jpg"

metaData()
metaKeywords()
metaTitle()
metaDescription()
metaUrl()
metaAuthor()
metaTitleDynamic()
metaOpenGraph()

You can use this blade directives in your view files to get metadata.
@meta
Output Example
<meta property="keywords" content="First Keyword, Second, Third">
<meta property="description" content="Test Description">
<meta property="title" content="Test Titile">
<meta property="url" content="http://packages.loc/users/1">
<meta property="author" content="Sergey Karakhanyan">
<meta property="title_dynamic" content="Test Titile - Custom Text - Test User Name ">
<meta property="og:url" content="http://packages.loc/users/1">
<meta property="og:type" content="website">
<meta property="og:image:url" content="https://wallpaperbrowse.com/media/images/3848765-wallpaper-images-download.jpg">
<meta property="og:title" content="Test Titile - Custom Open Graph Text">
<meta property="og:locale" content="en_GB">
<meta property="og:site_name" content="Seo Manager Package">
<meta property="og:description" content="Open Graph Description">
@meta can receive property param
@meta('description')
Output Example
<meta property="description" content="Test Description">
Note: You can't add open graph properties to @meta() like @meta('og:url') But you can get only OpenGraph meta data by @meta('og_data'). If you want to get concrete OG param meta tag you can use @openGraph (similar to @meta('og_data')) and pass param there like @openGraph('og:url)
Note #2: If you want to do modifications in your og data and display it manually, you should do that before @meta
Example:
<meta property="og:image:url" content="{{ asset(metaOpenGraph('og:image:url')) }}">
@meta
Aliases
@keywords
@url
@author
@description
@title
@openGraph
@titleDynamic - will return dynamically generated title which you can use inside your tags.

  1. 1.
    Install the module in a existing Laravel project and check if the module is working.
  2. 2.
    Delete the folder vendor/lionix/seo-manager.
  3. 3.
    Copy the fork of the module in the vendor/lionix/seo-manager folder (don't know how to make a fork? https://kbroman.org/github_tutorial/pages/fork.html)
  4. 4.
    Add the following line to your webpack.mix.js mix.js('vendor/lionix/seo-manager/src/vue/seo-manager.app.js', 'public/vendor/lionix/js');
  5. 5.
    run the NPM Watch command npm run watch
  6. 6.
    If everything works fine, you can start developing on the module
  7. 7.
    PLEASE REMIND TO COPY YOUR public/vendor/lionix/js/seo-manager.app.js TO vendor/lionix/seo-manager/src/assets/seo-manager.app.js

Copy link
On this page
Seo Manager Package for Laravel ( with Localization )
Update:
Localization
Installation
Usage
Example Usage
Via SeoManager Facade
Via helper functions
Via @Blade directives
Contributing
Credits