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 Step 2
  19 ======
  20
  21 Next, edit xrd/index.php and enter a secret in this line:
  22
  23 $s = "";
  24
  25 This can be anything you like...
  26
  27 $s = "johnny5";
  28
  29 or
  30
  31 $s = "12345";
  32
  33 It really doesn't matter too much.
  34
  35
  36 Step 3
  37 ======
  38
  39 Edit the .well-known/host-meta file and replace all occurrences of
  40 "example.com" with your domain name.
  41
  42 Step 4
  43 ======
  44
  45 For each user on your site, and this might only be you...
  46
  47 In the xrd directory, make a copy of the example@example.com.xml file
  48 so that it's called...
  49
  50      yoursecretusername@domain.com.xml
  51
  52 So, if your secret from step 2 is 'johnny5' and your name is 'ben' and
  53 your domain is 'titanictoycorp.biz', your file should be called
  54 johnny5ben@titanictoycorp.biz.xml
  55
  56 Then edit the file, replacing "social.example.com" with your GNU
  57 social instance's base path, and change the user ID number (and
  58 nickname for the FOAF link) to that of your account on your social
  59 site. If you don't know your user ID number, you can see this on your
  60 GNU social profile page by looking at the destination URLs in the
  61 Feeds links.
  62
  63 Finally
  64 =======
  65
  66 Using this method, though fiddly, you can now be @user@domain without
  67 the need for any prefixes for subdomains, etc.