summaryrefslogtreecommitdiff
path: root/views/docs.php
diff options
context:
space:
mode:
authorAaron Parecki <aaron@parecki.com>2014-07-06 18:28:18 -0700
committerAaron Parecki <aaron@parecki.com>2014-07-06 18:28:18 -0700
commit592eac5d8dc4c704bfb34915c0703fc2aecc6d46 (patch)
treea9875ed88b33674da0571c0ad8007c01eda07f23 /views/docs.php
parentb2337158a38b7dfda6d5c4e3c5f0dd4ae9f4845d (diff)
Adds support for querying your micropub endpoint to check for syndication targets.
This changes the value of "in-reply-to" to use hyphens instead of underscore separators!! Also shows you the full request made to your micropub endpoint.
Diffstat (limited to 'views/docs.php')
-rw-r--r--views/docs.php33
1 files changed, 31 insertions, 2 deletions
diff --git a/views/docs.php b/views/docs.php
index 48fd0d8..94856a1 100644
--- a/views/docs.php
+++ b/views/docs.php
@@ -1,7 +1,7 @@
<div class="narrow">
<?= partial('partials/header') ?>
- <h2>Introduction</h2>
+ <h2 id="introduction">Introduction</h2>
<div class="col-xs-6 col-md-4" style="float: right;">
<span class="thumbnail"><img src="/images/quill-ui.png"></span>
@@ -15,7 +15,9 @@
<p>Once you've signed in, you'll see an interface like the one shown which you can use to
write a post. Clicking "post" will make a Micropub request to your endpoint.<p>
- <h2>Configuring Endpoints</h2>
+
+
+ <h2 id="endpoints">Configuring Endpoints</h2>
<h3>Authorization Endpoint</h3>
<?= partial('partials/auth-endpoint-help') ?>
@@ -28,4 +30,31 @@
<p>The <a href="/creating-a-micropub-endpoint">Creating a Micropub Endpoint</a> tutorial will walk you through how to handle incoming POST requests from apps like this.</p>
+
+
+ <h2 id="syndication">Syndication Targets</h2>
+
+ <p>You can provide a list of supported syndication targets that will appear as checkboxes when you are creating a new post.</p>
+
+ <p>To do this, your Micropub endpoint will need to respond to a GET request containing a query string of <code>q=syndicate-to</code>. This request will be made with the access token that was generated for this app, so you can choose which syndication targets you want to allow this app to use.</p>
+
+ <p>Below is the request and expected response that Quill looks for.</p>
+
+ <pre><code>GET /micropub?q=syndicate-to HTTP/1.1
+Authorization: Bearer xxxxxxxxxx
+
+HTTP/1.1 200 OK
+Content-type: application/x-www-form-urlencoded
+
+syndicate-to=syndicate-to=twitter.com%2Faaronpk%2Cfacebook.com%2Faaronpk
+</code></pre>
+
+ <p>The response should be a form-encoded reply with a single field, <code>syndicate-to</code>. The value is a comma-separated list of syndication targets. The actual values are up to your Micropub endpoint, but a good convention is to use the domain name of the service (e.g. twitter.com), or domain name and username (e.g. twitter.com/aaronpk).</p>
+
+ <p>If you do include the domain name, Quill will be able to show icons for recognized services next to the checkboxes.</p>
+
+ <p>Quill will check for your supported syndication targets when you sign in, but there is also a link on the new post screen to manually re-check if you'd like.</p>
+
+
+
</div> \ No newline at end of file