Index by title

JQuakrs version 0.2.3

What do I need to get JQuarks work properly ?

JQuarks uses for it's question creation the TinyMCE editor, minimum version required is v3.2.4.1 which is available out of the box on Joomla's version 1.5.12 and above.

We recommend using at least Joomla v1.5.12 if you have an older version you can find instruction on upgrading here

Why 0.2.3 ?

Many users have experienced bug #16 which prevents administrator from assigning sets of questions to quizzes.

JQuarks do not permit empty sets to be assigned to quizzes, this bug has for effect to block the assignation of a set of question even if it does contain questions.

This release is meant to fix this issue.

Shall I upgrade to it ?

Some versions of mysql seem to overlook the problem, so if you do not have this issue you can stick with 0.2.2
Obviously if you are trying JQuarks for the first time it's better to use 0.2.3

I wish to upgrade to 0.2.3 and want to keep my data from 0.2.2 How can I do it ?

That's easy, just follow this step-by-step guide:

NB. Although this procedure should be safe, we strongly recommend backing up your database before proceeding

  1. Before uninstalling JQuarks's 0.2.2 component, locate the file uninstall.sql under {SITE_ROOT}/administrator/components/com_jquarks/uninstall.sql
  2. Open it, discard its content and save the changes
  3. Uninstall JQuarks's 0.2.2 component
  4. Install JQuarks's 0.2.3 component

I upgraded JQuarks's component, do i need to upgrade it's plugins and module too ?

On this version only JQuark's component has been modified, so you do not need to install JQuarks's modules and plugin if you already have them


What do I need to get JQuarks to work properly ?

JQuarks uses for it's question creation the TinyMCE editor, minimum version required is v3.2.4.1 which is available out of the box on Joomla's version 1.5.12 and above.

We recommend using at least Joomla v1.5.12 if you have an older version you can find instruction on upgrading here

What's new in 0.2.4 ?

Starting this version JQuarks also speak German and Norwegian !

We would like to thank Michael Heßburg for german version and Børge Iversen for Norwegian version.
Thanks also to nerovik who reviewed french version.

Some bugs and vulnerability have also been fixed.

I wish to upgrade to 0.2.4 and want to keep my data from 0.2.2/0.2.3 How can I do it ?

That's easy, just follow this step-by-step guide:

NB. Although this procedure should be safe, we strongly recommend backing up your database before proceeding

  1. Before uninstalling JQuarks's 0.2.2/0.2.3 component, locate the file uninstall.sql under {SITE_ROOT}/administrator/components/com_jquarks/uninstall.sql
  2. Open it, discard its content and save the changes
  3. Uninstall old version of JQuarks' component
  4. Install JQuarks' 0.2.4 component

I upgraded JQuarks' component, do I need to upgrade it's plugins and module too ?

Yes you need to install JQuarks' module 0.2.4, you can though keep you current version of the plug-ins


What do I need to get JQuarks to work properly ?

JQuarks uses for it's question creation the TinyMCE editor, minimum version required is v3.2.4.1 which is available out of the box on Joomla's version 1.5.12 and above.

We recommend using at least Joomla v1.5.12 if you have an older version you can find instruction on upgrading here

What's new in 0.3.0 ?

We would like to thank carlos lopez for Spanish and Galician version and Giovanni Maggini for Italian version.
Thanks also to all JQuarks' Translators !

I wish to upgrade to 0.3.0 and want to keep my data from 0.2.x How can I do it ?

That's easy, just follow this step-by-step guide:

NB. Although this procedure should be safe, we STRONGLY recommend backing up your database before proceeding

  1. Before uninstalling JQuarks's 0.2.x component, locate the file uninstall.sql under {SITE_ROOT}/administrator/components/com_jquarks/uninstall.sql
  2. Open it, discard its content and save the changes
  3. Uninstall old version of JQuarks' component
  4. Install JQuarks' 0.3.0 component
  5. Enjoy our new feature and give us feedback to improve JQuarks ;) !

I upgraded JQuarks' component, do I need to upgrade it's plugins and module too ?

Yes you need to install JQuarks' 0.3.0 plugin and module, just remove the old plugin and module, and install 0.3.0's


Ensembles de questions

