eko/certificationy

A library to create certification system

v2.0.1 2017-07-31 20:17 UTC

README

8029934?v=3&s=200

Certificationy

This is provides a complete system to build multiple choice question system. This is useful for any company that need to test an applicant, or to make a certification website/training tool.

Join the chat at https://gitter.im/certificationy/certificationy Build Status SensioLabsInsight

How to use it?

Inside any PHP application

As usual, use composer to install the library:

composer require "certificationy/certificationy"

Then, you need to load questions using a loader: for now only PhpArray and Yaml loaders are provided, but thanks to the Loader interface you can create your owns.

For instance, let's say you have created a Yaml file with some few questions:

# question.yaml
category: basics
questions:
    -
        question: '2 + 2 = ?'
        answers:
            - {value: 4,           correct: true}
            - {value: 3,           correct: false}
            - {value: 2,           correct: false}

Then you can do:

<?php
use Certificationy\Loaders\YamlLoader;

$loader = new YamlLoader(['path/to/question.yaml']);
$questions = $loader->load(1, []); // (nbQuestions, fromCategories)
$loader->categories(); // ['basics']

$set = Set::create($questions);

Then, for each question you can set user answers (as answers can be multiple):

<?php
 $set->setUserAnswers(0, [4]); // (questionIndex, [values])

At every moment, you can get the correct and wrong answers (non answered questions are wrong).

$set->getCorrectAnswers();
$set->getWrongAnswers();

CLI tool

A CLI tool is available under the following repository: http://www.github.com/certificationy/certificationy-cli.

Please, help us complete our official packs of questions!

You can submit PR with your own questions into the packs located under the Certificationy organization.

We provide packs for both PHP5 and Symfony certifications.

More we will have questions, the more powerful will be this tool!