This is the core metadata module for the graphiques-digitale/silverstripe-seo-* module collection.
It enables enhanced title features, character set selection, canonical URLs and an enhanced fall-back description using $Content.FirstParagraph()
.
Title inspired by: http://moz.com/learn/seo/title-tag
It is intended to be used with it's siblings:
Graphiques-Digitale/silverstripe-seo-icons
Graphiques-Digitale/silverstripe-seo-facebook-domain-insights
Graphiques-Digitale/silverstripe-seo-open-graph
These are all optional and fragmented from the alpha version Graphiques-Digitale/SSSEO
, which is now redundant.
The whole module collection is based largely on 18 Meta Tags Every Webpage Should Have in 2013.
Also, a good overview: 5 tips for SEO with Silverstripe 3.
composer require graphiques-digitale/silverstripe-seo-metadata
- rebuild using
/dev/build/?flush
- Place the extracted folder
silverstripe-seo-metadata-{version}
intosilverstripe-seo-metadata
in the SilverStripe webroot - rebuild using
/dev/build/?flush
See /silverstripe-seo-metadata/_config/app.yml
for configuration.
Metadata is changed globally via /admin/settings/
under the Metadata tab.
And also locally, per page, under their Metadata tab.
Depending on your configuration, the general idea is to replace all header content relating to metadata with $Metadata()
just below the opening <head>
tag and <% base_tag %>
include, e.g.:
<head>
<% base_tag %>
$Metadata()
<!-- further includes ~ viewport, etc. -->
</head>
This will output something along the lines of:
<head>
<base href="http://dev.seo.silverstripe.org/"><!--[if lte IE 6]></base><![endif]-->
<!-- SEO -->
<!-- Metadata -->
<meta charset="UTF-8" />
<link rel="canonical" href="http://dev.seo.silverstripe.org/" />
<title>Your Site Name | Home - your tagline here</title>
<meta name="description" content="Welcome to SilverStripe! This is the default home page. You can edit this page by opening the CMS. You can now access the developer documentation, or begin the tutorials." />
<!-- END SEO -->
<!-- further includes ~ viewport, etc. -->
</head>
Please check the documentation
folder for how to extend classes and more.
Issues are tracked on GitHub @ Issue Tracker
Please get in touch @ [email protected]
if you have any extertise in any of these SEO module's areas and would like to help ~ they're a lot to maintain, they should be improved continually as HTML evolves and I'm sure they can generally be improved upon by field experts.
BSD-3-Clause license
See @ Why BSD?