##################################################################### # # # Copyright © 1999-2005 CGISCRIPT.NET - All Rights Reserved # # # ##################################################################### # # # THIS COPYRIGHT INFORMATION MUST REMAIN INTACT # # AND MAY NOT BE MODIFIED IN ANY WAY # # # ##################################################################### # # When you downloaded this script you agreed to accept the terms # of this Agreement. This Agreement is a legal contract, which # specifies the terms of the license and warranty limitation between # you and CGISCRIPT.NET. You should carefully read the following # terms and conditions before installing or using this software. # Unless you have a different license agreement obtained from # CGISCRIPT.NET, installation or use of this software indicates # your acceptance of the license and warranty limitation terms # contained in this Agreement. If you do not agree to the terms of this # Agreement, promptly delete and destroy all copies of the Software. # # Versions of the Software # Only one copy of the registered version of CGISCRIPT.NET # may used on one web site. # # License to Redistribute # Distributing the software and/or documentation with other products # (commercial or otherwise) or by other than electronic means without # CGISCRIPT.NET's prior written permission is forbidden. # All rights to the CGISCRIPT.NET software and documentation not expressly # granted under this Agreement are reserved to CGISCRIPT.NET. # # Disclaimer of Warranty # THIS SOFTWARE AND ACCOMPANYING DOCUMENTATION ARE PROVIDED "AS IS" AND # WITHOUT WARRANTIES AS TO PERFORMANCE OF MERCHANTABILITY OR ANY OTHER # WARRANTIES WHETHER EXPRESSED OR IMPLIED. BECAUSE OF THE VARIOUS HARDWARE # AND SOFTWARE ENVIRONMENTS INTO WHICH CGISCRIPT.NET MAY BE USED, NO WARRANTY # OF FITNESS FOR A PARTICULAR PURPOSE IS OFFERED. THE USER MUST ASSUME THE # ENTIRE RISK OF USING THIS PROGRAM. ANY LIABILITY OF CGISCRIPT.NET WILL BE # LIMITED EXCLUSIVELY TO PRODUCT REPLACEMENT OR REFUND OF PURCHASE PRICE. # IN NO CASE SHALL CGISCRIPT.NET BE LIABLE FOR ANY INCIDENTAL, SPECIAL OR # CONSEQUENTIAL DAMAGES OR LOSS, INCLUDING, WITHOUT LIMITATION, LOST PROFITS # OR THE INABILITY TO USE EQUIPMENT OR ACCESS DATA, WHETHER SUCH DAMAGES ARE # BASED UPON A BREACH OF EXPRESS OR IMPLIED WARRANTIES, BREACH OF CONTRACT, # NEGLIGENCE, STRICT TORT, OR ANY OTHER LEGAL THEORY. THIS IS TRUE EVEN IF # CGISCRIPT.NET IS ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN NO CASE WILL # CGISCRIPT.NET' LIABILITY EXCEED THE AMOUNT OF THE LICENSE FEE ACTUALLY PAID # BY LICENSEE TO CGISCRIPT.NET. ##################################################################### # # # Credits: # # Andy Angrick - Programmer # # Mike Barone - Design # # # # For information about this script or other scripts please see : # # http://www.cgiscript.net # # # # Thank you for trying out our script. # # If you have any suggestions or ideas for a new innovative script # # please direct them to contact@cgiscript.net. Thanks. # # # ##################################################################### Description: csPost easily allows you to add interactivity to your website by allowing visitors to post a comment or message. Requirements: 1. Perl 5.005 or higher. 2. A Web Server If your server meets the above requirements, then it is compatible with both unix and windows based web servers. INSTALLATION =============================================================================== Quick Installation Instructions: Note: if you are unable to run scripts outside your cgi-bin directory, follow the instructions listed below for cgi-bin installations. 1. Unzip the distribution file and open csPost.cgi with your favorite text editor. Find the section below and edit the following variables to match your server's configuration. ### SETUP VARIABLES ### $cgiurl='http://www.yourdomain.com/cgi-script/csPost'; ### Full URL to the csPost directory $cgipath='/home/user/public_html/cgi-script/csPost'; ### Full PATH to the csPost directory $imageurl='http://www.yourdomain.com/cgi-script/images'; ### Full URL to the images directory $datapath = $cgipath.'/data'; ### Full PATH to the data subdirectory. Usually there is no need to change this. $username='user'; $password='pass'; ### username and password to get into the management ### END SETUP VARIABLES ### 2. FTP all the files and directories to your server with the following structure: /cgi-script <-- cgiscript.net script directory /cgi-script/csPost <-- csPost directory /cgi-script/csPost/data <-- directory to store data. /cgi-script/csPost/images <-- images directory. *** FTP ALL FILES EXCEPT IMAGES IN ASCII MODE. csPost.cgi should be located at [root url]/cgi-script/csPost/csPost.cgi where [root url] is the URL to your website. Example: http://www.mycompany.com/cgi-script/csPost/csPost.cgi 3. Chmod csPost.cgi to executable (chmod 755) Ask your server administrator for assistance if required. 4. If your perl executable is not located at /usr/bin/perl, edit the first line of csPost.cgi to reflect the true location. Re-FTP csPost.cgi if you've made any changes. 5. Open csPost.cgi in your web server to enter the control panel. (example: http://www.yourdomain.com/cgi-script/csPost/csPost.cgi) CGI-BIN installation Instructions (skip if using quick install instructions): Due to the fact that most cgi-bin directories won't allow you to view normal files in them, you will need to place the images in a directory outside the cgi-bin directory. We suggest the following structure. /cgi-bin <-- your cgi-bin directory /cgi-bin/csPost <-- csPost directory /cgi-bin/csPost/data <-- directory to store data. /cgi-script/csPost/images <-- images directory. Notice this is outside your cgi-bin directory. 1. Edit the variables at the top of csPost.cgi to match your server's configuration, making sure you use the correct URL to the images directory. Your setup.cgi file might look something like ### SETUP VARIABLES ### $cgiurl='http://www.yourdomain.com/cgi-bin/csPost'; ### Full URL to the csPost directory $cgipath='/home/user/public_html/cgi-bin/csPost'; ### Full PATH to the csPost directory $imageurl='http://www.yourdomain.com/cgi-script/images'; ### Full URL to the images directory $datapath = $cgipath.'/data'; ### Full PATH to the data subdirectory. Usually there is no need to change this. $username='user'; $password='pass'; ### username and password to get into the management ### END SETUP VARIABLES ### 2. FTP all the files and directories to your server with the following structure as suggested above: /cgi-bin <-- cgiscript.net script directory /cgi-bin/csPost <-- csPost directory /cgi-bin/csPost/data <-- directory to store data. /cgi-script/csPost/images <-- images directory. *** FTP ALL FILES EXCEPT IMAGES IN ASCII MODE. csPost.cgi should be located at [root url]/cgi-bin/csPost/csPost.cgi where [root url] is the URL to your website. Example: http://www.mycompany.com/cgi-bin/csPost/csPost.cgi 3. Chmod csPost.cgi to executable (chmod 755) Ask your server administrator for assistance if required. 4. If your perl executable is not located at /usr/bin/perl, edit the first line of csPost.cgi to reflect the true location. Re-FTP csPost.cgi if you've made any changes. 5. Open csPost.cgi in your web server to enter the control panel. (example: http://www.yourdomain.com/cgi-bin/csPost/csPost.cgi) INSTRUCTIONS =============================================================================== 1. Enter the control panel by opening csPost.cgi with your web browser. Example: example: http://www.yourdomain.com/cgi-script/csPost/csPost.cgi 2. Log in with the username and password you configured in the variables at the top of csPost.cgi 3. Click the 'Links Wizard' button and grab the code for any of the 3 different methods to display the postings. The easiest is to use the javascript display code. The server side include code will need to be on an *.shtml page and the php code would need to be on an *.php page. Copy and paste the code onto your HTML page wherever you want the postings to appear. 4. You can click the 'Preview' button to see how your current postings look. 5. Although you can't edit a posting, it can be deleted by checking the box next to the posting and then click the 'delete selected postings' link. TEMPLATES =============================================================================== You can edit all the t_*.htm pages to your linking. The t_post_listing.htm template controls the appearance of the postings on your site. On that page you will see in(post_name) in(post_date)
in(posting)
You must keep and exactly as it appears on the page. However, you can edit the html code in between those tags. That is what controls the appears of the individual postings and that section is repeated for each individual post. in(post_name) will be replace by the posting's name in(post_date) will be replaced by the posting's date in(posting) will be replaced by the posting's message -------- If you have any comments, questions, concerns or new script ideas go to http://www.cgiscript.net and submit Contact Form. Installation is available. This is only one of many cool scripts we have, check out http://www.cgiscript.net