Information Technology Light Poll System
ITLPoll Help Version 3.0
Thanks To Choosing This Program. With This Program You Can Install Powerful Polls Very Easy.
Help Contents :
3- Using ITLPoll Administrator System
4- How To ADD This Script On My Homepage
6- Dynamic Colors, Pictures And Forgotting Password System
7- Create, Edit, Delete and Manage Users
8- Create, Edit, Delete and Manage Permission Groups
This Is A
PowerFull System To Manage Your Website Polls Easily.
With This Script You Can :
1- Forgetting Users Password System
2- ADD Unlimited Polls
3- Add UNLIMITED Choices For Any Polls
4- Active Polls When Ever You Want!
5- Show Inactive Polls In Every Page You Want!
6- See The Archive Of Your Polls!
7- Easy Install The Poll System (Automatic - No Need SQL Structures For
You!)
8- Change And Choose Different Templates
9- Choose Different Languages For ITLPoll
10- Disable The System When Ever You Want
11- Create , Delete, Edit and Manage Unlimited Users for System
(New)
12- Create, Delete , Edit Group Permissions for Users ( Ability
to limit users to specific places ! )
(New)
13- Show Results With Dynamic 3D Pie and Bar Charts
(New)
14- Change Easily Users Password And Username
15- Show Results With Dynamic Images
16 - Using OOP Programming System
17- Use Hijri (Jalali) Date Format for the System
(New)
18- And More Features ...
This Script Is Very Secure From Hackers. You Can Install It On Your
Website without more security...
You Can Download This Software From :
http://wwww.sourceforge.net/projects/itlpoll
Demo and Testing my be available here :
http://itlpoll.sourceforge.net
If You Found A
Bug On This Script Or Have A Question You Can Go on Our Forums :
http://wwww.sourceforge.net/projects/itlpoll
Installing This Script Is Very Easy. You Only Want To Cerate A Database For This System. Then Upload All Files And Folders In ITLPoll System And Run index.php In Root ITLPoll System. You Automatically will be Rediected To Install System.
To Install You Should Set
Perimssion Of The config.php File to 777
In Windows Operating System it means set write permission to all users.
In Install Page You Have Some Boxes To Complete. First is Host That Default Is localhost and then username and password for MySQL Database and Finally Database That You Created Before.
Then You
Should Choose An Username & Password For The Administrator Of ITLPoll
System. Other Boxes Are Default For English Users!
For Two New boxes (Use Jalali and MaxChoices) are important. You Can Only set Maximum choices for once. it can't be change from administrator and will use for ever. You Can't set bigger choices than this number after installing system. so be carefull to setting this item. set how much big choices that you need for each poll. Jalali Date format added specially for persian users and persons who use Hijri Date Format. If your default Date Format is Georgian don't change it form "no".
After Installing The ITLPoll System You Should Delete Install Folder From Your Server
Ok ! Now Your ITLPoll System Is Ready To Use!
3- Using ITLPoll Administrator System
For Login The Administrator System If ITLPoll system Is On ITLpoll Folder and Your Site For Example Is example.com You Should Enter This Address :
http://www.example.com/ITLpoll/admin/
On This Page You Should Enter UserName And Password That You Entered In Installing Page. If Your UserName And Password be Correct You Will Logged in Administrator System. With Add New Poll Link You Can Add New Poll. When You Click This Link One Page Ask The Number of Choices For The New Poll And You Should Enter It. And Then You Should Enter Question and Choices Of The New Poll.
Notice : You Should Enter The Date With Format YYYY-MM-DD. Example : 2008-02-20 - If You Blank it, it Never Expires.
If you Activated Jalali Date Format Please Enter Dates in it's Format.
Notice : When You Add New Poll You Can't See It Until Activiate It In Edit or Delete Exist Polls Page.
For Edit Or Delete Exist Polls You Should Click Edit or Delete Exist Polls Link. In this page you can activate inactive polls by clicking option in active column and click Active Button. for edit polls you can click the each poll Icon that is under the numbers column (Tooltips will help you!) for delete polls you can click the Icons under the Delete Column.
In new version 2.6 you can see polls in different pages for navigate easily. With Next button will see the next page contain next polls and Back button will show the back button. under the table you will see the current page from total pages.
Notice : After Deleting You Can't Restore Polls.
There are two columns after number, delete and subject : named : Start Date and Expire Date that will show the start date of poll and expiration of poll. note that Dates will show in the date format that you selected in the installer page. note that date 0000-00-00 Means that this date not setted for poll.
How to Change Date Format : for changing date format from Hijri to Georgian you should open config.php and set $usejalali variable to "0" value. and to change from Georgian to Hijri You Should set $usejalali to "1" value.
4- How To ADD This Script On My Homepage
Adding ITLPoll To Your Website Homepage Is Very Easy in Version 2.7 !
Only You Need
to Change $itlpoll_path On Line 7 Of This Code (Under HERE! Co Can See This Code
On example_include.php File in this folder Too!) To Your ITLPoll Folder!
Then Copy This Code On Your Home Page Document On First Line !
Notice : This 9 Lines Must Be Copied
At The First Line Of Your Home Page Or The Page You Want To Add ITLPoll
System. If You Don't Do it The Program Can't Work Properly With Cookies.
After Adding This Codes On The Top Of Your Home Page You Can Add This Line Every Where You Want To Show The Poll :
Just This !
In New Version Of ITLPoll You Can Show Inactive Polls. But You Can Only Show The Results Of Inactive Polls Because They Are Inactive! And Any User Can't Vote The Inactive Polls. You Can Show Them Only For Archiving.
For Showing Inactive Polls You Should Add "?pollID=Your Poll Number" After index.php File. For Example :
http://www.yoursite.com/itlpoll/index.php?pollID=NumberOfYourInactivePoll
(Replace NumberOfYourInactivePoll With Your Number Of Poll)
For Finding Number Of Polls You Can Help Your Administrator ITLPoll System. Please Note That If The Number You Are Choosing is Inactive The ITLPoll System Only Will Show The Results Of That Poll.
If You Are Using The include_itlpoll.php File (Means That You Have A File In Your HomePage That Includes The include_itlpoll.php File) You Can Add ?pollID After Your File That Includes include_itlpoll.php
6- Dynamic Colors, Pictures And Forgotting Password System
We Have Very Special Image resulting in version 3 ( and higher ) : 3D Charts such as 3D Pie and 3D bar. and still we have old 2D bar chart. for change between this situations go on "Edit Configurations and Users&Groups" and change "Default Graph" section as you want!
In New Versions
Dynamic Colors (Version 2.00), Pictures (Version 2.5) And Forgotting
Password System (Version 2.00) Had Been Added To ITLPoll System. You Can
Set Dynamic Colors In Admin Panel -> Edit The ITLPoll Configurations By
Changing The Color1 And Color2 Fields. The Colors Help Interface Link In
After Each Fileds. This Color Are Used For HTML Viewing Of Results And
Choices.
Dynamic Pictures Will Produced By old_image.php in the includes Folder. The
Color Of Bar Choices Are Random And When You Refresh The Page You Will
See The Diffrent Colors. You Can View Image Results By Static Link :
index.php?ImageResult . Alhough The Link Of This Showing In Under Each
Poll. Enjoy IT!
Fogotting Password System Actived In Admin Panel In Version 2.00 And
Is More Secure In Current Version For Accessing Thi You Should Type This
Address pathtoITLPollsystem/admin/?action=forget. Because Of The System
Can't Show Current Password Will Reset it For You. For Reseting Password
You Should Go On Forgot Password System Page and enter the administrator
UserName And Email Of It. If Your Gived Information Be Correct The
System Will Send An Email For You That Contains a Link That When You
Click It Your Password Will Reset. And Your New Password Will Send You
After A Few Seconds.
Notice : Probably The Hackers And Malicious User Try To Reset Your Password And Hack You. If You Received An Reseting Password Email From ITLPoll System And You Doesn't Request it. Don't Worry! Leave This Email And Don't Attention it. Until You Don't Click The Link Your System Works With Old Password.
in version 2.6 and higher the new ability that will separate the polls in different pages in edit and remove page in admin panel system is using the number of archive as the max numbers of poll showing in this page. for increase or decrease number of showing polls you can change this integer;
7- Create, Edit, Delete and Manage Users
In Version 3.0 ( or higher) there is an ability to Create, Edit, Delete and Manage Users. 'Users' word doesn't mean Users that votes but users that are probably administrator of System. and is probably because of Permission Groups that described in the next section.
Unlimited Users can login to Administrator Panel and do Administrator works such as 'Add Poll' or 'Edit Poll' and so on. for using this ability you should go to "Edit Configuration and Users&Group" Link at the top of the panel. in other word this ability is under config.php file. and in this file you should click "Manage and Create Users" Link. In this page you can change username, password, permission ( see next section ) or Block User and don't let the specific user to login ! for doing this things the requirement is clicking the Update Link. You Can Delete the user by Click Delete icon in it's row. But NOTE THAT THIS DELETE WORKS WITH NO CONFIRMATION.
If you want to Create new users you should click the "Create New User" under the table. in it's page you should enter new user information and new account will Create. but note on the Permission box and select it carefully ( see next chapter ).
8- Create, Edit, Delete and Manage Permission Groups
In Version 3.0 ( or higher ) there is an ability to create Permission Groups and set them to users.
Permissions are :
- Ability to Add
New Polls (can add)
- Ability to Edit Polls (can edit)
- Ability to Delete Polls (can delete)
- Ability to Change Configuration (can config)
- Ability to Manage Users and Groups (can group)
with first ability the Users that are belong to this group will be able to Add New Polls to database. second ability is to Changing Exist Polls only. third ability is about Delete Exist Polls. fourth ability is about change Configuration Variables such as default result , colors and so on. fifth ability is about that Can Create, Edit, Delete Users and Groups.
any user that have all of this abilities will be GOD. and any work can do ( like users on older versions ) .
For Create, Edit, Delete And Manage Permission Groups go to "Edit Configuration and Users&Group". and click "Manage and Create Permission Groups" Link. This Page is just like Users page. with update link you can update changes to groups. and with delete icon you can delete groups. NOTE THAT THIS DELETE WORKS WITH NO CONFIRMATION.
To Create New Users click the link under the table and enter New Group Information. Please Note that you can't set same names to groups. and this will causing error !
This Script Programmed by : Bahram Bahrambeigy. This Program Is Free And Any One Shouldn't Sell It. You Can Download It Free Here : http://www.sourceforge.net/projects/itlpoll .
Speacial Thanks To Simorgh-ev Security Group For Securing This Script. 2 SQL Injection Bug Founded By This Group. (Unfortunately this group ended their works )
Please Don't Remove The http://itlpoll.sourceforge.net Link From Footer Of the Program.
All Right Reserved To ITLPoll Special System - Programmer : Bahrambeigy
Iran - July 15 2009