Add support for organization mentions in LinkedIn (#321)

* Adds support for linking organization mentions in linkedin

* Fix markdown formatting handling for organization mentions in LinkedIn posts

Author: arash77

README.md

@@ -163,4 +163,4 @@ Remember to add the env variable that needed for each social media seperatly.
 - Mastodon: Mentions should be in the format `username@server-domain`.
 - Matrix: Hashtags can be included in the post but have no special function. Mentions should be in the format `username:server-domain`.
 - Slack: Mentions and hashtags are not supported!
-- Linkedin: Mentions are not supported!
+- Linkedin: Mentions are only supported for organizations. The vanity name (company URL ID) should be used for this purpose.

docs/index.html

@@ -491,7 +491,7 @@ <h2 id="output-heading" class="text-xl font-semibold mb-2"></h2>
 
             const tagContainer = document.createElement("div");
             tagContainer.className = "space-y-2 hidden";
-            if (!name.includes("slack") && !name.includes("linkedin")) {
+            if (!name.includes("slack")) {
               const mIn = document.createElement("input");
               mIn.id = `mention-${name}`;
               mIn.placeholder = "Mentions";
@@ -506,14 +506,16 @@ <h2 id="output-heading" class="text-xl font-semibold mb-2"></h2>
               let validator = null;
 
               if (name.includes("bluesky")) {
-                format = "username.server";
+                format = "username.server (e.g. galaxyproject.bsky.social)";
                 validator = (tag) => /^[^@:\s]+\.[^@:\s]+$/.test(tag.value);
               } else if (name.includes("mastodon")) {
-                format = "username@server";
+                format = "username@server (e.g. galaxyproject@mstdn.science)";
                 validator = (tag) => /^[^@:\s]+@[^@:\s]+$/.test(tag.value);
               } else if (name.includes("matrix")) {
-                format = "username:server";
+                format = "username:server (e.g. bgruening:matrix.org)";
                 validator = (tag) => /^[^@:\s]+:[^@:\s]+$/.test(tag.value);
+                } else if (name.includes("linkedin")) {
+                  format = "vanityName (e.g. galaxy-project)";
               }
 
               if (format) {

lib/plugins/linkedin.py

@@ -49,9 +49,29 @@ def wrap_text_with_index(self, content):
             final_lines.append(f"{line} ({i}/{len(wrapped_lines)})")
         return final_lines
 
+    def build_organization_mentions(self, mentions):
+        output = []
+        for mention in mentions:
+            vanity_name = mention.strip()
+            urn = None
+            try:
+                response = requests.get(
+                    f"{self.api_base_url}/organizations",
+                    headers=self.headers,
+                    params={"q": "vanityName", "vanityName": vanity_name},
+                )
+                response.raise_for_status()
+                elements = response.json().get("elements", [])
+                if elements and (org_id := elements[0].get("id")):
+                    urn = f"urn:li:organization:{org_id}"
+                    mention = elements[0].get("localizedName")
+            except Exception as e:
+                print(f"[WARN] Failed to resolve @{mention}: {e}")
+            output.append(f"@[{mention}]({urn})" if urn else f"@{mention}")
+        return " ".join(output)
+
     def format_content(self, content, mentions, hashtags, images, **kwargs):
-        # the mentions are not linked to anyone!
-        mentions = " ".join([f"@{v}" for v in mentions])
+        mentions = self.build_organization_mentions(mentions)
         hashtags = " ".join([f"#{v}" for v in hashtags])
         if len(images) > 20:
             warnings = f"A maximum of 20 images, not {len(images)}, can be included in a single linkedin post."
@@ -60,11 +80,23 @@ def format_content(self, content, mentions, hashtags, images, **kwargs):
             warnings = ""
 
         # convert markdown formatting because linkedin doesn't support it
+        protected_mentions = {}
+
+        def protect(match):
+            key = f"PROTECTED_MENTION_{len(protected_mentions)}"
+            protected_mentions[key] = match.group(0)
+            return key
+
+        content = re.sub(r"@\[[^\]]+\]\(urn:li:organization:\d+\)", protect, content)
+
         paragraphs = content.split("\n\n\n")
         for i, p in enumerate(paragraphs):
             paragraphs[i] = strip_markdown_formatting(p)
         content = "\n\n\n".join(paragraphs)
 
+        for key, value in protected_mentions.items():
+            content = content.replace(key, value)
+
         content += "\n"
         if mentions:
             content = f"{content}\n{mentions}"