@frontity/head-tags

Description

This package is designed to get automatically all the data that the REST API Head Tags plugin exposes in the REST API, depending on the url. Basically, this plugin adds all the tags in the <head> section of a website to WordPress REST API responses, what is pretty useful for plugins like Yoast SEO or All in One SEO.

This package doesn't make sense without the mentioned plugin, so before installing the package you have to install the plugin in your WordPress backend.

Installation

Add the head-tags package to your project:

npm install @frontity/head-tags

Do this in your root and include it in your frontity.settings.js file:

...
packages: [
"@frontity/mars-theme",
"@frontity/tiny-router",
...
"@frontity/head-tags"
]
...

If you have an existing projectΒ make sure your @frontity/wp-source package is at least on the 1.5.0 version. If not, update it using this command: > npm install @frontity/wp-source@latest

Settings

As it works automatically, It doesn't have settings itself, but you it requires two Frontity parameters to work:

  • state.frontity.url : The url of your site. Usually defined at frontity.settngs.js file.

  • state.source.api: The api where your project is pointing. Defined at @frontity/wp-source if you haven't changed your Source.

It needs @frontity/wp-source installed and updated to at least the 1.5.0 version.

How to use

As mentioned before, it doesn't require any configuration. Just install it and everything will work out of the box. Note that you'll need the REST API Head Tags plugin installed in your WordPress.

This package needs these other Frontity packages:

API Reference

State

headTags.get

It is a function that accepts a linkas parameter and it returns an array with the head_tags field of that link.

state.headTags.get("/blog/hello-world/");

will return something like

[
{
"tag": "title",
"content": "Hello world! - My Site"
},
{
"tag": "meta",
"attributes": {
"name": "robots",
"content": "max-snippet:-1, max-image-preview:large, max-video-preview:-1"
}
},
{
"tag": "link",
"attributes": {
"rel": "canonical",
"href": "http://mysite.com/hello-world/"
}
}
]

​

Still have questions? Ask the community! We are here to help 😊