README.md

Seorules

A package for building seo rules in your Laravel projects. Manage with ease SEO meta tags (title, description, keywords, noindex) of your pages.

Installation

To install Seorules as a Composer package to be used with Laravel 4, simply add this to your composer.json:

"spescina/seorules": "dev-master"

and run composer update.

Once it's installed, you have to register the service provider. In app/config/app.php add the following line of code to the providers array:

'Spescina\Seorules\SeorulesServiceProvider'

If you want in app/config/app.php add the following line of code to the alias array

'Seo' => 'Spescina\Seorules\Facades\Seo'

Then, publish the config files with php artisan config:publish spescina/seorules.

The last thing to do is to run the startup migration with php artisan migrate --package="spescina/seorules".

Usage

Define your rules creating entries in the seorules database table

• alias: system identificative name of the rule
• route: name of the target route
• pattern: regular expression for matching page url (used for targeting different pages on the same route)
• priority: highest value come first
• title: title tag
• description: description meta tag
• keywords: keywords meta tag
• noindex: noindex meta tag

{
  alias: 'first',
  route: 'first.route',
  pattern: '',
  priority: 0,
  title: 'the first route title is [#_first_placeholder]',
  description: 'my first route description is [#_second_placeholder]',
  keywords: '[#_first_placeholder], [#_second_placeholder], laravel',
  noindex: 0
},
{
  alias: 'second',
  route: 'second.route',
  pattern: '',
  priority: 0,
  title: 'the second route title is [#_second_placeholder]',
  description: 'my second route description is empty',
  keywords: '[#_first_placeholder]',
  noindex: 1
}

Attach seorules.before filter to your target named routes (route groups are reccomended)

Route::group(array('before' => 'seorules.before'), function()
{
    Route::get('/first', array('as' => 'first.route', function(){
        //do things
    }));

    Route::get('/second', array('as' => 'second.route', function(){
        //do things
    }));
});

Manage your rules in your controllers or in your closures

Seo::addPlaceholder('first_placeholder','Foo');
Seo::addPlaceholder('second_placeholder','Bar');

Display prepared fields in your views

<title>{{ Seo::get('title') }}</title>
<meta name="description" content="{{ Seo::get('description') }}" />
<meta name="keywords" content="{{ Seo::get('keywords') }}" />
@if (Seo::get('noindex'))
<meta name="robots" content="noindex" />
@endif

Now you should have rendered this code when visiting /first (assuming both routes are prepared with same placeholder data)

<title>the first route title is Foo</title>
<meta name="description" content="my first route description is Bar" />
<meta name="keywords" content="Foo, Bar, laravel" />

and when visting /second

<title>the second route title is Bar</title>
<meta name="description" content="my second route description is empty" />
<meta name="keywords" content="Foo" />
<meta name="robots" content="noindex" />