Download & Install

Download | Requirements | Installation Instructions | License | Development Credits

TalkNvote is free to download, use and the source code is available to modify, extend and redistribute.

Feel free to provide a link to http://www.talknvote.org

Files to Download

  1. talknvote-01-START-HERE.installation-instructions.v201561-134621.txt
  2. talknvote-02.db.v201561-134621.zip
  3. talknvote-03.app.v201561-134621.zip
  4. license.txt

Top ↑

You will need

  1. A server to host the software
  2. PHP 5
  3. MySQL 5.1.+ and a tool like PhpMyAdmin to access it
  4. Email account that uses SMTP for outgoing messages
  5. A tool to set cron jobs

Top ↑

Installation Instructions

The installation instructions below have been copied from the instructions file (number 1 in the list of files above)

********** REQUIREMENTS **********
THE INSTALLATION INSTRUCTIONS HAVE BEEN TESTED ON A TYPICAL SHARED HOSTING ENVIRONMENT THAT USES:

CPANEL
MYSQL 5.1.+
PHP 5
CRON JOBS
EMAIL ACCOUNT WITH SMTP FOR OUTGOING MESSAGES

********** STEP 1 ****************
Create a new MySQL database and import the database schema and data using a tool like phpMyAdmin

The database schema and data can be found in talknvote-02.db.vXXXXXXXX-YYYYYY.zip


********** STEP 2 ****************
Extract talknvote-03.app.vXXXXXXXX-YYYYYY.zip to your webroot folder (for example public_html) or any folder of your liking (for example public_html/talknvote). This folder will be referred to as the TalkNVote webroot

After the extraction, your TalkNVote webroot folder should contain: 

app 
cake 
.htaccess 
favicon.ico 
index.php 
license.txt 


********** STEP 3 ****************
Rename the file app/config/core.php.default to app/config/core.php


********** STEP 4 ****************
Edit the file app/config/core.php to match the configuration of your website. To do this please locate all the PLEASE_ADD_OR_CHANGE_THIS_VALUE occurrences and replace them with values that match those of your server.


********** STEP 5 ****************
Rename the file app/config/database.php.default to app/config/database.php


********** STEP 6 ****************
Edit the file app/config/database.php to match your mysql account. To do this please locate all the PLEASE_ADD_OR_CHANGE_THIS_VALUE occurrences and replace them with values that match those of your server.

TalkNVote has only been tested with MySQL


********** STEP 7 ****************
Your TalkNVote system should now be up and running. Visit your TalkNVote system: http://www.example.com/talknvote or just http://www.example.com if you used the domain root as your TalkNVote webroot.


********** STEP 8 ****************
You may use the login information of the default administrator account to start using the system.

Username: talknvote

Password: The one you have set in core.php (In case you change your password online at some point, the new password is stored in the db and the one in core.php is completely ignored.)

ONCE LOGGED IN, PLEASE CHANGE THE DEFAULT ADMINISTRATOR EMAIL: email-example@talknvote.org


********** STEP 9 ****************
TalkNVote needs to send out emails about voting starts, voting decisions, voting comments and voting reminders. A cron job needs to be defined for this purpose. Please consult your webhosting instructions for setting cron jobs. Please set the job to be executed frequently. For example every 15 minutes. Or more frequent than that, if your web hosting limits allow it.

The cron job required is:

php /home/YOURWEBHOSTINGUSERNAME/public_html/TALKNVOTEWEBROOT/app/webroot/cron_talknvote.php

For example if your "YOURWEBHOSTINGUSERNAME" is "talknv" and your "TALKNVOTEWEBROOT/" is "talknvote/" the above line should be as follows:

php /home/talknv/public_html/talknvote/app/webroot/cron_talknvote.php

or if your "TALKNVOTEWEBROOT/" is "/":

php /home/talknv/public_html/app/webroot/cron_talknvote.php

Calling directly the cron job page via browser is also possible using this URL (assuming that your website is http://www.example.com):

http://www.example.com/TALKNVOTEWEBROOT/app/webroot/cron_talknvote.php

For example if your "TALKNVOTEWEBROOT/" is "talknvote/" the above line should be as follows:

http://www.example.com/talknvote/app/webroot/cron_talknvote.php

or if your "TALKNVOTEWEBROOT/" is "/":

http://www.example.com/app/webroot/cron_talknvote.php


********** STEP 10 ***************
Have fun!

Top ↑

License

The MIT License

TalkNVote: Voting and Discussion System
Copyright (C) 2011, EUCog - European Network for the Advancement of Artificial Cognitive Systems, Interaction and Robotics | http://www.eucognition.org

Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the
Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.

Top ↑

Development Credits

TalkNVote was developed using the CakePHP framework

Top ↑