From 60ce50b10ee66f6d706b0715909e756e4bdba63d Mon Sep 17 00:00:00 2001
From: Trishul <trishul.goel@gmail.com>
Date: Thu, 28 May 2020 04:35:14 +0200
Subject: [PATCH] adding example of protocol_handlers (#451)

Thanks @tsl143  all looking good.
---
 examples.json                 |   5 +++++
 open-irc-links/README.md      |  14 ++++++++++++++
 open-irc-links/icons/icon.png | Bin 0 -> 3066 bytes
 open-irc-links/manifest.json  |  16 ++++++++++++++++
 4 files changed, 35 insertions(+)
 create mode 100644 open-irc-links/README.md
 create mode 100755 open-irc-links/icons/icon.png
 create mode 100755 open-irc-links/manifest.json

diff --git a/examples.json b/examples.json
index 1cf99499..4781600b 100644
--- a/examples.json
+++ b/examples.json
@@ -582,5 +582,10 @@
             "windows​.Window"
         ],
         "name": "window-manipulator"
+    },
+    {
+        "description": "Demonstrates the use of protocol handlers.",
+        "javascript_apis": [],
+        "name": "open-irc-links"
     }
 ]
diff --git a/open-irc-links/README.md b/open-irc-links/README.md
new file mode 100644
index 00000000..c54d60ea
--- /dev/null
+++ b/open-irc-links/README.md
@@ -0,0 +1,14 @@
+# open-irc-links
+
+
+## What it does
+
+This add-on sets the default client for opening IRC links using `protocol_handlers`.
+
+Whenever a link using the IRC protocol is clicked, the link is opened in the URI defined in the add-on's manifest.
+In this example, all IRC protocol links are opened in mibbit.com.  
+For example, once you've installed the extension, click this link [irc://irc.freenode.net/drupal](irc://irc.freenode.net/drupal) and the protocol handler opens the Drupal channel in mibbit.com.
+
+## What it shows
+
+How to use protocol handlers to pass content to an application or website designed to handle that content.
diff --git a/open-irc-links/icons/icon.png b/open-irc-links/icons/icon.png
new file mode 100755
index 0000000000000000000000000000000000000000..063cfa8f40d2773ce841dea48d343e3940b2b7ee
GIT binary patch
literal 3066
zcmV<W3kCFvP)<h;3K|Lk000e1NJLTq002M$002M;1^@s6s%dfF000ZYNkl<Zc-q}t
z3vg7`8NNO%0+v!@K|&HB+1-10m+}yh#{@*Nj3TvYC?Z&3gbpAt2_ebe#}dFIP(Tn+
zC`t!9P%IQ8Pivv=SSl?ebwC~yVD~<D^CX+7AdisS|GP`*hGdhy7cwNdGiQM0obUg>
z|GfVHoCCu|`E-W4U&-k7gg@K%j4ZO_WYO^}A8#LaeqNUZU1IKM8rhdOo%w+;JEglK
zv7;4<8}H{GBk}L!vy$47miuA`Lglk_Z0(dxTW?ixWNH%o7ggdkRdN<-5_d-7*|ish
zl)i@tGY?uN3ma!9wrhQMwyh(aT#(MRWXzDf?E@EZQUu33;(1Q-I*V1wC94v9z(*RO
z1)A!0L_zvbTB<_wAVp-~Q@u`E^SW+m^WA#2LO)X^=PAWw|2am96~gB-yC%!LL!zGA
zP9(P}f}L0R<gON-c|W)i->;+bg%(2-X@kaEfmA8Jts>f|P;VcjMpvj*)&PqrikJKP
z+&o8rvxF~rIwz_kw?&)px>SXwdR>?BGyKl9Gl>JZ)Wy}%LYklr8c%0Aeq0UY<kYxU
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
IM6N<$f{=>XX#fBK

literal 0
HcmV?d00001

diff --git a/open-irc-links/manifest.json b/open-irc-links/manifest.json
new file mode 100755
index 00000000..99842971
--- /dev/null
+++ b/open-irc-links/manifest.json
@@ -0,0 +1,16 @@
+{
+  "manifest_version": 2,
+  "name": "IRC Protocol Handler",
+  "description": "Demos the usage of protocol_handlers",
+  "version": "1.0.0",
+  "icons": {
+    "64": "icons/icon.png"
+  },
+  "protocol_handlers": [
+    {
+      "protocol": "irc",
+      "name": "IRC Mibbit Extension",
+      "uriTemplate": "https://mibbit.com/?url=%s"
+    }
+  ]
+}