MetaboCalc v1.0, Copyright 2005, Kristina Pfaff-Harris (http://www.tesol.net/scriptmail.html) =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= Contents of this file: Program Summary Copyright & Licensing Information Legal Notice & Disclaimer Getting Started with MetaboCalc What to Do About Problems Other Scripts =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= Program Summary: MetaboCalc is a simple metabolism calculator that uses the Harris-Benedict equation to approximate a user's Basal Metabolic Rate/Resting Metabolic Rate and their calorie needs based on their lifestyle. It also calculates the Body Mass Index. You can configure it so that either Pounds/Inches or Kilograms/Centimeters is the default, and even change the spelling of Centimeters if you like. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= Licensing & Copyright Information: This program is copyright 2005 Kristina L. Pfaff-Harris. It may be used free of charge for commercial or non-commercial purposes as long as the package is not sold or distributed, and as long as the linkback is maintained as outlined in the License part of the script. You may use, modify, or otherwise play with this program as you wish providing that you do not redistribute it. Please don't distribute copies of this, but rather, refer potential users back to this site, since I would like people to be able to get the most recent version in case of bug fixes. Please see the License section of metabocalc.cgi for the terms of use. Credit to the author should be maintained wherever it appears in the script or the html pages. However, the credits may be in HTML comments so that they don't show up on your pages. For example: =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= Legal Notice & Disclaimer: This program is offered as-is and no warranty is given, either express or implied. By downloading, modifying, copying, viewing, or using this program, you agree that neither the author of this program nor the owners or administrators of the site from which you downloaded this program are liable for any breach of security, damage or loss caused directly or indirectly by the use of this program, and that any such breach, damage or loss is the sole responsibility of the person who downloads, modifies, copies, views, or uses this program. This program is distributed in the hopes it will be useful, but without any warranty or guarantee of fitness for a particular purpose. By using this program you agree to absolve the author of any and all liability for problems occurring as a result of using this program. The author has attempted to make this program as bug-free and secure as possible, but there is always the possibility of something being overlooked, hence the author disclaims any responsibility for problems incurred in the use of this program. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= Getting Started with MetaboCalc: IMPORTANT: DO NOT USE Dreamweaver or other HTML editor to make changes to the script. Please use a plain text editor. HTML editors often do not recognize Perl program code, and so make changes to it that breaks some scripts. :-) This assumes that you have permission to execute cgi programs on your server, and that you know where such programs have to go. Sometimes, a web server is set up so that all cgi programs must be in a single directory (usually /cgi-bin). If you don't know whether or not you have permission to do this, or if you don't know where the programs must go, ask your system administrator or the technical support team for your website. If you've never set up a CGI program before, you might want to check out "What should I ask my web hosting provider before setting up a CGI script" in the FAQ at: http://tesol.net/scripts/FAQ/ These instructions are focused towards Unix systems. If you have a Windows system, the directions may change slightly. Email the author if you have questions. All you need to do is the following: 1. Open up metabocalc.cgi in a plain text editor, such as vim, pico, Notepad, BBedit, or even Wordpad (just make sure to save it as plain text when you're done). 2. Make sure that the path to perl is correct and is on the *very* first line of the metabocalc.cgi program. (It should look like #!/usr/bin/perl or #!c:/bin/perl or #!/usr/local/bin/perl or something. The "#!" is important. Ask your web hosting provider what the path to Perl is if you're not sure, but actually, #!/usr/bin/perl (what the script comes with) usually works. 3. Within the program, you have some options to change the "look" of the results pages generated by the calculator. These are marked by **CHANGE** so that you can find them easily. If you don't understand HTML (the markup language web pages are written in), be careful trying to change these things. Make any changes according to the instructions in the script, and save metabocalc.cgi as plain text. 4. Upload metabocalc.cgi to the appropriate place for cgi programs on your website. (If you use FTP, make SURE you ftp it in ascii mode!) 5. Chmod metabocalc.cgi to 755. (world read/execute) If your server is a Windows-type system, you probably don't need this step. Once you've made these changes, that should be all you need to do. You should now be able to pull up http://your.web.site/where/the/script/is/metabocalc.cgi and enter data into the form. When you click the "Calculate" button, it should work! =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= What to Do About Problems: IMPORTANT: If you contact me with a problem about this program, you MUST give me as much information as possible or I honestly won't be able to help you! Please help me to help you by including at least the following information: The name of this program! (This is MetaboCalc v1.0.) The operating system of the web server where this program is running (e.g. Solaris, Ultrix, BSD, NT etc). NOT your personal computer's operating system. :) Your web server software (e.g. Apache, Netscape Commerce, IIS, etc) The error message you got (if any) and when you got it. The error message in the server log file. (ask your systems admin where the error logs are.) The location of your program (http:// etc) so I can look at it. PLEASE, I beg of you, do not email me and say something like "Your program doesn't work." I honestly need to know details about the problem you're having, or I cannot help you. =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= Other Scripts: If you like MetaboCalc, try RandomQuiz, QuizTest, VocabSearch and other scripts available at Kristina's Scripts for Educators: http://www.tesol.net/scripts/ CGI-Subscribe: An email mailing list manager Chat-N-Time: Real-time web-based chat CrosswordMaker: A tool to create and grade HTML crossword puzzles MailStuf: Simple CGI Email form and program MakeBook: A guestbook/ongoing story program. QAMaker: Create your own Frequently Asked Questions list Quadratic-O-Matic: A simple quadratic equation solver QuizTest: Offer multiple-choice/true-false quizzes RandomQuiz: Generates quizzes with randomly selected questions RemindMe: An email auto-reminder service SillySearch: Let people search for pages on your website SillyCount: Let's you create a web-page counter. SillySite: A simple web-page creation program SFEBlackjack: A simple online video Blackjack game SFEBMIcalc: A simple Body Mass Index Calculator SFEHangman: A simple online Hangman game SFEPoker: A simple online video Poker game SFESurvey: Online survey/quiz generator VeryInteresting: Loan Interest calculator and amortization table generator VocabSearch: Create and search a list of vocabulary words Votesie: Online voting booth/Poll generator Thanks for using MetaboCalc! =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=