// +----------------------------------------------------------------------+ // | OpenConf | // +----------------------------------------------------------------------+ // | Copyright (c) 2002-2006 Zakon Group LLC. All Rights Reserved. | // +----------------------------------------------------------------------+ // | This source file is subject to the OpenConf license, that is bundled | // | with this package in the file LICENSE, and is available at: | // | http://www.zakongroup.com/technology/openconf-license.shtml | // +----------------------------------------------------------------------+ =============== Install Notes =============== 0. Pre-Install: - Install HTTP Server, PHP, MySQL - Download OpenConf - Read (& agree to) License 1. Extract OpenConf archive inside Web (HTTP) document root directory Windows: - Double-click openconf.zip file Linux: % cd HTTP_DOCUMENT_ROOT % tar xpzf openconf.tgz # If you use the p flag with the tar command, or are on a Windows # platform, you should be able to skip #2 2. Ensure write privileges by Web server to: config.php config-status.php db.php papers/ templates/*.txt (optional - allows template mods to be saved) 3a. Web install: Browse to http:///openconf/openconf.php and Skip to the ==== Optional ==== section below OR 3b. Manual install: Create database and load schema % cd openconf % mysqladmin create openconf % mysql openconf < DB.sql # Note: Additional command params may be needed for db username and password 4. Edit db.php # Set database name, host, username, password 5. Edit config.php # Set variables as needed; at a minimum we suggest: OC_confNameFull OC_confName OC_pcemail OC_confirmmail OC_confURL OC_keycode_reviewer OC_keycode_program # Change value of $OC_installComplete to 1 # Running multiple instances of OpenConf? See note under ETC 6. Connect via a Web client to http:///openconf/ The default chair login is: username: chair password: openconf Don't forget to set the list of topics (under Chair's Settings) before opening submissions or committee sign-up. ========== OPTIONAL ========== * Edit review/signup_reviewer.html and review/signup_program.html These files are included at the top of their respective sign up pages * Edit review/guidelines.php This file is linked to from the Reviewer page * Edit review/reviewer_info.html This file is included at the bottom of the Reviewer page * Edit templates/*.txt These are the email template files (see Chair->Email for variable options) ===== ETC ===== * OpenConf was developed using Apache. If you are using another HTTP server, you may need to modify the papers/.htaccess and templates/.htaccess files, or move their directories elsewhere (and change their respecitive variables in config.php). * If you are uncomfortable having a file (db.php) with the database password inside the Web document space, you can move it elsewhere and simply modify the $OC_dbPath variable in config.php. * Tested with PHP 4.3.x/5.x, MySQL 3.23/4.x, Apache 1.3.x * Your PHP configuration should have E_NOTICE disabled for the display_errors directive. This is the default for a PHP installation. * Email is handled through PHP's mail() function. If email is not being received, check and test your PHP settings. * OpenConf does not limit the size of papers that may be uploaded; PHP however does. You will need to modify PHP's max file and form upload settings if you want to support larger files being uploaded; do not forget to restart the HTTP server when you update PHP setting. Alternatively, a Perl CGI script for handling large paper (re)uploads is also included; you will need to set the value of config.php:$OC_useUploadCGI to TRUE, edit the path to Perl atop author/upload.cgi, and set upload.cgi file permissions to 755. * If you are running multiple instances of OpenConf, you should ensure the value of $OC_sessionVarName in config.php is different for each.