Downloads

Qwizcards online quizzes and flashcards is available as a WordPress plugin, and as stand-alone JavaScript that you can include in any web page.

WordPress Plugin

To install the Qwizcards WordPress plugin:

From your WordPress Dashboard, go to Plugins, then Add New.

Enter Qwizcards in the Search Plugins box at the top right.

Click Install.

Or, you can download the plugin and install it manually:

Go to https://wordpress.org/plugins/qwiz-online-quizzes-and-flashcards to download to your local computer.

Upload the plugin file to your WordPress plugins directory (…/wp-content/plugins).

Activate the plugin with Dashboard > Plugins > Installed Plugins

Stand-alone JavaScript

By including the Qwizcards JavaScript files in your own pages, you can create quizzes and flashcard decks using the standard Qwizcards shortcodes (see Quizzes quickstart and Flashcards quickstart).

Currently, labeled diagrams cannot be created outside WordPress, nor can you use the “wizard” (which creates shortcodes for you) – but we’ll have these features soon!

To create quizzes and flashcard decks on your own pages, add this code to the <head> section of each web page:

<script src="//code.jquery.com/jquery-3.2.1.min.js"></script>
<script src="//code.jquery.com/ui/1.12.1/jquery-ui.min.js"></script>
<link href="//code.jquery.com/ui/1.12.1/themes/base/jquery-ui.css" rel="stylesheet" type="text/css" />

<script src="//qwizcards.com/wp-content/plugins/qwiz-online-quizzes-and-flashcards/qwiz_qcards_common.js"></script>
<script src="//qwizcards.com/wp-content/plugins/qwiz-online-quizzes-and-flashcards/qwiz.js"></script>
<script src="//qwizcards.com/wp-content/plugins/qwiz-online-quizzes-and-flashcards/qwizcards.js"></script>
<script src="//qwizcards.com/wp-content/plugins/qwiz-online-quizzes-and-flashcards/terms.js"></script>

<link href="//qwizcards.com/wp-content/plugins/qwiz-online-quizzes-and-flashcards/qwiz.css" rel="stylesheet" type="text/css" />
<link href="//qwizcards.com/wp-content/plugins/qwiz-online-quizzes-and-flashcards/qwizcards.css" rel="stylesheet" type="text/css" />

 

These HTML tags load the needed jQuery scripts from jQuery’s repository (a “CDN” – content delivery network) and load the Qwizcards scripts from the qwizcards.com site.  So you don’t actually need to download anything!

Customization

You can customize your quizzes and flashcards by including code such as the following in the <head> or <body> sections of your web page, before the script code shown above.

<script>
   var qwiz_params = {
      'icon_qwiz': 'Icon and link',
      'T':         {
         'Got it!':            'Show next card',
         'Need more practice': 'Show this card again later'
      }
   };
</script>

This code sets two properties: “icon_qwiz” (for the Qwizcards icon that appears on the first page/card of a quiz or flashcard deck); and “T” (for “translations”).

The icon_qwiz property value determines how the Qwizcards icon is displayed.  It may have the following values: “Icon and link”, “Icon only”, “Not displayed”.

The T property is an object that may contain properties consisting of the values of strings displayed by the qwiz.js and qwizcards.js scripts.  You can enter new values for each such string, which will replace the default strings displayed by the scripts.  In this example, “Got it!” and “Need more practice” are the default labels of two buttons that accompany flashcards.  With this code, the first button instead will have the label, “Show next card”, and the second button will have the label, “Show this card again later”.

Labeled diagrams

Please note that the stand-alone version of Qwizcards does not allow you to create new labeled diagrams, for now.  Labeled diagrams are created through integration with the WordPress editor, TinyMCE.

If you create a labeled diagram within WordPress, you should be able to copy the page (use Text mode) to another web site, where the stand-alone version will be able to display the labeled-diagram.

Working example

<!DOCTYPE HTML>
<html>
<head>
    <script src="//code.jquery.com/jquery-3.2.1.min.js"></script>
    <script src="//code.jquery.com/ui/1.12.1/jquery-ui.min.js"></script>
    <link href="//code.jquery.com/ui/1.12.1/themes/base/jquery-ui.css" rel="stylesheet" type="text/css" />

    <script src="//qwizcards.com/wp-content/plugins/qwiz-online-quizzes-and-flashcards/qwiz_qcards_common.js"></script>
    <script src="//qwizcards.com/wp-content/plugins/qwiz-online-quizzes-and-flashcards/qwiz.js"></script>
    <script src="//qwizcards.com/wp-content/plugins/qwiz-online-quizzes-and-flashcards/qwizcards.js"></script>
    <script src="//qwizcards.com/wp-content/plugins/qwiz-online-quizzes-and-flashcards/terms.js"></script>

    <link href="//qwizcards.com/wp-content/plugins/qwiz-online-quizzes-and-flashcards/qwiz.css" rel="stylesheet" type="text/css" />
    <link href="//qwizcards.com/wp-content/plugins/qwiz-online-quizzes-and-flashcards/qwizcards.css" rel="stylesheet" type="text/css" />

</head>
<body>

[qdeck]
[q] Define “gene”
[a] The unit of heredity.
[q] Define “heredity.”
[a] The passing of traits from parent to offspring.
[/qdeck]


</body>
</html>

7 thoughts on “Downloads

  1. Ben

    Hi Dan,

    Great stuff, first and foremost. It has been fun to use these for a few months now. I wanted to download the files for a non-wordpress install and was curious what kind of license this is under, if any. Is it GNUv3 or MIT, by chance? I don’t want to make manipulations to the code unless that’s in the spirit of your intentions for your creation.

    Sincerely,
    Ben

    Reply
    1. Dan Kirshner Post author

      Thanks very much. The license is GPL2 (per qwiz-online-quizzes-wp-plugin.php, the main module of the plugin). We haven’t focused on the stand-alone version for a while now; please keep us posted! We’re planning a new, more comprehensive stand-alone version, which includes a non-WordPress version of the TinyMCE editor. Let us know if that’s of interest.

      –Dan

      Reply
      1. Ben

        Hi Dan,

        Thanks fo the reply. It’s great to see you chose GPLv2. I have been tinkering with the standalone and I really enjoy using it. That TinyMCE editor is probably a good idea for most users but I enjoy the longhand code. Now that I know you are doing GPLv2, I am going to try to get some of my friends to make flashcards and see if they are comfortable with it (non-coding background). I bet they would love the TinyMCE as it will have a smaller learning curve.

        Thanks again for all your help. I’ll keep you posted over when we have had a few months to enjoy what you have built.

        Sincerely,
        Ben

        Reply
    1. Dan Kirshner Post author

      I just downloaded the files, and copied and pasted the “working example.” The only problem I had was that the quotation marks, for example in src=”jquery-1.11.1.min.js”, were wrong and I had to replace each one with a regular double quote. Then it worked fine (Firefox and Chrome on PC). I’ve since fixed those double quotes, so the example should work fine.

      Reply
  2. Matt

    any chance you could combine this with the plugin HH Quizzes to make a supercharged plugin and then make it compatible with the theme WPLMS?

    Reply
    1. Dan Kirshner Post author

      No, no chance! I looked at HH Quizzes — the documentation consists mainly of “read the code” — which is commented in German, so doubly obscure to me.

      The WPMLS site seems incomplete (the Latin “impsum dolor” etc. is still present in many cases) and is impossible to navigate. The one WordPress support-site comment I saw said “do not buy this.”

      –Dan

      Reply

Leave a Reply

Your email address will not be published. Required fields are marked *