# HG changeset patch
# User JC Brand <jc@opkode.com>
# Date 1614012711 -3600
# Node ID 205e50fdcebce0de05e742b7777d0b1b342e8961
# Parent  dbfda7f5522de274e1926b5c6d8465d09277cd7f
mod_ogp: Add README

diff -r dbfda7f5522d -r 205e50fdcebc mod_ogp/README.markdown
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_ogp/README.markdown	Mon Feb 22 17:51:51 2021 +0100
@@ -0,0 +1,18 @@
+# mod_ogp
+
+This module adds [Open Graph Protocol](https://ogp.me) metadata to URLs sent inside a MUC.
+
+With mod_ogp enabled, when a user sends a URL in a MUC (where the message has its `id` equal to its `origin-id`), the module calls the URL and parses the result for `<meta>` html tags that have any `og:...` properties.
+If it finds any, it sends a [XEP-0422 fastening](https://xmpp.org/extensions/xep-0422.html) applied to the original message that looks like:
+
+```
+    <message id="example" from="chatroom@chatservice.example" to="chatroom@chatservice.example">
+        <apply-to xmlns="urn:xmpp:fasten:0" id="origin-id-X">
+            <meta xmlns="http://www.w3.org/1999/xhtml" property="og:title" content="The Rock"/>
+            <meta xmlns="http://www.w3.org/1999/xhtml" property="og:url" content="https://www.imdb.com/title/tt0117500/"/>
+            <meta xmlns="http://www.w3.org/1999/xhtml" property="og:image" content="https://ia.media-imdb.com/images/rock.jpg"/>
+        </apply-to>
+    </message>
+```
+
+The module is intentionally simple in the sense that it is basically a transport for https://ogp.me/