Grav AutoSEO is a plugin for Grav with which you can fill automatically the description and keywords metadata of a page using its content. It also adds Facebook Open Graph metadata and Twitter Cards Meta Tags (New feature since the 1.2 version).
If the plugin is enabled and the description and keyword metadata of the page are not manually filled (i.e. the page headers contains some metadata fields), the plugin will use the first words of the page summary to fill the description and its categories and tags to fill the keyword metadata. Facebook and twitter metadata will also be filled if they are enabled in settings and not manually filled in the page header.
To install this plugin, just download the zip version of this repository and unzip it under
/your/site/grav/user/plugins. Then rename the folder to
You should now have all the plugin files under
Here is the default configuration and an explanation of available options:
enabled: true # lets you turn the plugin off and on. description: enabled: true # lets you turn the plugin off and on for the "description" metadata. length: 30 # maximal number of words that will be used to fill the "description" metadata. keywords: enabled: true # lets you turn the plugin off and on for the "keywords" metadata. length: 20 # maximal number of words that will be used to fill the "keywords" metadata. facebook: enabled: true # Lets you turn the plugin ON and OFF for the "Facebook Open Graph" metadata. twitter: enabled: true # Lets you turn the plugin ON and OFF for the "Twitter Cards" metadata.
- The first
enabledfield lets you turn the plugin on and off.
enabledfield in each metadata section lets you turn on and off the plugin for this metadata only.
lengthis the maximal count of words that will be used to fill the corresponding metadata.
If you need to change any value, then the best process is to copy the
autoseo.yaml file into your
users/config/plugins/ folder (create it if it doesn't exist), and then modify there. This will override the default settings.
If you want to alter the settings for one or a few pages only, you can do so by adding page specific configurations into your page headers, e.g.
to disable the
AutoSeo plugin just for this page.
Remember you can also override the general plugin settings for a specific page by adding settings in its header. For instance, adding the following lines in a page headers
autoseo: enabled: true description: enabled: true length: 10 keywords: enabled: true length: 10 facebook: enabled: true twitter: enabled: false
will change the description and keyword lengths to 10 words for these page only, enable Facebook Open Graph metadata and disable Twitter Cards tags.
There's not much to do with this plugin, simply install, enabled it and check its configuration to meet your needs.
No need to do anything else.
The plugin is installed and enabled on the following blog : http://www.gamecoderblog.com.
To see it in action, you have to inspect the meta of the page code source. (Use a page other than the home page, because the metadata used in it are those set in the blog configuration)
As each page must be analyzed and its content filtered by the plugins, the impact on performance can be important when first access to a page. But as the result will be cached, once the first analysis is done, you will find no further negative performance impact.
To limit the impact on performance, the content analyzed will always be truncated to the 1000 first characters for description metadata, then the limit given by the
length setting will be applied.
AutoSeo will make a few cleaning but won't check the content used to auto fill the metadata.
So be sure that the first words of your content (the summary) will be correct to be used as a description.
In a same way, check that the tags and categories of the page are OK to be used as keyword.
Bugs And TODO
Please send any comments or bug reports to the plugin's issue tracker.
- No new feature is planned for the moment.
AutoSeo is developed and maintained by Laurent Ongaro.