Maintenant que nous disposons de questions thématiques il serait intéressant de commencer à les affecter à nos quizzes, mais plutôt que d’affecter directement les questions nous allons les regrouper en ensembles qui seront par la suite affectés aux quizzes.

Les ensembles de questions offrent de nombreux avantages :

Créer un ensemble de question est simple il nous suffit de saisir le titre du set et de définir son type.

Deux types d'ensemble sont disponibles :

Ensembles personnalisés

Commençons par créer un ensembles personnalisé :

Il nous suffit de cliquer sur le bouton d'assignation d'une question pour l'affecter à notre ensemble.
Il est possible de choisir d'affecter des questions de catégories différentes à un même ensemble même si pour des raison d'organisation il est plus logique d'avoir des ensembles de questions homogènes.

Pour finir sauvegardons notre ensemble.

Ensembles aléatoires

Les ensembles aléatoires sont des ensembles appartenant à une seule et unique catégorie.
Une fois que nous avons choisi la catégorie désirée nous allons définir, dans la limite des question disponibles, combien de questions nous voulons extraire de cette catégorie.

Créons maintenant un ensembles aléatoires :

Remarque : Ce type d'ensemble une fois affecter à un quiz ira extraire à chaque fois qu'un utilisateur le passera autant de questions différentes que nous en avons déterminer.

Maintenant que nous disposons d'ensembles il ne nous reste plus qu'à crée notre premier Quiz


Features

JQuarks offers many features among which are:


Fonctionnalités

JQuarks propose de nombreuses fonctionnalités parmi lesquelles on peut citer :


Frequently Asked Questions

1. I can't save questions "save", "apply" and "save & continue" buttons do not work.

At the moment only Quizzes default layout is available, support for other menu item will be added in future version

4. How does the score system work?


Guide d'installation

Prérequis d'installtion

JQuarks est un composant optimisé pour fonctionner avec l'éditeur TinyMCE, le support pour d'autres éditeurs (JCE, etc..) sera toutefois ajouté prochainement. Pour que JQuarks fonctionne correctement il est nécessaire de disposer de

Installtion

Installer JQuarks se fait de la même manière que n’importe quelle installation d'extension sous Joomla.

Tout d'abord commençons par télécharger la dernière version de JQuarks et décompressons le.
Pour la version 0.2.3 par exemple le package contient les fichiers suivants :

Fichier Type Description
com_jquarks_v0.2.3.zip Composant Il s'agit du composant JQuarks qui va ajouter la fonctionnalité de gestion des quizzes a notre site
mod_jquarks_v0.2.2.zip Module Ce module nous permettra d'avoir un visuel côté site des différents quizzes disponibles
plg_user_jquarks_v0.2.2.zip Plugin Ce plugin est chargé de maintenir la cohérence entre JQuarks et le composant de gestion des utilisateurs de Joomla
plg_editor_syntaxhighlight_jquarks_v0.2.2.zip plugin Ce module vous permettra d'ajouter à JQuarks un bouton au niveau de l'éditeur TinyMCE pour la création de questions. Ce bouton vous permettra si votre question comporte du code-source d'appliquer une coloration syntaxique correspondante au langage utilisé

n.b. JQuarks utilise SyntaxHighlighter pour la coloration syntaxique

Maintenant accédons à la partie administration de notre site et rendons nous sous Extension -> Installer/Désinstaller

Nous allons installé JQuarks en utilisant la méthode de transfert d'archive. Via le bouton Parcourir nous allons nous déplacer au niveau de notre hiérarchie jusqu'à atteindre le répertoire où nous avons décompressé JQuarks. Commençons par com_jquarks_v0.2.3.zip, lançons l'installation en validant avec le bouton "Transfert de fichier & installation"

La confirmation de l'installation nous est apporté par l'écran suivant :

Installons maintenant le reste des modules/plugins en suivant la même procédure.

JQuarks est maintenant installé. Il nous reste à activer les plugins et à activer/configurer le module

Pour ce faire rendons nous sous Extension -> Gestion des plugins

Astuce : Effectuer une recherche avec le mot clé JQuarks nous permet d'afficher seulement les plugins qui nous intéressent.

Il s'agit maintenant d'activer nos plugins en cliquant sur le bouton activé correspondant à chacun.

Passons maintenant au module, dans Extension -> Gestion des modules

