/* phpTodo - Web based todo lists *}
{* Copyright (C) 2005-07 Jason Frisvold <friz@godshell.com> *}
{* *}
{* This program is free software; you can redistribute it and/or modify *}
{* it under the terms of the GNU General Public License as published by *}
{* the Free Software Foundation; either version 2 of the License, or *}
{* (at your option) any later version. *}
{* *}
{* This program is distributed in the hope that it will be useful, *}
{* but WITHOUT ANY WARRANTY; without even the implied warranty of *}
{* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *}
{* GNU General Public License for more details. *}
{* *}
{* You should have received a copy of the GNU General Public License *}
{* along with this program; if not, write to the Free Software *}
{* Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA */
/* $Id: INSTALL,v 1.10 2007/03/06 17:58:03 xen0phage Exp $ */
Installation Instructions
Before beginning, please be sure that you have a working web server.
You also need PHP and MySQL installed.
If you need help with installation, have general questions, or need
help troubleshooting, please check the phpTodo website for support
information. http://www.sourceforge.net/projects/phptodo
** Installing in Linux **
Uncompress the archive into a web-accessible directory
[friz@dev friz]$ cd /var/www/html
[friz@dev html]$ tar zxvf phpTodo-{ver}.tar.gz
I recommend creating a link to the distro
[friz@dev html]$ ln -s phpTodo-{ver} phpTodo
[friz@dev html]$ cd phpTodo
Copy sample_config.php to config.php and edit accordingly. The sample
config file is littered with comments explaining each option.
[friz@dev phpTodo]$ cp sample_config.php config.php
Smarty is a requirement to make this program run. So, you have
2 options. If you already have Smarty installed, update the config.php
file with the correct location of the Smarty.class.php file
$phpTodo_smarty_dir = '/usr/share/Smarty/libs';
If you don't have smarty installed, download the latest version from
http://smarty.php.net Uncompress the distro somewhere outside of the web
directory and then update config.php as described above. The Smarty website
has more detailed instructions regarding installation.
If this is a first time install, create the MySQL Database
* The database creation script creates a username and password for accessing
the database. If this is unacceptable, edit the script first.
[friz@dev phpTodo]$ mysqladmin -uroot -p create phpTodo
[friz@dev phpTodo]$ mysql -uroot -p phpTodo < doc/sql/todo.sql
If you are upgrading from a previous version, check doc/sql for a MySQL
update script. Apply this script to the database.
*** BACK UP YOUR DATA BEFORE UPGRADING!!! ***
[friz@dev phpTodo]$ mysql -uroot -p phpTodo < doc/sql/phpTodo-{old}-{new}-update.sql
The installation is now complete! The default username and password
is admin/password. You can change this when you login for the first
time.
** Windows Installation **
Installing on a windows machine should be similar to the above process. I'm
told that phpTodo works fine in a Windows environment, but I don't have one
handy for testing. If you experience problems installing the software under
Windows, please check the phpTodo website for support options.
** Selenium Notes **
If you installing this on a production machine, I suggest deleting the selenium
directory. I did not write selenium and the scripts in that directory are
intended for development testing *ONLY*...
If you are using the scripts for testing, they are intended to be run against
a fresh install. Please delete all data in the database before running them.
Selenium can be downloaded from http://www.openqa.org/selenium Please refer to
the on-line documentation located at the openqa site for installation and usage
instructions.
