The `meta_tags` helper automatically generates SEO and social sharing meta tags.
## Usage
In the layout (e.g., `app/views/layouts/application.html.erb`), add the helper to the `` section:
```erb
…
<%= meta_tags %>
…
```
Render specific subsets of tags:
```erb
<%= meta_tags only: %w[title description] %>
```
Or exclude certain tags:
```erb
<%= meta_tags except: %w[twitter_card twitter_image] %>
```
## Priority
Values are determined with the following precedence, from highest to lowest:
### 1. Controller action
Define a `@metadata` instance variable in the controller:
```ruby
class Content::PostsController < ApplicationController
def index
@metadata = {
title: "All Blog Posts",
description: "A collection of our articles."
}
@resources = Content::Post.all
end
end
```
### 2. Page frontmatter
Add values to the YAML frontmatter in content files:
```yaml
---
title: My Awesome Post
description: A deep dive into how meta tags work.
image: /assets/images/my-awesome-post.png
author: Kendall
---
Your content here…
```
### 3. Collection configuration
Set collection defaults in the resource model:
```ruby
class Content::Post < Perron::Resource
configure do |config|
# …
config.metadata.description = "Add forms to any static site. Display responses anywhere."
config.metadata.author = "Chirp Form team"
end
end
```
### 4. Default values
Set site-wide defaults in the initializer:
```ruby
Perron.configure do |config|
# …
config.metadata.description = "Add forms to any static site. Display responses anywhere."
config.metadata.author = "Chirp Form team"
end
```
## Generated HTML Tags
Below is a complete list of the HTML tags that the `meta_tags` helper can generate. The helper will only render a tag if its corresponding data (e.g., content or href) is present.
```html
…
```