Éditons notre module. (sois en cliquant sur son nom ou en cochant la case correspondante au module et en utilisant le bouton Éditer)

Au niveau de l'écran d'édition nous pouvons modifier le titre de notre module (JQuarks par défaut), définir sa position au niveau du site, l'activé, et toute autre action propre aux modules au niveau de Joomla.
A droite la partie paramètres va nous permettre de modifier le nombre de quizzes à afficher pour les quizzes de type privés et publiques (par défaut 2), ainsi que de modifier leur ordre d'affichage

Une fois que nous avons terminé de configurer le module il nous suffit de sauvegarder.

Maintenant JQuarks est installé, nous pouvons commencer à crée nos quizzes. Guide d'utilisation


Guide d'utilisation

A la base de tout quiz se trouvent un ensemble de questions, JQuarks axe ses fonctionnalités sur les questions et la façon de les catégoriser, de les regrouper. Tout est penser afin de nous permettre de mettre à profit les questions que nous créons et de nous donner la possibilité de les réutilise facilement dans divers quizzes.

Nous pouvez accéder à JQuarks depuis Composants -> JQuarks

Une fois sur l'interface de JQuarks un sous-menu apparait et nous permet d'accéder plus rapidement au différents éléments

Dans ce guide nous allons nous intéresser à l'étude des briques principales de JQuarks à savoir les :


Installation Guide

Prerequisites for installation

JQuarks component is optimized to work with the TinyMCE editor, support for other editors (JCE, etc. ..) will be added soon. In order for JQuarks to work properly it is necessary to have

Installation

Installing JQuarks is the same as for any other extension installation under Joomla.

First we start by downloading the latest version of JQuarks and unzip it.
For version 0.2.3, for example the package contains the following files:

File Type Description
com_jquarks_v0.2.3.zip Component This is the JQuarks component that will add quiz management functionality to our site
mod_jquarks_v0.2.2.zip Module This module will allow us to have a view of the available quizzes
plg_user_jquarks_v0.2.2.zip Plugin This plugin allow maintaining consistency between the JQuarks and Joomla's User Management component
plg_editor_syntaxhighlight_jquarks_v0.2.2.zip plugin This module allows you to add a button to the TinyMCE editor. This button will allow us to apply syntax highlighting if our questions involves source code

Now let's login the back-office of our website. And head to Extension -> Install / Uninstall

We will install JQuarks using the archive transfer method. Let's start by com_jquarks_v0.2.3.zip, we run the installation by validating with the button "Upload File & Install"

The following message shall be displayed :

Now we install the remaining modules / plugins following the same procedure.

JQuarks is now installed. All that remains to do is to activate the plugins and enable / configure the module

In order to do this we head to Extension -> Management plugins

Tip: Making a search with the keyword JQuarks will only display the two plugin that interest us.

We just now activate our plugins by clicking on the corresponding button of each one.

Next is the module. Under Extension -> Management modules

We need to publish our module to do that we start editing it.

At the editing screen we can change the title of our module (Default is JQuarks), we attribute it a position, and publish it
Under settings we will be able to change the number of quizzes to show, for both private and public quizzes (default is 2 quizzes each), and change their display order

Once we have finished configuring the module we just save the modification.

Now that JQuarks is installed, we can begin creating our quizzes !

Let's see how in our User Guide


INSTALL GUIDE


JQuarks

What people say about JQuarks

Michael Heßburg
I like your Quiz-Component very much. You bring it
to the point: it's as many complex as needed without
too many features. It could be a Program provided
for a Mac: clear design and easy to use.
SmartTactics
Good work with JQuarks. It might finally be time
to ditch my Survey Monkey account and go native
on our Joomla sites.
VistaMedia
Une interface et un code soignés, une architecture
MVC, ce produit est de loin le meilleur que j'ai eu
l'occasion de tester dans le domaine.
Kathi V
Good effort and work done!!!! Hats off to team....Let me know the Next version release month.

JQuarks friends

We are using JQuarks (Showcase your JQuarks quizzes!)

Frequently Asked Questions

English

Français


JQuarks friends

You were A lot of you have visited Jquarks.org, downloaded the extension, twitted about it or helped spreading it in the world. So thank you so much dear friends. Our goal is to make of JQuarks the Quiz & Surveys state of the art Joomla! component.

