lionix / seo-manager
SEO Manager for Laravel Framework
Installs: 5 271
Dependents: 0
Suggesters: 0
Security: 0
Stars: 213
Watchers: 11
Forks: 34
Open Issues: 3
Requires
- php: ^7.0|^8.0
- illuminate/support: 5.5.* || 5.6.* || 5.7.* || 5.8.* || 6.* || 7.* || 8.*
This package is auto-updated.
Last update: 2024-10-18 23:24:38 UTC
README
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.
Update:
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 latest configs and new migration files.
Localization
In version v1.2.* you will have availability to localize your metadata and set translates to your data.
For that, you just should add your available locales with top right button "Add Locales" and chose 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?
Installation
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)
Usage
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).
Let the fun begin!
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 useLionix\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.
Example Usage
Via SeoManager
Facade
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"
Via helper
functions
metaData()
metaKeywords()
metaTitle()
metaDescription()
metaUrl()
metaAuthor()
metaTitleDynamic()
metaOpenGraph()
Via @Blade directives
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 <title></title>
tags.
Contributing
How to start developing on this project
-
Install the module in a existing Laravel project and check if the module is working.
-
Delete the folder vendor/lionix/seo-manager.
-
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)
-
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');
-
run the NPM Watch command
npm run watch
-
If everything works fine, you can start developing on the module
-
PLEASE REMIND TO COPY YOUR
public/vendor/lionix/js/seo-manager.app.js
TOvendor/lionix/seo-manager/src/assets/seo-manager.app.js