This bundle provides a simple and flexible API to manage search engine optimization (SEO) tags in your application. Its main goal is to make it simple for you to manage the most common meta, open graph and twitter card tags and to let you configure less common ones with ease.
Install the bundle with the command:
composer require leogout/seo-bundle
Register the bundle in your AppKernel:
class AppKernel extends Kernel
{
public function registerBundles()
{
$bundles = array(
// ...
new Leogout\Bundle\SeoBundle\LeogoutSeoBundle(),
);
}
}These configuration values are the defaults used to render your tags. See the next section to learn how to override them dynamically.
There are four sections in the config:
general: The global configuration. Its values are shared among the other as defaults.basic: A set of the most common SEO tags.og: A set of open graph tags based on http://ogp.me/.twitter: A set of twitter card tags based on https://dev.twitter.com/cards/types
See "Configuration reference" to get the whole configuration.
In your config.yml:
leogout_seo:
general:
title: Default title
description: Default description.
image: http://images.com/poneys/12/large # This one is shared by open graph and twitter only
basic:
title: Awesome title
keywords: default, keywords
canonical: ~ # Define dynamically in controller
pagination_previous: ~ # Define dynamically in controller
pagination_next : ~ # Define dynamically in controller
og:
# General
site_name: My website
type: website
url: http://test.com/articles
determiner: auto
# Image
image: http://images.com/poneys/12/large
image_secure_url: https://images.com/poneys/12/large
image_type: image/png
image_width: 400
image_width: 383
# Audio
audio: http://sounds.com/screaming-goats
audio_type: audio/mp3
audio_secure_url: https://sounds.com/screaming-goats
# Video
video: http://videos.com/more-screaming-goats
video_secure_url: https://videos.com/more-screaming-goats
video_type: video/png
video_width: 1200
video_width: 680
# Locales
locale: en_US
alternate_locales: ['nl_NL', be_NL', 'be_FR']
twitter:
card: summary
site: '@leogoutt'In your view:
<head>
{{ leogout_seo() }}
</head>NOTE: You can provide a generator name to the leogout_seo() twig method to render it specifically.
For example, to render the basic seo generator, you can use leogout_seo('basic').
The result:
<head>
<title>Awesome title</title>
<meta name="description" content="Default description." />
<meta name="keywords" content="default, keywords" />
<meta name="og:site_name" content="My website" />
<meta name="og:type" content="website" />
<meta name="og:title" content="Default title" />
<meta name="og:description" content="Default description." />
<meta name="og:image" content="http://test.com/articles" />
<meta name="og:audio" content="http://sounds.com/screaming-goats" />
<meta name="og:audio:type" content="audio/mp3" />
<meta name="og:audio:secure_url" content="https://sounds.com/screaming-goats" />
<meta name="og:video" content="http://videos.com/more-screaming-goats" />
<meta name="og:video:type" content="audio/mp3" />
<meta name="og:vide:secure_url" content="https://videos.com/more-screaming-goats" />
<meta name="og:locale" content="en_US" />
<meta name="og:locale:alternate" content="nl_NL" />
<meta name="og:locale:alternate" content="be_NL" />
<meta name="og:locale:alternate" content="be_FR" />
<meta name="twitter:title" content="Default title" />
<meta name="twitter:description" content="Default description." />
<meta name="twitter:image" content="http://images.com/poneys/12/large" />
<meta name="twitter:card" content="summary" />
<meta name="twitter:site" content="@leogoutt" />
</head>NOTE: By default, the SEO generators aren't loaded if you don't require them in the config. However, if you want to use the associated generators without configuring any default values (or configuring only the general ones), you can use this notation:
leogout_seo:
general:
title: Default title
description: Default description.
image: http://images.com/poneys/12/large # This one is shared by open graph and twitter only
basic: ~
og: ~
twitter: ~When you define default values for a provider, you must also specify the fields that you intent to set dynamically. For example, if we specify a default value for the title and description we must also add the canonical field or the tag won't be rendered. A tag is never rendered when the value NULL. To render the tag we will need to set the value dynamically.
leogout_seo:
basic:
title: Default title
description: Default description.
canonical: ~
og: ~
twitter: ~You can get the '[basic|twitter|og] as a service to set or override any values.
Each value of the configuration can be overrided using a setter of the following form:
$this->get('leogout_seo.provider.generator')->get(' [basic|twitter|og] ')->set [config field name] ( [value] )
For example, if you want to change title and robots from basic, you can do this:
class DefaultController extends Controller
{
public function indexAction()
{
$this->get('leogout_seo.provider.generator')->get('basic')
->setTitle('Title set in controller')
->setRobots(true, false); // they can be chained
return $this->render('AppBundle:Default:index.html.twig');
}
}You can configure your own model classes to let the seo generators do all the work thanks to the fromResource() method. Multiple interfaces are available to help the method guess which setters to call to fill the tags.
This is an exemple for the basic generator:
In your resource:
use Leogout\Bundle\SeoBundle\Seo\Stdlib\VideoInterface;
use Leogout\Bundle\SeoBundle\Seo\Stdlib\PageInterface;
use Leogout\Bundle\SeoBundle\Seo\Stdlib\VideoAggregateInterface;
class BlogPost implements PageInterface, VideoAggregateInterface
{
/**
* @return VideoInterface
*/
public function getVideo() {}
}In your controller:
class BlogController extends Controller
{
public function indexAction(Request $request)
{
// An example of how resources can be used. Look into the Stdlib folder to see which interfaces are currently
// supported.
$post = new BlogPost();
$post
->setTitle('10 things you did not know about goats')
->setVideo(new class implements VideoInterface {
public function getVideoUrl() { /* ...some logic... */}
public function getVideoSecureUrl() { /* ...some logic... */}
public function getVideoType() { /* ...some logic... */}
public function getVideoWidth() { /* ...some logic... */}
public function getVideoHeight() { /* ...some logic... */}
})
->setDescription('Skilled goats screaming passionately.')
->addKeyword('goat')
->addKeyword('screaming')
->addKeyword('flat tire');
$this->get('leogout_seo.provider.generator')->get('basic')->fromResource($myResource);
return $this->render('MyController:Default:index.html.twig');
}
}In your view:
<head>
{{ leogout_seo('basic') }}
</head>The result:
<head>
<title>Cool resource</title>
<meta name="description" content="Some description" />
<meta name="keywords" content="hey,ho,let's go!" />
</head>If the built-in generators don't suit your needs, LeogoutSeoBundle provides a way to create your own SEO generators. First, you have to create a class that extends the AbstractSeoGenerator class:
use Leogout\Bundle\SeoBundle\Seo\AbstractSeoGenerator;
class MyTagsGenerator extends AbstractSeoGenerator
{
public function setMyTag($content)
{
$this->tagBuilder->addMeta('myTag')
->setType(MetaTag::NAME_TYPE)
->setValue('myAwesomeTag')
->setContent((string) $content);
return $this;
}
public function getMyTag()
{
return $this->tagBuilder->getMeta('myTag');
}
}Then, register it as a service and add it a leogout_seo.generator tag and a custom alias.
Don't forget the @leogout_seo.builder dependency:
services:
app.seo_generator.my_tags:
class: AppBundle\Generator\MyTagsGenerator
arguments: [ '@leogout_seo.builder' ] # This is required
tags: { name: leogout_seo.generator, alias: my_tags }That's it, now you can use it alongside the others:
In your controller:
class MyController extends Controller
{
public function indexAction(Request $request)
{
$this->get('leogout_seo.provider.generator')->get('my_tags')->setMyTag('cool');
return $this->render('MyController:Default:index.html.twig');
}
}In your view:
<head>
{{ leogout_seo('my_tags') }}
</head>Result:
<head>
<meta name="myAwesomeTag" content="cool" />
</head>leogout_seo:
general:
title: Default title
description: Default description.
image: http://images.com/poneys/12/large
basic:
title: Basic title
description: Basic description.
keywords: default, keywords
canonical: http://test.com
robots:
index: false
follow: false
og:
title: Open graph title
description: Open graph description.
image: http://images.com/poneys/12/large
type: website # article, book, profile
url: http://test.com/articles
twitter:
title: Twitter title
description: Twitter description.
image: http://images.com/poneys/12/thumbnail
card: summary # summary_large_image
site: '@leogoutt' # optionnalIf you want to contribute (thank you!) to this bundle, here are some guidelines:
- Please respect the Symfony guidelines
- Test everything! Please add tests cases to the tests/ directory when:
- You fix a bug that wasn't covered before
- You add a new feature
- You see code that works but isn't covered by any tests (there is a special place in heaven for you)
- Packagist
Many thanks to the ARCANEDEV/SEO-Helper who authorized me to take some ideas from their library and to KnpMenuBundle which inspired me for the Providers APIs.