Here a non-exhaustive list of JQuarks friends, and if you want to join them, you have just to DM us @iptech or by sending an email to .

Weeby
@vistamedia http://www.flexicontent.org/
@SmartTactics http://www.thepowerofinsight.net/
@RePao
@PeteCoutts http://www.joomla.ch
@KhaledEss http://thepurplecows.blogspot.com/
Khawaib Ahmed http://www.paradex.co.uk/
Maryse TREF http://www.agence-web-developpement.com/
@Proxium
Thierry JIRKOVSKY http://www.W5D.net
Frédéric Pangaud http://www.pangoo.fr
@Joomla_template http://joomportal.com/
@TACS_NPower
Steven Hellemans http://www.elma.be/
Bogdan Dimirov http://www.joomla-bg.com/ipotpal/
Michel Jardi http://www.jardi22.fr/
@AP Clarke http://www.webmentor.ie/
Miecaze http://www.cantal-internet-creation.fr/
Michael Heßburg http://www.hessburg.com/
Richydom
Freebies http://www.dzine.com.br
Kunule Imbayi
Diogo Magalhães http://www.dzine.com.br
Fadi Nimer http://www.extensya.com/
VBCH http://www.lehaillan-volley.fr/
@joomlaextension
@wdtech
@Joomla_template
@smart_joomla
@suportejoomlabr http://www.suportejoomla.net.br/
@KarenKinnaman http://atrueprofit.com/
@joomla_ext http://www.joomla-extensions.ru/
@open4gjoomla http://www.open4g.com/
Valentina Kingsolver http://languageavenue.com/
Dave Alder http://www.elite-eagles.co.uk/
Børge Iversen http://www.nbf-nesna.no/
Jeff Channell http://jeffchannell.com/
@lafrance http://joomlacoders.ca/
Giovanni Maggini http://www.sonicitalia.net/
Bruno Flaven

If you like to update or remove your entry, feel free
to send your request through a Twitter DM or to


JQuarks versions


Présentation

JQuarks est un composant de gestion des quizzes pour le Content Management System (CMS) Joomla!
Il s'agit d'un composant natif pour la version 1.5.x, qui vous permettra de créer vos propres quizzes et de les proposer aux visiteurs de votre site.

Simple d'accès et d'utilisation, la création de quizzes se fera côté administration et vous permettra entre autre de crée vos propres questions, gérer l'affectation des utilisateurs aux quizzes, consulter les réponses etc... questions.

JQuarks dispose également d’un module paramétrable vous permettant de lister les quizzes disponibles, offrant ainsi à vos visiteur un visuel constant sur ce que propose votre site.


Presentation

JQuarks is a quiz management component for the Content Management System (CMS) Joomla!
It's a native component for Joomla's version 1.5.12 and above, it will allow you to create your own quizzes and to propose them to your visitors.

Easy of access and use, It will allow you to create your own quizzes, questions, manage the assignation of users, see the answers provided, and much more...

JQuarks also features a configurable module that allows you to list the available quizzes, giving your visitor a constant visual on what your site offers.


Questions

Creating and managing questions is crucial to all quizzes management system, Under Questions we will be able to create/edit our questions, define proposals, choose their type, categories, etc. ...

Let's create a new question. This can be done through the New button

JQuarks features three different types of questions : We do not have to worry about the type of question that we create, JQuarks determine the following proposals that we provide.

Let's create our question, and add some suggestions


The question we have now is a single-choice question.

A final step is to assign the question to a category. Categories are groups of thematic questions manageable via JQuarks (they are independent of the categories that Joomla manage). These categories are not meant only to help organize questions by subject but are, as we shall see later, important to the Sets of questions

Adding a category may be made directly from the question's editing screen or from categories.

Note that if we choose to not define a category JQuarks store the question as Uncategorized. Of course you can change the category afterward

Finally we will save our question using the save button

We just added our first question. Now let's move on to the Sets of questions and how create them


Questions

Au niveau de JQuarks la création de questions joue un rôle primordiale, c'est ici que nous saisirons nos questions, que nous leur définirons des propositions, que nous choisiront leur type, leur catégorie, etc...

Pour l'instant nous ne disposons pas de questions nous allons donc choisir d'en crée une nouvelle via le bouton Nouveau

