Merge branch 'release/v3.4.8.0'

Author: javigomez

.gitignore

@@ -25,6 +25,7 @@ Desktop.ini
 *.swp
 *~.nib
 *~
+*.travis/*
 
 # Ignore mergetool files
 *.orig
@@ -34,7 +35,6 @@ build.properties
 phing-latest.phar
 
 # Composer
-composer.lock
 composer.phar
 vendor/*
 tests/vendor/*

.travis.yml

@@ -0,0 +1,8 @@
+language: php
+php:
+- 5.4
+before_script:
+- composer install
+
+script:
+- vendor/bin/robo check:codestyle

README.md

@@ -9,24 +9,57 @@
   * [Loading the Module in Codeception](loading-the-module-in-codeception)
 
 ## The Joomla Browser
-Joomla Browser with Codeception Module Functionality
+Joomla Browser is a Codeception.com Module. It allows to build `system tests` for a Joomla site much faster providing a set of predefined tasks. 
+
+In between the available functions you can find:
+
+* INSTALLATION:
+  * install joomla
+  * install Joomla removing Installation Folder
+  * install Joomla Multilingual Site
+* ADMINISTRATOR:
+  * do administrator login
+  * do administrator logout
+  * set error reporting to development
+  * search for item
+  * check for item existence
+  * publish a module
+  * setting a module position and publishing it
+  * EXTENSION MANAGER
+    * install extension from Folder
+    * install extension from url
+    * enable plugin
+    * uninstall extension
+    * search result plugin name
+* FRONTEND:
+  * do frontend login
+* ADMINISTRATOR USER INTERFACE:
+  * select option in chosen
+  * select Option In Radio Field
+  * select Multiple Options In Chosen
+* OTHERS:
+  * check for php notices or warnings
+
+
+The Joomla Browser is constantly evolving and more methods are being added every month. 
+To find a full list of them check the public methods at: https://github.com/joomla-projects/joomla-browser/blob/develop/src/JoomlaBrowser.php
+
+
+## Joomla Browser in action
+If you want to see a working example of JoomlaBrowser check weblinks tests: https://github.com/joomla-extensions/weblinks#tests
 
 ## Using Instructions
-Update Composer.json file in your project, adding 
+Update Composer.json file in your project, and download
 
 ### Download
 
 ```
-"require" :  "joomla-projects/joomla-browser": "dev-develop"
-```
-then do a
-```
-composer update 
+composer require joomla-projects/joomla-browser:dev-develop
 ```
 
 ### Loading the Module in Codeception
 
-Finally Make changes in Acceptance.suite.yml add JoomlaBrowser as a Module 
+Finally make the following changes in Acceptance.suite.yml to add JoomlaBrowser as a Module. 
 
 Your original `acceptance.suite.yml`probably looks like:
 
@@ -46,7 +79,7 @@ modules:
             ...
 ```
 
-You are asked to remove WebDriver module and change it by the JoomlaBrowser module:
+You should remove the WebDriver module and replace it with the JoomlaBrowser module:
 
 ```yaml
     config:
@@ -72,3 +105,13 @@ You are asked to remove WebDriver module and change it by the JoomlaBrowser modu
         AcceptanceHelper:
             ...
 ```
+
+## Tools
+Joomla Browser comes with a set of tools added via robo.li
+
+### Code Style Checker
+To check automatically the code style execute the following commands in your Terminal window at the root of the repository:
+
+- `$ composer install`
+- `$ vendor/bin/robo`
+- `$ vendor/bin/robo check:codestyle`

RoboFile.php

@@ -0,0 +1,48 @@
+<?php
+
+/**
+ * This is project's console commands configuration for Robo task runner.
+ *
+ * @see http://robo.li/
+ */
+class RoboFile extends \Robo\Tasks
+{
+	// Load tasks from composer, see composer.json
+	use \joomla_projects\robo\loadTasks;
+
+	private $extension = '';
+
+	/**
+	 * Set the Execute extension for Windows Operating System
+	 *
+	 * @return void
+	 */
+	private function setExecExtension()
+	{
+		if (strtoupper(substr(PHP_OS, 0, 3)) === 'WIN')
+		{
+			$this->extension = '.exe';
+		}
+	}
+
+	/**
+	 * Check the code style of the project against a passed sniffers using PHP_CodeSniffer_CLI
+	 *
+	 * @param   string $sniffersPath Path to the sniffers. If not provided Joomla Coding Standards will be used.
+	 */
+	public function checkCodestyle($sniffersPath = null)
+	{
+		if (is_null($sniffersPath))
+		{
+			$this->say('Downloading Joomla Coding Standards Sniffers');
+			$this->_exec("git $this->extension clone -b master --single-branch --depth 1 https://github.com/joomla/coding-standards.git .travis/phpcs/Joomla");
+			$sniffersPath = __DIR__ . '/.travis/phpcs/Joomla';
+		}
+
+		$this->taskCheckCodeStyle()
+			->inspect(__DIR__ . '/src')
+			->dontStopOnFail(true)
+			->standard($sniffersPath)
+			->run();
+	}
+}

composer.json

@@ -15,8 +15,11 @@
         }
     ],
     "require": {
-        "php": ">=5.3.0",
-        "codeception/codeception": "2.*"
+        "php": ">=5.3.0"
+    },
+    "require-dev": {
+        "codegyre/robo": "^0.5.3",
+        "joomla-projects/robo": "dev-master"
     },
     "autoload": {
         "psr-4": {