EZSWFHIT - easy shockwave counter maker, by manny juan 9/13/2001 EZSWFHIT INSTALLATION INSTRUCTIONS ---------------------------------- ASSUMPTIONS your home base directory is path= /home/htdocs/your.isp.com/website URL= http://www.isp.com/website your cgi url is: URL= http://www.isp.com/website/cgi-bin you want to store the shockwave counters in a subdirectory called 'swfcount'. note: each shockwave counter will be a subdirectory beneath 'swfcount'. then you should do the following: SETUP 1. create the subdirectory 'swfcount' under the home base directory and chmod to 777 2. unzip ezswfhit into this directory (keep directory structure) you should have a language directory created under 'swfcount' (this directory contains the various languages that the shockwave counter can display) INDEX.HTML 1. supply correct URL for the logo (ie. IMG SRC=http://www.isp.com/website/swfcount/mjmall.jpg) 2. supply correct URL for the cgi script. for example:
3. do above two more times for the 'edit shockwave counter' and 'delete shockwave counter' buttons. 4. keep the line in the page. DO NOT REMOVE! 5. chmod to 777 DATA.TXT (list of users) 1. (initially empty) 2. install in subdirectory 'swfcount' and chmod to 777 MJMALL.JPG - keep in 'swfcount', logo for ez shockwave counter maker SHCOUNTER_MULTI.FLA SHCOUNTER_MULTI.SWF 1. these are (probably) Flash and Shockwave files (generated by Seungho Choo) to support multiple counters using only one script. 2. keep this in 'swfcount' directory SWFLP_EN.PL (english language pack) 1. this file is "required" (ie. included) by EZSWFHIT to interface with the user in english 2. install in cgi-bin and set permissions to readable SWFLP_NO.PL (norway language pack) 1. this file is "required" (ie. included) by EZSWFHIT to interface with the user in norwegian 2. install in cgi-bin and set permissions to readable EZSWFHIT.PL (easy shockwave counter maker script) (you might have to change the extension to .cgi depending on your server) 1. make sure first line of script points to location of perl program #!/usr/bin/perl 2. this script was originally written in english (ie. the prompts, instructions and panels are written in english) hence the 'require' statement brings in the english 'language pack' (a norwegian language pack, 'swflp_no.pl' is also available) require "swflp_en.pl"; if you wish to translate ezswfhit to another language, please read translation notes below 3. if your server can handle file-locking (most unix servers can, some win95 servers might not), set this to 1 $flock=1; 4. supply value of $cgiurl (URL of the directory where cgi scripts reside) $cgiurl = "http://www.isp.com/website/cgi-bin"; 5. supply the full path to the directory where the shockwave counters will reside $basedir = "/home/htdocs/your.isp.com/website/swfcount"; 6. what is the complete path of the index list of shockwave counters? (not normally changed) $indexpage = "$basedir/index.html"; 7. what is the complete path of the user list? (see note below) $data = "$basedir/data.txt"; 8. where is your email program $sendmail = '/usr/sbin/sendmail'; 9. your email - email-id of the person giving this service - (duh, you!) (use apostrophe not quote) $myemail = 'email@isp.com'; 10. the script is pre-installed with a default language of 'english'. if you want to change this, edit ezswfhit in the newpage subroutine and change $langid to one of these italian,swedish,norwegian,dutch,portuguese,french,spanish,german,english,korean 11. install this script in cgi-bin and chmod to 755 SHCOUNTER_MULTI.CGI (various housekeeping routines) 1. make sure first line of script points to location of perl program #!/usr/bin/perl 2. supply the full path to the directory where the shockwave counters will reside $basedir = "/home/htdocs/your.isp.com/website/swfcount"; 3. install this script in cgi-bin and chmod to 755 HOW TO ADD NEW LANGUAGE 1. if you wish to add a new language to ezswfhit, copy the template from /language/english and supply the translations for all variables (except eof). do NOT delete the ampersand symbols before and after each variable assignment 2. edit etswfhit in subroutine build_form_body and add an entry for the new language &put_opt($langid,'Venusian','venusian'); TRANSLATION NOTES: ----------------- the original EZSWFHIT script was written in english for users of the english language. however, John (malmklang) Slettjord of Team Opelwerk , from Norway extracted all the variable text strings and collected them into an english 'language pack' and also modified the scripts to refer to this pack. this made it a simpler task for him to translate the script to norwegian. he simply translated the values in the english language pack to norwegian! and you can make your own translation, too! if you do create a new language pack, please send it to me, if you don't mind doing so. CREDITS ------- NOTE: the original script was written by Seungho Choo and can be downloaded from tangible.new21.org (http://tangible.new21.org). Seungho was kind enough to send me an updated version of the script which can handle multiple users and multiple languages. this is the version present in the zipped file. (this counter was suggested to me by andreas knop ) thank you. ---------- manny@jps.net http://mannyjuan.com 9/13/2001