Au niveau de JQuarks nous pouvons avoir trois types de questions différentes : Nous n'avons pas a nous soucier du type de question que nous créons, JQuarks le déterminera suivant les propositions que nous fournirons.

Il est important de noter que JQuarks est optimisé pour fonctionner avec l'éditeur TinyMCE et que ce dernier doit donc être activé ( toutefois le support d'autres éditeurs sera prochainement ajouté )

Créons maintenant notre question, et ajoutons quelques propositions


La question que nous avons actuellement est donc une question à choix unique.

Une dernière étape est celle de définir une catégorie à la question. Les catégories sont des groupements thématiques de questions gérables via JQuarks (il ne sagit pas ici des catégories que gère Joomla). Ces catégories ne se limitent pas seulement à permettre d'organiser les questions par thèmes mais jouent, comme nous le verrons plus tard, un rôle important au niveau des Ensembles de questions

Ajouter une catégorie peut-être fait directement sois depuis l'écran des questions ou depuis l'interface propre aux catégories.

Notons que si nous choisissons de ne pas définir de catégorie JQuarks placera la question dans les questions sans catégories.

Pour finir sauvegardons notre question via le bouton sauver

Nous venons d'ajouter notre première question. Passons maintenant à la création d'Ensembles de questions


Quiz

Now that we have sets of questions all is left is to combine them to create our quizzes.

JQuarks have two types of quizzes:

Let's create our first quiz

The quiz that we just created is private. This means that only Joomla's registered users that are affected to this quiz will be able to pass it. If we defined the quiz as public, all users (including guest) will have had access.

We also chose to limit the quiz to a period of 10 minutes If we left this field blank, the quiz would be not timed.
Note that if a quiz is time limited, a countdown will be shown to the user and a time-out will cause the quiz to end and automatic store the answers provided so far.

Finally, in the case of private quizzes we can limit the number of times a user can pass the quiz and this by checking the Unique session box

It's also possible to do some configuration

JQuarks has a global configuration for all quizzes, but it is possible to override it for a specific quiz
We can also define when a quiz will start being published and when it will be unpublished

Our quiz is now created. But it still lacks the sets, so let's assign some

The last step is to assign users to our quiz

Using the corresponding option we can choose among the list of Joomla's active users those allowed to pass the quiz.
Note that once our quiz is published it will be possible to notify the applicant of its availability by sending an e-mail notification. By default JQuarks has a standard template that we can customize.

Finally, to make the quiz available it is necessary to publish it.

Now that our quiz is online we just have to wait for the first Sessions (en)


Quiz

Maintenant que nous disposons d'ensembles de questions il ne nous reste plus qu'à les associer pour crée nos quizzes.

JQuarks distingue deux types de quizzes :

Créons notre premier quiz

Le quiz que nous venons de créer est un quiz de type Enregistré cela signifie que seuls les utilisateurs Joomla qui y seront affecter auront la possibilité de le passer. Si nous avions défini le quiz comme publique, touts les utilisateurs (y compris les visiteurs de notre site) y auraient eu accès.

Nous avons également choisit de limiter le quiz à une durée de 10 minutes, si nous avions laissé ce champs vide, le quiz aurait été non limité dans le temps.
Remarquons que pour les quizzes limité dans le temps un décompte sera afficher à l'utilisateur et la fin du temps impartis signifiera l'arrêt du quiz et la sauvegarde automatique des réponses fournies jusque là.

Enfin, uniquement dans le cas des quizzes enregistré nous avons la possibilité de limiter le nombre de fois où un utilisateur pourrait passer notre quiz et ce en cochant la case Session Unique

Intéressons nous maintenant aux paramétrage du quiz

JQuarks gère la pagination de façon global pour tout les quizzes, mais il est possible de définir une configuration locale
C'est également ici que l'on pourra définir les dates de début et de fin de publication d'un quiz

Notre quiz est maintenant crée. Mais il lui manque encore les ensembles. Passons donc maintenant à l'assignation d'ensembles

L'interface proposée nous permettra de choisir quels ensembles assigner.

La dernière étape est celle d'affecter des utilisateurs à notre quiz

Via l'interface d'affectation des utilisateur il nous est possible d'affecter parmis la liste des utilisateur Joomla actif (dont le compte est activé) les utilisateur autorisés à passer le quiz.
Notons qu'une fois que notre quiz est publié il nous sera possible de notifier les candidat de sa disponibilité et ce en leur envoyant un mail de notification. Par défaut JQuarks envoie un e-mail standard qu'il nous est possible de personnaliser.

