Generate OpenGraph tags for Article content type.

Additionally, adds a setting for mapping author names to X (Twitter) accounts, to be consistent with Facebook profiles.

Author: patrickfournier

pelican/plugins/seo/seo_enhancer/__init__.py

@@ -43,6 +43,11 @@ def launch_html_enhancer(
         if open_graph:
             html_enhancements["open_graph"] = html_enhancer.open_graph.create_tags()
 
+        if open_graph and hasattr(html_enhancer, "open_graph_article"):
+            html_enhancements["open_graph_article"] = (
+                html_enhancer.open_graph_article.create_tags()
+            )
+
         if twitter_cards:
             html_enhancements["twitter_cards"] = (
                 html_enhancer.twitter_cards.create_tags()
@@ -125,6 +130,18 @@ def add_html_to_file(self, enhancements, path):
             for og_property, og_content in enhancements["open_graph"].items():
                 self._add_meta_tag(soup, "property", "og", og_property, og_content)
 
+        if "open_graph_article" in enhancements:
+            for og_property, og_content in enhancements["open_graph_article"].items():
+                if isinstance(og_content, str):
+                    self._add_meta_tag(
+                        soup, "property", "article", og_property, og_content
+                    )
+                elif isinstance(og_content, list):
+                    for element in og_content:
+                        self._add_meta_tag(
+                            soup, "property", "article", og_property, element
+                        )
+
         with open(path, "w", encoding="utf8") as html_file:
             html_file.write(str(soup))
 

pelican/plugins/seo/seo_enhancer/html_enhancer/__init__.py

@@ -7,7 +7,7 @@
 from .article_schema_creator import ArticleSchemaCreator
 from .breadcrumb_schema_creator import BreadcrumbSchemaCreator
 from .canonical_url_creator import CanonicalURLCreator
-from .open_graph import OpenGraph
+from .open_graph import OpenGraph, OpenGraphArticle
 from .twitter_cards import TwitterCards
 
 
@@ -88,7 +88,25 @@ def __init__(self, file, output_path, path, open_graph=False, twitter_cards=Fals
                 locale=_settings.get("LOCALE"),
             )
 
+            if isinstance(file, Article):
+                _modified = getattr(file, "modified", None)
+                _author_profiles = _settings.get(
+                    "SEO_ENHANCER_AUTHOR_FACEBOOK_PROFILE", {}
+                )
+                _author_profile = _author_profiles.get(_author.name, None)
+                self.open_graph_article = OpenGraphArticle(
+                    date=_date,
+                    modified=_modified,
+                    category=_category.name,
+                    tags=getattr(file, "tags", []),
+                    author=_metadata.get("fb_profile") or _author_profile,
+                )
+
             if twitter_cards:
+                _author_profiles = _settings.get(
+                    "SEO_ENHANCER_AUTHOR_TWITTER_PROFILE", {}
+                )
+                _author_profile = _author_profiles.get(_author.name, None)
                 self.twitter_cards = TwitterCards(
-                    tw_account=_metadata.get("tw_account"),
+                    tw_account=_metadata.get("tw_account") or _author_profile,
                 )

pelican/plugins/seo/seo_enhancer/html_enhancer/open_graph.py

@@ -1,6 +1,8 @@
 import locale
 from urllib import parse
 
+from pelican.utils import strftime
+
 
 class OpenGraph:
     """
@@ -78,3 +80,34 @@ def create_tags(self) -> dict:
             open_graph_tags["locale"] = locale
 
         return open_graph_tags
+
+
+class OpenGraphArticle:
+    """
+    Get all Open Graph elements for an Article according to
+    https://ogp.me/?#no_vertical.
+    """
+
+    def __init__(self, date, modified, category, tags, author) -> None:
+        self.date = date
+        self.modified = modified
+        self.category = category
+        self.tags = tags
+        self.author = author
+
+    def create_tags(self) -> dict:
+        """
+        Compute all Open Graph elements for Article and return them in a ready-to-use
+        dict.
+        """
+        tags = {}
+        tags["published_time"] = strftime(self.date, "%Y-%m-%d")
+        if self.modified is not None:
+            tags["modified_time"] = strftime(self.modified, "%Y-%m-%d")
+        if self.category is not None:
+            tags["section"] = self.category
+        if self.tags is not None and self.tags:
+            tags["tags"] = self.tags
+        if self.author is not None:
+            tags["author"] = self.author
+        return tags