phpstorm-jenkins.markdown

@@ -4,4 +4,19 @@
 
 # PhpStorm/Jenkins Integration
 
-Install the **Jenkins Control Plugin** - _[How to install PhpStorm Plugins](phpstorm-install-plugin)_
+#### Integration requires the **Jenkins Control Plugin** - _[How to install PhpStorm Plugins](phpstorm-install-plugin)_
\ No newline at end of file
+
+## Configure a PhpStorm project with Jenkins
+
+ 1. Access PhpStorm settings (Linux, Windows: **File** > **Settings**, Mac: **PhpStorm** > **Preferences**)
+ 2. Choose **Jenkins Plugin** from the **Project Settings** section of the list on the left-hand side
+ 3. **Server Address**: `http://ci.digitec.local/`
+ 4. **Job Refresh Period**: `1`
+ 5. Click **OK** button
+
+## Using Jenkins in a (configured) PhpStorm project
+
+ * There is a **Jenkins** tool button that can be clicked to toggle open the Jenkins panel
+    * The default location for the tool button is the right-hand side of the PhpStorm windown near the **Database** tool button
+ * Although the Jenkins projects statuses will be updated automatically, there is a little lag.  Click the **refresh** icon (the 2 blue circular arrows) for current statuses.
+ * The **sort by build status** icon can be clicked to sort by build status, placing projects with errors at the top of the list.
\ No newline at end of file