socialfy-your-domain/README.txt

   1 Initial simple way to Webfinger enable your domain -- needs PHP.
   2 ================================================================
   3
   4 Step 1
   5 ======
   6
   7 First, put the folders 'xrd' and 'dot-well-known' on your website, so
   8 they load at:
   9
  10      http://yourname.com/xrd/
  11
  12      and
  13
  14      http://yourname.com/.well-known/
  15
  16      (Remember the . at the beginning of this one)
  17
  18 NOTE: If you're using https, make sure each instance of http:// for
  19       your own domain ("example.com") is replaced with https://
  20
  21 Step 2
  22 ======
  23
  24 Next, edit xrd/index.php and enter a secret in this line:
  25
  26 $s = "";
  27
  28 This can be anything you like...
  29
  30 $s = "johnny5";
  31
  32 or
  33
  34 $s = "12345";
  35
  36 It really doesn't matter too much.
  37
  38
  39 Step 3
  40 ======
  41
  42 Edit the .well-known/host-meta file and replace all occurrences of
  43 "example.com" with your domain name.
  44
  45 Step 4
  46 ======
  47
  48 For each user on your site, and this might only be you...
  49
  50 In the xrd directory, make a copy of the example@example.com.xml file
  51 so that it's called...
  52
  53      yoursecretusername@domain.com.xml
  54
  55 So, if your secret from step 2 is 'johnny5' and your name is 'ben' and
  56 your domain is 'titanictoycorp.biz', your file should be called
  57 johnny5ben@titanictoycorp.biz.xml
  58
  59 Then edit the file, replacing "social.example.com" with your GNU
  60 social instance's base path, and change the user ID number (and
  61 nickname for the FOAF link) to that of your account on your social
  62 site. If you don't know your user ID number, you can see this on your
  63 GNU social profile page by looking at the destination URLs in the
  64 Feeds links.
  65
  66 Finally
  67 =======
  68
  69 Using this method, though fiddly, you can now be @user@domain without
  70 the need for any prefixes for subdomains, etc.