Référence rapide

Aide-mémoire Gem Rails meta-tags

Guide rapide pour la gem Ruby on Rails meta-tags : titres dynamiques, Open Graph, Twitter Cards, URL canoniques et helpers de vue.

· Publié le

meta-tags est une gem Ruby on Rails rendant la gestion des balises SEO, propriétés Open Graph et Twitter Cards propre et maintenable.

Installation

Ajoutez à votre Gemfile :

gem 'meta-tags'

Générez l’initialiseur de configuration :

rails generate meta_tags:install

Définir les titres de page

Utilisez set_meta_tags dans vos contrôleurs ou vues :

# Titre simple
set_meta_tags title: 'Member Login'
# => <title>Member Login</title>

# Titre avec préfixe de site
set_meta_tags site: 'My SaaS', title: 'Dashboard'
# => <title>My SaaS | Dashboard</title>

# Titre inversé avec séparateur personnalisé
set_meta_tags(
  site: 'My SaaS',
  title: 'Dashboard',
  reverse: true,
  separator: '&middot;'.html_safe
)
# => <title>Dashboard · My SaaS</title>

Définir les balises SEO et réseaux sociaux

set_meta_tags(
  site: 'My Store',
  title: 'Organic Green Tea',
  description: 'Pure, ceremonial-grade organic Japanese green tea.',
  keywords: %w[green tea organic matcha],
  canonical: 'https://example.com/products/green-tea',
  icon: '/favicon.ico',
  noindex: false,
  nofollow: false,
  og: {
    title: 'Organic Green Tea',
    type: 'website',
    url: 'https://example.com/products/green-tea',
    image: 'https://example.com/images/tea.jpg'
  },
  twitter: {
    card: 'summary_large_image',
    site: '@mystore',
    title: 'Organic Green Tea'
  }
)

Helpers de vue

Rendu dans le layout

Dans app/views/layouts/application.html.erb :

<head>
  <%= display_meta_tags site: 'Default Site Title' %>
</head>

Définition directe dans les vues

<% title 'Account Settings' %>
<% description 'Manage your billing and notification preferences.' %>

<h1><%= current_title %></h1>

Références

Sujets associés