58c31ea391
- Ajout de tobimori/kirby-seo via Composer
- snippet('seo/head') dans header.php (remplace les meta manuels)
- snippet('seo/schemas') dans footer.php pour JSON-LD
- Onglet SEO ajouté dans site.yml et tous les blueprints de pages
- Configuration SEO dans config.php (sitemap, robots, canonicalBase TODO)
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
5 KiB
| title | intro |
|---|---|
| Quickstart | All you need to get started with Kirby SEO: Installation & initial configuration |
Requirements
Kirby SEO requires
- Kirby 5 or later
- PHP 8.3, 8.4 or 8.5
Composer is required for full feature support (e.g. schema.org support, background queuing). Composer is a dependency manager for PHP. If you have never used Composer before, follow the instruction on the Composer website.
Installing Kirby SEO
In a terminal window, navigate to the folder of your Kirby installation. Then run the following command:
composer require tobimori/kirby-seo
Some features require additional packages. Install them when you need them:
- Schema.org requires
spatie/schema-org - Background Processing (coming soon)
Manual Installation
If you prefer not to use Composer, you can manually install Kirby SEO. Go to the GitHub releases page and find the latest release. Click on "Assets" to expand it and select "Source code (zip)". Extract the contents of the zip file into the site/plugins/kirby-seo folder of your Kirby installation.
Add meta tags to your site
Kirby SEO needs two snippets in your HTML: one in the <head> for meta tags, and one before </body> for structured data.
Find the place in your code where you output the <head> tag, this is usually a shared snippet like header.php or a layout file. Add the seo/head snippet to your <head> and the seo/schemas snippet before the </body> closing tag:
<html lang="<?= $site->lang() ?>">
<head>
<?php snippet('seo/head'); ?>
</head>
<body>
[...]
<?php snippet('seo/schemas'); ?>
</body>
</html>
Make sure your <html> tag also includes the lang attribute as shown above. Browsers use it for automatic hyphenation, and Google uses it to determine the language of your page.
Now open your site in a browser and view the page source. You should already see <title>, <meta> and Open Graph tags in your <head>. The plugin fills them with sensible defaults out of the box.
Editing meta tags in the panel
Next, you want to give your editors control over the SEO fields. Add the SEO tab to your site blueprint:
# site/blueprints/site.yml
tabs:
content:
fields:
# move your existing fields here
seo: seo # <--- add this
This gives you global defaults for meta titles, descriptions and social images. Any page without its own SEO settings will use these. Learn more about how defaults work in Your first Meta Tags.
And now add the SEO tab to any page blueprint where editors should be able to override the defaults:
# site/blueprints/pages/default.yml
tabs:
content:
fields:
# move your existing fields here
seo: seo # <--- add this
Open the Panel and navigate to any page. You'll see a new SEO tab with fields for meta title, description, social images and more.
Try it: enter a custom meta title, save, and reload the page in your browser. View the source, your title is there.
Now delete the title you just entered and reload again. The plugin falls back to your page's regular title.
This is the Meta Cascade, the plugin always finds the best available value, so you only need to fill in fields when you want to override the default. Learn more about the Meta Cascade.
Set your canonical URL
To prevent duplicate content issues (e.g. if your site is reachable with and without www), tell the plugin which URL is the canonical one:
// site/config/config.php
return [
// [...]
'tobimori.seo' => [
'canonical' => [
'base' => 'https://www.example.com',
],
]
];
Reload your page and check the source. You'll see a <link rel="canonical"> tag pointing to your configured domain.
Single-language setup
If you're not using Kirby's multi-language feature, set your language code so the plugin can generate the correct og:locale tag:
// site/config/config.php
return [
// [...]
'tobimori.seo' => [
'canonical' => [
'base' => 'https://www.example.com',
],
'locale' => 'en_US',
],
];
If you already added the canonical config above, add lang to the same tobimori.seo block.
If you already have multi-language set up in Kirby the plugin will pick up the language automatically.
Purchase license & activate your installation
Once you publish your website, you need to purchase a Kirby SEO license. We will send you a unique license code for your domain. You can activate your license with the following steps:
- Open the Panel at
https://example.com/paneland log in. - Click on the "Metadata & SEO" tab, and click on "Activate" in the top right.
- Enter your license code and your email address and press "Activate".
It is not required to activate your license locally.