Kirby SEO plugin

[jimbobrjames]

Just pushed out my own solution to generating meta tags for SEO and social media sharing.

HashandSalt/kirby3-seo

It’s great used in tandem with my schema plugin:

HashandSalt/kirby3-schema

[morganpouco]

Hi,
I am a pb with plugin. Undefined variable: metatitle when à add the snippet in the snippet header.
A solution ?

[jimbobrjames]

Welcome to the forum @morganpouco

It sounds like you are missing a controller. You can read about these here… https://getkirby.com/docs/guide/templates/controllers

To fix it, you need create a controller in site/contollers that matches the name of your templates. You need one for each template you have in site/templates.

So for default.php template, the controller will look something like this:

<?php

return function ($page, $kirby, $site) {

  // Meta
  $seo = $kirby->controller('seo' , compact('page', 'site', 'kirby'));

  // Override Meta Title
  $metatitle = $page->title().' | '.$site->title();

  // Pass through data
  $data = compact('metatitle');

  return a::merge($seo , $data);

};

This brings in the shared controller from the plugin and makes its variables available to the page template.

I hope that helps

[morganpouco]

Thx for the help. It’s ok for me now !

[jimbobrjames]

Smashing

[izag]

Hi guys, i am very new to kirby and have trouble running the kirby3-seo plugin on the starterkit - there seems to be a problem with the “album.tpl” controller . A little help would be greatly appreciated:

Also - having trouble adding the tabs as described in the read me file - should the tab folders from the plugin be copied to the blueprints folder?

Is really just adding this sufficient or should i structure also the other tab for the Note-Content?

title: Note
tabs:

  # SEO META
  meta: tabs/seo/meta

Many thanks,
Ivan

[texnixe]

Hey Izag,

you cannot have to return functions in the controller, you have to merge the stuff from the original album.php controller with the stuff that is required. for the plugin.

[izag]

@jimbobrjames

return a::merge

Thank you - may i ask for some more help how to merge them?=)

[jimbobrjames]

@izag

Thank you - may i ask for some more help how to merge them?=)

There is an example in the plugins documentation:

<?php

return function ($page, $kirby, $site) {

  // Meta
  $seo = $kirby->controller('seo' , compact('page', 'site', 'kirby'));

  // Override Meta Title
  $metatitle = $page->seotitle().' | '.$site->title();

  $data = compact('metatitle');

  return a::merge($seo, $data);

};

In your case, you have a gallery to pass through, so the controller should only contain this:

<?php

return function ($page, $kirby, $site) {

  // Meta
  $seo = $kirby->controller('seo' , compact('page', 'site', 'kirby'));

  $gallery = $page->images()->sortBy('sort');

  $data = compact('gallery');

  return a::merge($seo, $data);

};

[izag]

Wow thank you so much for the quick reply! It worked!

[jessxuan]

Hello, I’m a bit of a beginner dev and trying to get the ‘shareimage’ to come through. Not sure if I’m doing this correctly?

I’m just building a one-pager site, so this is my controllers/site.php:

<?php

return function ($page, $kirby, $site) {

  // Meta
  $seo = $kirby->controller('seo' , compact('page', 'site', 'kirby'));

  // Override Meta Title
  $metatitle    =   $site->title();
  $metadesc     =   $site->seometa();
  $metakeywords =   $site->seotags();
  $metaimage    =   $site->shareimage();

  $metatwcard   =   'summary';


  // Pass through data
  $data = compact(
    'metatitle',
    'metadesc',
    'metakeywords',
    'metaimage',
    'metatwcard'
  );

  return a::merge($seo , $data);

};
?>

I’ve uploaded a test image into the panel under shareimage per the default yml, but the output when I try either $site->shareimage(); or $site->shareimage()->url(); are both:

<meta content="- share-image-test.png" property="og:image">

truncated, without the full url… Any help would be appreciated. Thanks!

[jessxuan]

Okay sorry, should have spent an extra 5 mins delving — I followed this thread: Image()->url only coming up broken

and now it outputs the full url with this instead

edit: need to check file exists as per below replies. don’t use below code.

  $metaimage    =   $site->shareimage()->toFile()->url();

Thanks for giving me brain dump space… I’ll just leave this up in case anyone runs into this issue…

[jimbobrjames]

No worries, glad you got it working. However, you should check the image physically exists before trying to use it:

$metaimage = $site->shareimage()->toFile() ? $site->shareimage()->toFile()->crop(1280, 720)->url() : ' ',

[texnixe]

@jessxuan

$metaimage = $site->shareimage()->toFile()->url();

Please don’t call URL (or any other class method) without making sure the object exists:

$metaimage    =   $site->shareimage()->toFile()? $site->shareimage()->toFile()->url() : '';

@jimbobrjames beat me to it

[jimbobrjames]

Great Minds

[jessxuan]

Thanks both! Have changed it accordingly.

[Ralf]

Hi,

how do I get meta description and title working with kirby-blogposts? I edited several files, but I don’t have this fields using the kirby backend.

Thanks & best regards,
ralf

[texnixe]

You have to add the meta fields to your blog post blueprints, see the readme of the plugin: https://github.com/HashandSalt/kirby3-seo