2011-08-02 23:08:13 +02:00
|
|
|
#+title: an5w
|
|
|
|
|
#&summary
|
|
|
|
|
A PHP script for simple surveys
|
|
|
|
|
#&
|
|
|
|
|
#+license: bysa, page
|
|
|
|
|
#+license: wtf, program
|
|
|
|
|
|
|
|
|
|
* an5w
|
|
|
|
|
#&img;url=art.png,title=Hmm..
|
|
|
|
|
|
|
|
|
|
an5w (pronounced "answ" as in "answer") is a simple PHP program for creating
|
|
|
|
|
online surveys. It consists of just two PHP files, one that serves the user and
|
|
|
|
|
one that shows the answers.
|
|
|
|
|
|
|
|
|
|
** Download
|
|
|
|
|
|
|
|
|
|
[[an5w.tar.gz][Here]]
|
|
|
|
|
|
|
|
|
|
** Documentation
|
|
|
|
|
You will not find any documentation in the an5w tarball --- not even a single
|
|
|
|
|
readme. When you've extracted the an5w directory from the tarball, put it in a
|
|
|
|
|
place your webserver recognizes. That should work.
|
|
|
|
|
|
|
|
|
|
The code has no comments, basically because it's scaringly simple and extremely
|
|
|
|
|
short. an5w is released under the WTFPL&acro='Do What The Fuck You Want To
|
|
|
|
|
Public License', as published by Sam Hocevar [[http://sam.zoy.org/wtfpl/][here]].
|
|
|
|
|
|
|
|
|
|
A raw an5w directory has the following files and directories (*answers*
|
|
|
|
|
and *art* are directories):
|
|
|
|
|
|
|
|
|
|
#&pre
|
|
|
|
|
*answers* button footer
|
|
|
|
|
*index.php* style.css wrapper art done header *questions* title
|
|
|
|
|
#&
|
|
|
|
|
|
|
|
|
|
However, only the ones in bold are actually necessary. You can remove
|
|
|
|
|
the rest without an5w failing. In the 'answers' directory, it's the same:
|
|
|
|
|
|
|
|
|
|
#&pre
|
|
|
|
|
*index.php* style.css
|
|
|
|
|
#&
|
|
|
|
|
|
|
|
|
|
Again, only the bold ones are needed. In this case, you only need 'index.php'.
|
|
|
|
|
|
|
|
|
|
*** Description of files
|
|
|
|
|
|
|
|
|
|
#++pre
|
|
|
|
|
#+BEGIN_SRC
|
|
|
|
|
answers/index.php:
|
|
|
|
|
The program that shows answers
|
|
|
|
|
|
|
|
|
|
answers/style.css:
|
|
|
|
|
CSS styles
|
|
|
|
|
|
|
|
|
|
button:
|
|
|
|
|
The text of the submit button. Default is "Submit".
|
|
|
|
|
|
|
|
|
|
footer:
|
|
|
|
|
Text to display on the bottom of the page. Default is nothing.
|
|
|
|
|
|
|
|
|
|
index.php:
|
|
|
|
|
The main program
|
|
|
|
|
|
|
|
|
|
style.css:
|
|
|
|
|
CSS styles
|
|
|
|
|
|
|
|
|
|
wrapper:
|
|
|
|
|
The HTML element(s) that wrap everything else. Default is
|
|
|
|
|
"<div id='wrapper'>TEXT</div>\n" (where TEXT is the actual content).
|
|
|
|
|
|
|
|
|
|
art/art.xcf:
|
|
|
|
|
Promotional question marks
|
|
|
|
|
|
|
|
|
|
art/art-small.png:
|
|
|
|
|
Promotional question marks in mini version
|
|
|
|
|
|
|
|
|
|
done:
|
|
|
|
|
Text to display when the survey has been completed.
|
|
|
|
|
|
|
|
|
|
header:
|
|
|
|
|
Text to display on the top of the survey page.
|
|
|
|
|
|
|
|
|
|
questions:
|
|
|
|
|
The actual questions. See the *markup* section below.
|
|
|
|
|
|
|
|
|
|
title:
|
|
|
|
|
The title of the survey. Will only be displayed on the titlebar of the page.
|
|
|
|
|
#+END_SRC
|
|
|
|
|
|
|
|
|
|
*** Markup
|
|
|
|
|
The syntax used in the 'questions' file is really quite simple. It looks like
|
|
|
|
|
this:
|
|
|
|
|
|
|
|
|
|
#&pre
|
|
|
|
|
Question
|
|
|
|
|
Type of input (in form of text, multiple choices, etc.)
|
|
|
|
|
|
|
|
|
|
Another question
|
|
|
|
|
Type of input
|
|
|
|
|
#&
|
|
|
|
|
|
|
|
|
|
An example:
|
|
|
|
|
|
|
|
|
|
#&pre
|
|
|
|
|
To what extent do you get annoyed when people attack you with pencils?
|
|
|
|
|
[]
|
|
|
|
|
|
|
|
|
|
Why are cows unable to fly (in your own opinion)?
|
|
|
|
|
[]
|
|
|
|
|
#&
|
|
|
|
|
|
|
|
|
|
Currently (as of version 0.001), only the '[]' input type is supported. '[]' =
|
|
|
|
|
<textarea>.
|
|
|
|
|
|
|
|
|
|
A question can only take up one line. If you need a newline, use a <br /> tag
|
|
|
|
|
instead.
|
|
|
|
|
|
|
|
|
|
To see answers, just visit answers/index.php in your web browser.
|
|
|
|
|
|
|
|
|
|
*** Details
|
|
|
|
|
an5w does not store data a database. It uses text files.
|
