joomla-projects/joomla-browser

joomla-browser Codeception Module

Tuesday, July 24, 2018
by yvesh
Repository
13 Watchers
13 Stars
140,051 Installations

PHP
3 Dependents
0 Suggesters
31 Forks
13 Open issues
46 Versions
6 % Grown

The README.md

Joomla Browser (Codeception Module)

, _(*1)

The JoomlaBrowser
Using the JoomlaBrowser to test Joomla Sites
- Download
- Loading the Module in Codeception

The Joomla Browser

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., _(*2)

In between the available functions you can find:, _(*3)

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, _(*4)

Joomla Browser in action

If you want to see a working example of JoomlaBrowser check weblinks tests: https://github.com/joomla-extensions/weblinks#tests, _(*5)

Using Instructions

Update Composer.json file in your project, and download, _(*6)

Download

composer require joomla-projects/joomla-browser:dev-develop

Loading the Module in Codeception

Finally make the following changes in Acceptance.suite.yml to add JoomlaBrowser as a Module., _(*7)

Your original acceptance.suite.ymlprobably looks like:, _(*8)

modules:
    enabled:
        - WebDriver
        - AcceptanceHelper
    config:
        WebDriver:
            url: 'http://localhost/joomla-cms3/'     # the url that points to the joomla cms
            browser: 'firefox'
            window_size: 1024x768
            capabilities:
              unexpectedAlertBehaviour: 'accept'
        AcceptanceHelper:
            ...

You should remove the WebDriver module and replace it with the JoomlaBrowser module:, _(*9)

    config:
        JoomlaBrowser:
            url: 'http://localhost/joomla-cms/'     # the url that points to the joomla installation at /tests/system/joomla-cms
            browser: 'firefox'
            window_size: 1024x768
            capabilities:
              unexpectedAlertBehaviour: 'accept'
            username: 'admin'
            password: 'admin'
            database host: 'localhost'             # place where the Application is Hosted #server Address
            database user: 'root'                  # MySQL Server user ID, usually root
            database password: '1234'                  # MySQL Server password, usually empty or root
            database name: 'dbname'            # DB Name, at the Server
            database type: 'mysqli'                # type in lowercase one of the options: MySQL\MySQLi\PDO
            database prefix: 'jos_'                # DB Prefix for tables
            install sample data: 'Yes'              # Do you want to Download the Sample Data Along with Joomla Installation, then keep it Yes
            sample data: 'Default English (GB) Sample Data'    # Default Sample Data
            admin email: 'admin@mydomain.com'      # email Id of the Admin
            language: 'English (United Kingdom)'   # Language in which you want the Application to be Installed
            joomla folder: '/home/.../path to Joomla Folder' # Path to Joomla installation where we execute the tests
        AcceptanceHelper:
            ...

Code Style Checker

To check automatically the code style execute the following commands in your Terminal window at the root of the repository:, _(*10)

$ composer install
$ vendor/bin/phpcs --extensions=php -p --standard=vendor/joomla/coding-standards/Joomla src

The Versions

24/07 2018

dev-session-test

dev-session-test https://docs.joomla.org/Testing_Joomla_Extensions_with_Codeception

joomla-browser Codeception Module

library joomla-browser