Merge branch 'master' of https://github.com/usefathom/wordpress-plugin

Author: JackEllis

.DS_Store

@@ -1,10 +1,51 @@
-# Fathom WordPress Plugin
+# Fathom Analytics for WordPress
 
-A simple plugin to add the [Fathom Analytics](https://usefathom.com/) tracking snippet to your WordPress site.
+Fathom Analytics for WordPress is a simple way to view your dashboard inside WordPress, and add your Fathom Analytics tracking code to your WordPress site without editing any code. This plugin is for paying customers of Fathom Analytics.
+
+### What is Fathom Analytics?
+[Fathom Analytics](https://usefathom.com) is a simple, privacy-focused website analytics tool for bloggers and businesses.
+
+Stop scrolling through pages of reports and collecting gobs of personal data about your visitors, both of which you probably don’t need. Fathom is a simple and private website analytics platform that lets you focus on what's important: your business.
+
+Major features of Fathom Analytics include:
+
+* One screen, all the real-time data you need
+* Cookie notices not required (we don’t use cookies or collect personal data)
+* Displays: top content, top referrers, top goals and more
+
+To use use this plugin, you need have a paid Fathom Analytics account and your dashboard sharing set to [public or private with password](https://usefathom.com/support/sharing).
+
+### FAQ
+
+**Where can I find the plugin settings?**
+This plugin has just a single settings field, which can be found by going to WP Admin > Settings > Fathom Analytics.
+
+**Where do I find my SiteID?**
+Your SiteID is the unique code in your tracking snippet. Go to your Dashboard, click Settings, then Sites. The SiteID is the second column, copy and paste it from there into the field on the settings page in WordPress.
+
+**What’s the Fathom share password?**
+In order to use Fathom Analytics for WordPress your dashboard must be set to “Public” or “Viewable to anyone with the share password”. If your dashboard is public, skip the Fathom Share Password field. If your dashboard is set to have a share password, enter that password in this field.
+
+**What’s the Fathom Fathom URL?**
+Leave this set to “cdn.usefathom.com” unless you are using Fathom Lite (the OS version), and in that case, enter the tracker URL you are using.
 
 ### Usage
 
-After installing and activating this plugin, go to **Settings > General** and enter the URL to your Fathom instance in the text field near the bottom.
+Log into Wordpress
+
+1. Go to `Plugins`, `Add New`
+1. Upload this plugin, `fa4wp.zip`
+1. Click `Install Now`, then `Activate`
+1. Go to `Settings`, then `Fathom Analytics`
+1. Type in your `SiteID`. If you don’t know your `SiteId`, log into [Fathom Analytics](https://app.usefathom.com), go to `Settings`, `Sites`, then your `SiteID` will be beside the name of your site
+1. If your dashboard is public, leave `Fathom share password` blank. If your dashboard is privately shared, then type in the share password
+1. Leave `Fathom URL` set to cdn.usefathom.com
+
+Taking the above steps automatically places the Fathom tracking code into the footer of every page of your WordPress site.
+
+If you now want to see your Fathom dashboard from within Wordpress, make sure “Display Analytics Menu Item” is checked off. Hit Save Changes, and you’ll see Fathom on the menu in WordPress on the lefthand side.
+
+Enjoy Fathom Analytics for WordPress!
 
 ### License