02_DOAP.md

Usage with DataObjects as pages

Depending on the content-heavyness of a DataObject-as-page setup, the content and metadata presented to a crawler should actually be optimised as well. This module allows you to do this by applying an extension to the DataObject in question:

Article:
  extensions:
    - Syntro\SEO\Extensions\SEOExtension
  seo_title_fallback: Title

In Order to work correctly, the object in question needs to provide a Link() method for the analysis to run. The extension will add the necessary Fields and analyses to the CMS-fields. The Fallback field lets the module know, that in the case of no meta title being set, it should fall back to the $article->Title. It is recommended to always set the seo_title_fallback config correctly, especially if used in conjunction with seo_use_metatitle: false, as the latter would fall back to the title of the page rendering the object.

Now, you have to tell the page controller which is rendering the object, where to get the metadata from:

class BlogController extends PageController
{
    // ...
    //
    public function read(HTTPRequest $request)
    {
        $article = Article::get()->byID($request->param('ID'));
        $this->setSEOSource($article); // <- This is all you need
        return [
            'Article' => $article
        ]
    }
}

If you want to control metadata for sharing on social media and such, check out our syntro/silvershare module!