How Many Can You Name

Javascript and markup for publishing open-ended "How many of X can you name?"-style quizzes. Example.

Usage

How to develop with this repo

1. Check out the repo.
2. Put the www directory somewhere on your web path.
3. Test your changes with the _blank/index.php file.

How to create a quiz

1. Copy the _blank directory into a new directory, named after your quiz.
2. Edit your new index.php file.
   1. Edit the title element.
   2. Edit the canonical meta element.
   3. Edit the <h2>.
   4. Edit the <input id="answer_key" type="hidden" and add your answers.
   5. If you need more than two minutes, edit the values of the <input id="time_limit" type="hidden" value="2" /> and the <input id="timer" type="text" readonly="true" value="2:00" name="timer" /> elements.
   6. Edit the var quiz_config = { object.
      1. Add the quiz title and slug.
      2. If your quiz doesn't have photos, change the has_photos property value to 0.
3. Add the quiz to the database.
   1. Copy the SQL from www/sql/insert.sql, INSERT INTO howmany (slug, max, create_date) VALUES ('fast-and-furious', 8, NOW());
   2. Replace the "fast-and-furious" value with whatever your quiz slug is.
   3. Log in to your database server and execute that query.
      1. If you run into trouble and need to edit your entry, you can edit the database record with a query along the lines of UPDATE howmany SET slug='new-slug-name' WHERE quiz_id=9 LIMIT 1;.
      2. If you want to delete your record and start over, do that with DELETE FROM howmany WHERE quiz_id=[ID-OF-YOUR-ERRANT-QUIZ] LIMIT 1;

How to update a quiz

1. If the quiz is not in repo, download the latest version of the quiz from the server.
   1. If you're deploying via scp, that command may look something like cd path-to-www; scp -r prod:/apps/quiz/specific-quiz ./
2. Edit index.php in your text editor, go down to around line 48. You'll want to edit the line below the line that has EDIT: Put the answers here on it.
3. In the line below, add your answers to the value attribute of the answer_key input (<input id="answer_key" type="hidden" value="...).
4. If this is a photo quiz, add the photo(s) to the img directory.
5. Update the max value for that particular quiz in the database.
   1. SSH into the server.
   2. Log in to the database.
   3. Find the quiz_id for the quiz you're editing. You can see a list of all the quizzes and the quiz_id's with SELECT * FROM howmany;
   4. Update the max field value with a query such as UPDATE howmany SET max = 183 WHERE quiz_id = 16;, but replace the 183 and the 16 with your particular values.
6. Re-deploy.

About the code

The split answers / the Dwight Gooden exception

Dwight Gooden also goes by Doc Gooden and we wanted people to be able to type in either Dwight or Doc Gooden and still have it count as a correct answer. Because of this, a lot of javascript was written. You can see most of it by searching for "SPLIT ANSWER" in the js.

Credits

Design by Jeffrey Mariano, New York Daily News. Markup, CSS, most of the javascript by Joe Murphy, New York Daily News / Denver Post.