, (*1)
Overview
This is the core metadata module for the graphiques-digitale/silverstripe-seo-* module collection., (*2)
It enables enhanced title features, character set selection, canonical URLs and an enhanced fall-back description using $Content.FirstParagraph()
., (*3)
Title inspired by: http://moz.com/learn/seo/title-tag, (*4)
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
, (*5)
These are all optional and fragmented from the alpha version Graphiques-Digitale/SSSEO
, which is now redundant., (*6)
The whole module collection is based largely on 18 Meta Tags Every Webpage Should Have in 2013., (*7)
Also, a good overview: 5 tips for SEO with Silverstripe 3., (*8)
Installation
Composer
composer require graphiques-digitale/silverstripe-seo-metadata
- rebuild using
/dev/build/?flush
From ZIP
- Place the extracted folder
silverstripe-seo-metadata-{version}
into silverstripe-seo-metadata
in the SilverStripe webroot
- rebuild using
/dev/build/?flush
CMS Usage
See /silverstripe-seo-metadata/_config/app.yml
for configuration., (*9)
Metadata is changed globally via /admin/settings/
under the Metadata tab., (*10)
And also locally, per page, under their Metadata tab., (*11)
Template Usage
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.:, (*12)
<head>
<% base_tag %>
$Metadata()
<!-- further includes ~ viewport, etc. -->
</head>
This will output something along the lines of:, (*13)
<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>
Advanced Usage
Please check the documentation
folder for how to extend classes and more., (*14)
Issue Tracker
Issues are tracked on GitHub @ Issue Tracker, (*15)
Development and Contribution
Please get in touch @ hello@graphiquesdigitale.net
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., (*16)
License
BSD-3-Clause license, (*17)
See @ [Why BSD?][8], (*18)
, (*19)
, (*20)
, (*21)
, (*22)