SocialMeta provides automatic generation of og: and twitter: tags on your pages.
- Open Graph support
- Twitter Cards support
- Provides sane values by default, but users can override the tags in pages using the
metadataheader. - AboutMe plugin integration
As this plugin is not yet in the Grav repository, you need to install it manually. From your plugins folder:
git clone https://github.com/paulcmal/grav-plugin-socialmeta socialmeta
This will clone this repository into the socialmeta folder.
You need to include the partials\socialmeta.html.twig template where the <meta> tags are defined.
To integrate in the official Grav theme Antimatter, add at the end of your partials/metadata.html.twig:
{% include 'partials/socialmeta.html.twig' %}
To integrate in the HPSTR theme, add to partials/head.html.twig, just after <meta http-equiv="cleartype" content="on">:
{% include 'partials/socialmeta.html.twig' %}
If you need specific metadata for a page, just add them to this page as recommended in the Grav Docs.
SocialMeta first checks whether a metadata has been manually set before settings its default value.
SocialMeta supports AboutMe plugin. To add/change the Twitter defined in twitter:site, edit your profile in the AboutMe plugin.
Alternatively, you can manually add <meta name="twitter:site" property="twitter:site" content="@USERNAME"> to your <head>. In the default Antimatter, you can add it in templates/partials/metadata.html.twig.
For now this plugin is a test release. If the proposed defaults are widely accepted, I'll release version 1.0.
## Will it support customization of default values through the admin interface?
If some people find this useful (and ask for it), sure.
Short answer: no.
This plugin only adds metadata in the <head> of your pages. That means it cannot possibly add microformats2 to your site.
Like Open Graph and Twitter Cards tags, microformats2 are semantic markup: they add meaning to your website, for parsers to understand what information your page gives.
Open Graph and Twitter Cards, though, support only marking one item per page. microformats2, on the other hand, allows you to give meaning to content all over your website pages.
Implementing microformats2 support to become a part of the Indieweb is within the realm of theme-making, not plugin-making.
Don't hesitate to ask your theme maintainer to add microformats2 support, so all together we can take down GAFAMs.
This work is too short and generic to be subject to intellectual property laws. It is therefore considered to be in the public domain.
However, if need be, you can consider this work to be released under the Fuck Property Public License.
This production is released as part of the public domain. I renounce every so-called right of intellectual property over it.
As property is theft and oppression, and no form of property is ever tolerable, feel free to do what the fuck you want with it, but don't forget to share around in the pure copyleft spirit.
If you think some of the defaults proposed are just not the best, feel free to submit ideas and pull requests.