READ LICENSE BEFORE USE!

EdogsOpros Module 1.0.9.a for PHP-Nuke 6.5 and up.
Homepage http://www.edogs.dogsempire.com
Current website dedicated to our works http://www.eklon.com - upgrading

Our site dedicated to Great Danes dogs. Russian language
http://www.dogsempire.com
Any ideas and etc you can mail by edogs@dogsempire.com
If you want donate us, or use this Survey for commercial write e-mail to us.
We can write ANY module on your custom for PHP-Nuke, or create separate module for more than reasonable price. We located in Russia, and this allows to keep low prices and high standart quality.

Why we created this module. The main reasons.
1) Security holes in standart Survey of PHP-Nuke
2) No good tracking of peoples who cheats on Polls.
3) No chance to ask several question, to allow multichoice and etc.
.. and many more.
x) And the last. We made good import of all answers from standart Survey to our survey.
Short instruction on installation simple: unzip, run install.php, run import.php.
Read this instruction CAREFULLY, you will know about many hided features.
Get in minds, that things which shows to admin, is not always shown to users:-)
There are no separate admin panel, because we fill it's more comfortable to admin directly from Survey.

LICENSE READ IT BEFORE USE!
IT IS FORBIDDEN
1) To change copyrights. Make them less visible, delete, or something else. If we will think that you have  changed copyrights, this decision will be final and undisputed
2) To distribute a code of this module with or without any changes without the writen agreement with authors. This module should be located only at native site ( www.edogs.dogsempire.com ), except situation there authors allowed to put it on another location
3) To use this module on COMMERCIAL sites without additional agreement with authors.


This is something like very powerfull Survey/Polls/Questionarre module.
It's destined to replace standart Survey module in PHP-Nuke. You can just import your PHP-Nuke Surveys here, and use our more advanced module. Unfortunately comments to Surveys is not same powerfull as in PHP-Nuke, but another features cover up it all.
Also this module can be installed as an addition to standart Survey module.
Unfortunately we forgotten to allow attach Surveys to articles. This will not work.

Functions and MAIN GOAL of this Module.
1) The first thing is safety of module, and tracking cheats. All that can be done for this - are done. All cheats can be tracked. We sure that there are no security holes.
2) Admin have FULL access. Any HTML tags allowed.

DESCRIPTION of this module.
1) You can create unlimited count of Surveys. Edit it freely. Any Survey have next features/properties.
a) Access restrictions for registred/all users.
b) Activation/deactivation of Survey for SAFETY editing of Survey, or totally hiding.
c) Time management of Survey. Survey will be available only in desired limit of time. If you want to make Survey visible, set "end" date to past time.
d) Creation of Surveys for "block". Such Surveys will be shown in PHP-Nuke block, like standart Survey. Be carefull during creation questions for such Survey, they should fit in your block:-)
e) You can ask e-mail and name from users. Registred users have it automatically.
f) You can demand to enter e-mail and name from users. Registred users have it automatically. Be carefull if you in using this feature. If you will demand e-mail and name, but forget to ask it:-) Guess that?:-)
g) You can select if Survey will automatically report to user that he/she already voted.
h) You can make overall statistics available or closed for users.
i) All points of Survey can be fully edited. You can also insert HTML tags in name of Survey for using pictures or links or something else in name.
j) In the LIST of Surveys administrator can delete Survey or Clear voters.

QUESTIONS to exact Survey.
1) Name - it's clear
2) Type of question.
a) numeric/rating - numerical fields. Results in statistics shows as average. Numeric - manual enter of number. Rating - select from numbers. For numeric also "limitlow" and "limithigh" field used - obvious answer limitation.
b) text/textarea - text fields. text - line input of text. textarea - box for input of text. "limithigh" - will limit maximum set of letters.
c) radio/radiov - one choose of answer radio buttons. radio - horizontal location. radiov - vertical location.
d) list - one choose list type.
e) checkbox/checkboxv - multiple choose of answers of checkbox type. checkbox - horizontal location. checkboxv - vertical location.
f) multiple - multiple choose of answers of multiple style.
3) active question - ask this question or not. HINT: If you want to insert questions later, leave place for them making quesiton inactive. Order of questions can't be changed. But you can edit it and delete.
4) have to answer - if user have to answer this question or can leave this question without answer.
5) Variants of answer - of course acts only if type of question right. One version of answer - one line. Don't make mistake - don't leave last line blank.
6) Full editing.

Working with BLOCK.
1) We have made VERY functional block. It shows only active Surveys. Announce Surveys by name of Survey which can't be shown in block. And shows "block" type Surveys in block.

STATISTICS.
1) For administrator.
Very good tuning of statistics.
You can choose which users include to statistics. We mean you can delete from statistics users who were unregistred, who voted several times from one IP/cookie, blocked cookie, registred users voted twice. 
2) For users.
By default ALL votes shown. We made it so, because smart user who will see that his cheats doesn't work, will find the way - anonymous proxy, clearing cookies, twice and more times registering. So let them think that they are smart and can cheat:-)
BUT you can change this settings for this module in configuration file.

INSTALLATION. 
1) Unzip Archieve to your PHP-Nuke.
1a) Save your DB
3) Run install.php (it should drop in root directory during unzip). install.php should echo something like part1 all ok part 2 all ok part 3 all ok part 4 all ok
4) Activate BLOCK and MODULE
4a) Run import.php (it should drop in root directory during unzip also) if you want to import your previous Surveys from PHP-Nuke standart Surveys to our advanced module.
5) Make experiments.
6) Write anything you want to say to edogs@dogsempire.com
7) Don't delete copyrights. If you don't like see our copyrights on your site you have two way: a) Pay us and get permission to legal use without copyrights b) Delete our module and don't use it

ADDITIONAL FEATURES OF TUNING.
All available in file config.inc.php
Don't be scared with comments language in this file. It's Russian, but don't worry, variables can be changed freely, and full description you will see here.
$f_disable_writing_2nd_votes=FALSE; //set TRUE if you want to disable WRITING not first votes in DB. Set FALSE by default, because any time you can exclude such votes from statistics. It's good to know who try to cheat:-)

$f_override_bgcolor=TRUE; //Insert another color for table of Surveys module
$f_main_table_color='  bgcolor="#FFFFEE"'	; //color of table in Surveys module, of line higher is set to TRUE

//variables which determinate how to show statistics for anonymous
$f_stat[0]='Yes'; // show votes from same IP
$f_stat[1]='Yes'; // show votes from users with blocked cookies
$f_stat[2]='Yes'; // show votes from users voted from one computer several times (several cookies)
$f_stat[3]='Yes'; // show votes from unregistred
$f_stat[4]='Yes'; // show double votes from registred users

$enable_sorting_in_q=TRUE; // set TRUE if you want to sort answers by count. More answers same type - higher

$show_result_inblock=TRUE; // set TRUE if you want to show number of votes in block. Act only in Surveys there statistics available for all.

$show_flat_opros=TRUE; //set TRUE to see EACH reply in admin statistics

$opros_table_w="1"; // width of border table in Survey
$opros_table_wstat1="1"; //width of border table for Statistics 
$opros_table_wstat2="1"; // width of border table for textarea
