=== /.well-known/ ===
Contributors: pfefferle
Donate link: https://notiz.blog/donate/
Tags: well-known, discovery
Requires at least: 3.5.1
Tested up to: 3.8
Stable tag: 1.0.1

"Well-Known URIs" for WordPress!

== Description ==

This plugin enables "Well-Known URIs" support for WordPress (RFC 5785: http://tools.ietf.org/html/rfc5785).

From the RFC:

> It is increasingly common for Web-based protocols to require the
> discovery of policy or other information about a host ("site-wide
> metadata") before making a request.  For example, the Robots
> Exclusion Protocol <http://www.robotstxt.org/> specifies a way for
> automated processes to obtain permission to access resources;
> likewise, the Platform for Privacy Preferences
> tells user-agents how to discover privacy policy beforehand.

> While there are several ways to access per-resource metadata (e.g.,
> HTTP headers, WebDAV's PROPFIND [RFC4918]), the perceived overhead
> (either in terms of client-perceived latency and/or deployment
> difficulties) associated with them often precludes their use in these
> scenarios.

> When this happens, it is common to designate a "well-known location"
> for such data, so that it can be easily located.  However, this
> approach has the drawback of risking collisions, both with other such
> designated "well-known locations" and with pre-existing resources.

> To address this, this memo defines a path prefix in HTTP(S) URIs for
> these "well-known locations", "/.well-known/".  Future specifications
> that need to define a resource for such site-wide metadata can
> register their use to avoid collisions and minimise impingement upon
> sites' URI space.

== Changelog ==

= 0.6.2 =

* bug fix

= 0.6.0 =

* refactored the code

= 0.5.1 =

* fixed some php-warnings

= 0.5 =

* better action/filter

= 0.4 =

* some improvements for host-meta (jrd)

= 0.3 =

* adding well-known uris a bit more wordpress-like

= 0.2.1.1 =

* Ooops, copy&paste bug

= 0.2.1 =

* Forgot to flush the rewrite rules

= 0.2 =

* Better doku

= 0.1 =

* Initial release

== Installation ==

1. Upload the `well-known`-folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the *Plugins* menu in WordPress
3. ...and that's it :)

== Frequently Asked Questions ==

= How can I define a well-known uri? =


Set a callback for an URI (/.well-known/robots.txt). The action is a combination of `well_known_` and the file-name, in this case the hook must look like

`add_action('well_known_robots.txt', 'robots_txt');`


Print robots.txt:


`function robots_txt($query) {
  header('Content-Type: text/plain; charset=' . get_option('blog_charset'), true);
  echo "User-agent: *";
  echo "Allow: /";

  exit;
}`

= Is there an implementation where I can write off? =

Yes, you can find an example plugin, which defines a well-known-uri,
here: http://wordpress.org/extend/plugins/host-meta/