Enfin pour mettre le quiz à disposition il est nécessaire de le publier.

Maintenant que notre quiz est en ligne il ne nous reste plus qu'à attendre de recevoir les premières Réponses des utilisateurs


Réponses des utilisateurs

Maintenant que nos quizzes sont en place nous allons commencer a recevoir les rapports des session effectués par nos visiteurs.
En effet a chaque fois qu’un utilisateur répondra à l’un de nos quiz, un rapport sur les réponses fournies sera généré côté administration.

JQuarks offre également une option pour exporter les sessions réponses des utilisateurs, il est à noter que cette fonctionnalité exporte seulement les sessions actuellement affichée, il est donc nécessaire d'appliquer les filtres nécessaires avant de lancé l'export

Il est également possible de visualiser le détail des réponses fournies par chaque utilisateur et de corriger les éventuelles réponses libres du quiz.

Sessions des utilisateurs

Il est important de noter que si au niveau des paramètres de Joomla, la gestion des Session est effectuée via la base de donnée, la durée de la session dois être adaptée conformément à la durée maximal de nos quizzes, cela évitera qu'un utilisateur sois déconnecter du site avant qu'il n'ai pu envoyé ses réponses.


Sessions

Now that our quizzes are in place we will start receiving reports of session conducted by our visitors.

JQuarks also offers an option to export the users sessions, this feature only exports the session that are currently displayed, so it is necessary to apply the necessary filters before exporting

It is also possible to view the detailed responses provided by each user and correct any free answers the quiz.

User sessions

Note that if Joomla's session management is done using the database, the session length should be adjusted according to the maximum duration of our quizzes, this will prevent a user from being disconnected from the site before he could have finished answering.


Sets of questions

Now that we have thematic questions it would be interesting to begin affecting them to our quizzes, but rather that directly affecting the questions we will combine them into sets to be affected to quizzes.

The sets of questions provide many benefits :

Create a set of question is simple we just enter the title of the set and define its type.

Two types are available :

Custom Sets

Let's start by creating a custom set :

We just have to click on the assign button of a question to assign it to our set.
You can choose to assign questions from same or different categories.

Finally we just save our changes.

Random sets

Random sets are sets belonging to a single category.
Once we have selected one category, we will be able to assign questions within the limits of availability.

Let's create a random set :

Note: This type of set once assigned to a quiz will retrieve every time the specified number of questions defined for the corresponding category

Now that we have a set all that remains is to create our first Quiz


User Guide

Underlying all quizzes are a series of questions, JQuarks focuses its capabilities on questions and how to categorize them, group them. Everything is thought to enable us to build upon the questions that we create and give us the possibility to easily reuse them in different quizzes.

JQuarks component is available under Components -> JQuarks

Once into the component a sub-menu appears and allows us to quickly switch between the different elements

In this guide we'll look JQuarks main elements :


We are using JQuarks

Here we showcase some of the sites using JQuarks that we ran into, if you would like to add/remove your quiz to/from this list please contact us at

linuxsecrests.com: http://linuxsecrets.com/linux-documents/take-a-quiz.html

awa-ca.org: http://www.awa-ca.org/index.php?option=com_jquarks&controller=quizzes

carrefourmedical: http://pop.carrefourmedical.net/index.php?option=com_jquarks&view=quiz&Itemid=67

ramberinfo: http://ramberinfo.com/index.php?option=com_jquarks&controller=quizzes

konfou.com: http://konfou.com/index.php?option=com_jquarks&view=quizzes&Itemid=114

college-terrenoire.fr: http://www.college-terrenoire.fr/index.php?option=com_jquarks&view=quizzes&Itemid=358

windowtreatmentcenter.com: http://windowtreatmentcenter.com/component/option,com_jquarks/Itemid,78/view,quiz/

HomeCon: http://homecon.net/index.php/retrofreak-quiz/quizzes

Tetrisgems: http://tetrisgems.com/index.php?option=com_jquarks&controller=quiz&id=1&lang=en


We are using JQuarks!

Here a non-exhaustive list of companies and websites using JQuarks:

If you would like to update your entry, or to be added, please contact us at