1.0.1 • Published 6 years ago

jquery.nospamquiz.js v1.0.1

Weekly downloads
1
License
GPL-3.0
Repository
github
Last release
6 years ago

jQuery.noSpamQuiz.js

A simple jQuery plugin to prevent spammers.

About

This jQuery plugin is based on a Wordpress plugin I stumbled upon, named NRKbeta Know2Comment. It tries to prevent visitors leave comments without actually reading the article first. The idea is very simple but I believe it could be quite powerful.

Before exposing the comment form at the end of the article, it renders a number of pre-defined questions specific to the article it's displayed on. If the visitor answers all the questions correctly, the quiz form would be replaced with the hidden form.

Any user interaction could be bundled with this plugin to ensure participants actually reads the content before they interact with the website.

Usage

The plugin options can also be defined using the data-nospamquiz attribute.

<div id="comment-form-quiz"
  data-nospamquiz='{
    "prize": "#comment-form",
    "questions": [
      {
        "question": "What is the name of the Wordpress plugin author inspired from?",
        "choices": [
          "Disqus",
          "Know2Comment",
          "Gutenberg"
        ],
        "correctAnswer": 1
      },
      {
        "question": "What is the radius of Earth?",
        "choices": [
          "6,371 kilometers",
          "371 kilometers",
          "200 kilometers"
        ],
        "correctAnswer": 0
      }
    ]
  }'></div>
<hr> <!-- this immediate element cannot be used -->
<hr>
<div id="comment-form"><!-- i.e. Comment form --></div>
$('#comment-form-quiz').nospamquiz({
  headlineMarkup: '<h2 class="h4"></h2>',
  headline: 'Jeopardy',
  intro: 'Please answer the following questions to enable the comment form for this post.',
  onComplete: function() {
    alert('Thank you for all the correct answers. Now you can use the comment form.');
  }
});

Options

OptionTypeDefaultDescription
headlineMarkupstring<h2></h2>The quiz header is wrapped with this markup.
headlinestringQuizThe quiz header text.
introMarkupstring<p></p>Introduction text wrapping markup.
introstringPlease answer the following questions to enable the form.Introduction text explaining what the quiz is about.
questionsobject[]Required. JSON object containing the questions.
failureMarkupstring<p></p>Failure message wrapping markup.
failurestringYou must answer all questions correctly.Failure message text
prizemixed (jQuery selector / jQuery object)this.$el.next()The DOM element to be shown upon successful completion. Default is the immediate element in the DOM tree.
onCompletefunctionnullCallback function.
1.0.1

6 years ago

1.0.0

6 years ago

0.1.0

6 years ago