Remerciez-le!

Remerciez @Admin pour avoir partagé cet document gratuitement, de la manière la plus simple, en partageant sur les réseaux sociaux.

Tanit Center - 2070 La Marsa – Tunisie www.iptech-offshore.com ∙ info@iptech-of

Tanit Center - 2070 La Marsa – Tunisie www.iptech-offshore.com ∙ info@iptech-offshore.com ∙ Tél + 216 70 93 77 73 ∙ Fax + 216 93 77 74 1 « Nos compétences, votre nouveau levier de croissance » JQuarks’ Guide Installation and user guide for JQuarks, a Joomla! Quiz Management Component Tanit Center - 2070 La Marsa – Tunisie www.iptech-offshore.com ∙ info@iptech-offshore.com ∙ Tél + 216 70 93 77 73 ∙ Fax + 216 93 77 74 2 « Nos compétences, votre nouveau levier de croissance » Table of contents 1 Presentation ......................................................................................................................3 2 Features .............................................................................................................................3 3 Installation Guide ...............................................................................................................4 3.1 Prerequisites for installation ............................................................................................... 4 3.2 Installation ........................................................................................................................... 4 4 User Guide .........................................................................................................................9 4.1 Questions ............................................................................................................................. 9 4.2 Sets of questions ............................................................................................................... 12 4.2.1 Custom Sets ............................................................................................................... 12 4.2.2 Random sets .............................................................................................................. 13 4.3 Quiz .................................................................................................................................... 13 4.4 Sessions ............................................................................................................................. 16 4.4.1 User sessions ............................................................................................................. 17 Tanit Center - 2070 La Marsa – Tunisie www.iptech-offshore.com ∙ info@iptech-offshore.com ∙ Tél + 216 70 93 77 73 ∙ Fax + 216 93 77 74 3 « Nos compétences, votre nouveau levier de croissance » 1 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. 2 Features JQuarks offers many features among which are:  Creation of questions with multiple answer choices, single answers choices and free answer  Random and custom sets of questions  Two types of quizzes, public and private (only available to registered users)  Quizzes are paginated and use two types of pagination (simple, and with slides)  Timed quizzes  Single session quizzes (only takeable once for each registered user)  Export of user answers to csv format Tanit Center - 2070 La Marsa – Tunisie www.iptech-offshore.com ∙ info@iptech-offshore.com ∙ Tél + 216 70 93 77 73 ∙ Fax + 216 93 77 74 4 « Nos compétences, votre nouveau levier de croissance » 3 Installation Guide  This installation guide corresponds to version 0.2.3 JQuarks  The Version of Joomla used is v1.5.14 3.1 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  TinyMCE v3.2.4.1 or  Joomla! v1.5.12 or later (version 3.2.4.1 is shipped with this version) 3.2 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  N.B. JQuarks uses "SyntaxHighlighter" http://alexgorbatchev.com/wiki/SyntaxHighlighter Now let's login the back-office of our website. And head to Extension -> Install / Uninstall Tanit Center - 2070 La Marsa – Tunisie www.iptech-offshore.com ∙ info@iptech-offshore.com ∙ Tél + 216 70 93 77 73 ∙ Fax + 216 93 77 74 5 « Nos compétences, votre nouveau levier de croissance » 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" Tanit Center - 2070 La Marsa – Tunisie www.iptech-offshore.com ∙ info@iptech-offshore.com ∙ Tél + 216 70 93 77 73 ∙ Fax + 216 93 77 74 6 « Nos compétences, votre nouveau levier de croissance » 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 Tanit Center - 2070 La Marsa – Tunisie www.iptech-offshore.com ∙ info@iptech-offshore.com ∙ Tél + 216 70 93 77 73 ∙ Fax + 216 93 77 74 7 « Nos compétences, votre nouveau levier de croissance » 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 Tanit Center - 2070 La Marsa – Tunisie www.iptech-offshore.com ∙ info@iptech-offshore.com ∙ Tél + 216 70 93 77 73 ∙ Fax + 216 93 77 74 8 « Nos compétences, votre nouveau levier de croissance » Once we have finished configuring the module we just save the modification. Now that JQuarks is installed, we can begin creating our quizzes! Tanit Center - 2070 La Marsa – Tunisie www.iptech-offshore.com ∙ info@iptech-offshore.com ∙ Tél + 216 70 93 77 73 ∙ Fax + 216 93 77 74 9 « Nos compétences, votre nouveau levier de croissance » 4 User Guide Underlying all quizzes is 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:  Questions  Sets of questions  Quiz  Sessions 4.1 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... Tanit Center - 2070 La Marsa – Tunisie www.iptech-offshore.com ∙ info@iptech-offshore.com ∙ Tél + 216 70 93 77 73 ∙ Fax + 216 93 77 74 10 « Nos compétences, votre nouveau levier de croissance » Let's create a new question. This can be done through the New button JQuarks features three different types of questions:  Single choice questions ( radio control for answers )  Multiple choices questions ( checkbox control for answers )  Free answer ( input field for replies ) We do not have to worry about the type of question that we create, JQuarks determine the following proposals that we provide.  No proposition, the question will be a free answer one  One or more proposition for which we only check one as correct, the question will be a single choice question  One or more proposition for which we check many as correct, the question will be multiple choice  It is important to note that JQuarks is optimized to work with the TinyMCE editor and the latter must be activated (Support for other editors will be added soon) Let's create our question, and add some suggestions Tanit Center - 2070 La Marsa – Tunisie www.iptech-offshore.com ∙ info@iptech-offshore.com ∙ Tél + 216 70 93 77 73 ∙ Fax + 216 93 77 74 11 « Nos compétences, votre nouveau levier de croissance » 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 Tanit Center - 2070 La Marsa – Tunisie www.iptech-offshore.com ∙ info@iptech-offshore.com ∙ Tél + 216 70 93 77 73 ∙ Fax + 216 93 77 74 12 « Nos compétences, votre nouveau levier de croissance » 4.2 Sets of questions Now that we have thematic questions it would uploads/s3/ jquarks-v024-guide.pdf