DOCUMENTATION - UNIX and NT README 01/15/2001 Suscribe Me 2.036.01E - Enterprise Edition by CGI Script Center (support@cgiscriptcenter.com) http://www.cgiscriptcenter.com http://support.cgiscriptcenter.com ========================================================== ! KNOWN ISSUES ! Subscribers using: Microsoft Outlook (Exchange Server edition for Macs) (version 8.2.2) Lotus Notes (below version 5.0) May not be able to properly read e-mails sent in both HTML and TEXT formats. This is due to proprietary formatting of the e-mails and an inability to convert a multipart/alternative MIME e-mail properly. Lotus users can find this information at: http://support.lotus.com/sims2.nsf/eb5fbc0ab175cf0885256560005206cf/c023dc440eeb0c418525699d0066438b?OpenDocument&ExpandSection=1,5,4,3,2&Highlight=0,multipart While we are attempting to find a functional workaround, the only real solution is to upgrade to the latest versions of each e-mail client. ========================================================== ! IMPORTANT UPGRADE INFORMATION ! ========================================================== If you are upgrading from a previous version of Subscribe Me Professional - Enterprise Edition, or any previous versions of Subscribe Me Professional, PLEASE BE SURE TO READ THE COMPLETE UPGRADE INSTRUCTIONS! We recommend that you take the follow steps before upgrading: 1) Read all of the changes that have taken place in the progressive release versions between your existing version and version 2.036.01E (found below). ========================================================== Original Release Date: 2.0 - 05/21/2000 ========================================================== End Users License Agreement # Copyright 1999 Diran Alemshah. All Rights Reserved. # # LICENSOR'S PROGRAM IS COPYRIGHTED AND LICENSED (NOT SOLE). # LICENSOR DOES NOT SELL OR TRANSFER TITLE TO THE LICENSED # PROGRAM TO YOU. YOUR LICENSE OF THE LICENSED PROGRAM WILL # NOT COMMENCE UNTIL YOU HAVE EXECUTED THIS AGREEMENT AND AN # AUTHORIZED REPRESENTATIVE OF LICENSOR HAS RECEIVED, APPROVED, # AND EXECUTED A COPY OF IT AS EXECUTED BY YOU. # 1. License Grant. Licensor hereby grants to you, and you # accept, a nonexclusive license to use the downloaded computer # programs, object code form only (collectively referred to as # the "Software"), and any accompanying User Documentation, # only as authorized in this License Agreement. The Software may be # used on any website owned by Licensee, or if Licensee is a company # or corporation, any website owned by Licensee company or corporation. # You agree that you will not assign, sublicense, transfer, pledge, # lease, rent, or share your rights under this License Agreement. # You agree that you may not reverse assemble, reverse compile, or # otherwise translate the Software

Upon loading the Software # into your computer, you may make a copy of the Software for # backup purposes. You may make one copy of any User's Manual # provided for backup purposes. Any such copies of the Software # or the User's Manual shall include Licensor's copyright and other # proprietary notices. Except as authorized under this paragraph, # no copies of the Program or any portions thereof may be made by # you or any person under your authority or control. # 2. License Fees. The license fees paid by you are paid # in consideration of the licenses granted under this License # Agreement. You are solely responsible for payment of any taxes # (including sales or use taxes, intangible taxes, and property taxes) # resulting from your acceptance of this license and your possession # and use of the Licensed Program, exclusive of taxes based on # Licensor's income. Licensor reserves the right to have you # pay any such taxes as they fall due to Licensor for remittance to # the appropriate authority. You agree to hold harmless Licensor # from all claims and liability arising from your failure to report # or pay such taxes. # 3. This License Agreement is effective upon your submission of this form. # 4. Limited Warranty. Licensor warrants, for your benefit alone, # that the Licensed Program conforms in all material respects to # the specifications for the current version of the Licensed Program. # This warranty is expressly conditioned on your observance of the # operating, security, and data-control procedures set forth in the # User's Manual included with the Licensed Program. # # EXCEPT AS EXPRESSLY SET FORTH IN THIS AGREEMENT, LICENSOR # DISCLAIMS ANY AND ALL PROMISES, REPRESENTATIONS, AND WARRANTIES # WITH RESPECT TO THE LICENSED PROGRAM, INCLUDING ITS CONDITION, # ITS CONFORMITY TO ANY REPRESENTATION OR DESCRIPTION, THE EXISTENCE # OF ANY LATENT OR PATENT DEFECTS, ANY NEGLIGENCE, AND ITS # MERCHANTABILITY OR FITNESS FOR A PARTICULAR USE. # 5. Limitation of Liability. Licensor's cumulative liability # to you or any other party for any loss or damages resulting # from any claims, demands, or actions arising out of or relating # to this Agreement shall not exceed the license fee paid to Licensor # for the use of the Program. In no event shall Licensor be liable # for any indirect, incidental, consequential, special, or exemplary # damages or lost profits, even if Licensor has been advised of the # possibility of such damages. # 6. Proprietary Protection. Licensor shall have sole and exclusive # ownership of all right, title, and interest in and to the Licensed # Program and all modifications and enhancements thereof (including # ownership of all trade secrets and copyrights pertaining thereto), # subject only to the rights and privileges expressly granted to you # herein by Licensor. This Agreement does not provide you with title # or ownership of the Licensed Program, but only a right of limited # use. You must keep the Licensed Program free and clear of all claims, # liens, and encumbrances. # 7. Restrictions. You may not use, copy, modify, or distribute the # Licensed Program (electronically or otherwise), or any copy, # adaptation, transcription, or merged portion thereof, except as # expressly authorized by Licensor. You may not reverse assemble, # reverse compile, or otherwise translate the Licensed Program. # Your rights may not be transferred, leased, assigned, or sublicensed # except for a transfer of the Licensed Program in its entirety to # (1) a successor in interest of your entire business who assumes # the obligations of this Agreement or (2) any other party who is # reasonably acceptable to Licensor, enters into a substitute # version of this Agreement, and pays an administrative fee intended # to cover attendant costs. No service bureau work, multiple-user # license, or time-sharing arrangement is permitted, except as # expressly authorized by Licensor. If you use, copy, or modify # the Licensed Program or if you transfer possession of any copy, # adaptation, transcription, or merged portion of the Licensed # Program to any other party in any way not expressly authorized # by Licensor, your license is automatically terminated. # 8. Licensor's Right Of Entry. You hereby authorize Licensor # to enter your premises in order to inspect the Licensed Program # in any reasonable manner during regular business hours to verify # your compliance with the terms hereof. # 9. Injunctive Relief. You acknowledge that, in the event # of your breach of any of the foregoing provisions, Licensor # will not have an adequate remedy in money or damages. Licensor # shall therefore be entitled to obtain an injunction against such # breach from any court of competent jurisdiction immediately upon # request. Licensor's right to obtain injunctive relief shall not # limit its right to seek further remedies. # 10. Trademark. COMMISSION CART(TM), ACCOUNT MANAGER(TM), PICLINK # ADVERTISER(TM), BANDWIDTH PROTECTOR(TM), PC CONFIGURATOR(TM), # Subscribe Me(TM) Professional # are all trademarks of Licensor. No right, license, or interest # to such trademark is granted hereunder, and you agree that no # such right, license, or interest shall be asserted by you with # respect to such trademark. # 11. Governing Law. This License Agreement shall be construed # and governed in accordance with the laws of the State of California, # USA. # 12. Costs of Litigation. If any action is brought by either party # to this License Agreement against the other party regarding the # subject matter hereof, the prevailing party shall be entitled # to recover, in addition to any other relief granted, reasonable # attorney fees and expenses of litigation. # 13. Severability. Should any term of this License Agreement be # declared void or unenforceable by any court of competent # jurisdiction, such declaration shall have no effect on the # remaining terms hereof. # 14. No Waiver. The failure of either party to enforce any # rights granted hereunder or to take action against the other # party in the event of any breach hereunder shall not be deemed # a waiver by that party as to subsequent enforcement of rights # or subsequent actions in the event of future breaches. # 15. Integration. THIS AGREEMENT IS THE COMPLETE AND EXCLUSIVE # STATEMENT OF LICENSOR'S OBLIGATIONS AND RESPONSIBILITIES TO YOU # AND SUPERSEDES ANY OTHER PROPOSAL, REPRESENTATION, OR OTHER # COMMUNICATION BY OR ON BEHALF OF LICENSOR RELATING TO THE # SUBJECT MATTER HEREOF ========================================================== ========================================================== Updates: Released 05/21/2000 The Enterprise Edition has several powerful capabilities: 1) Multiple List subscription and unsubscription, using checkboxs for multiple lists. This enables your subscribers to check all of the lists they would like to be subscribed to all at once, rather than signing up for each list individually. They may also unsubscribe the same way, if you choose to give them that option. 2) Batch Removal. Using the Batch Removal system, you can remove all the bad/bouncing addresses from your list at one time, rather than individually. This should save considerable time on larger lists. 3) Invitations. Subscribe Me Professional EE offers a unique system not found in any other mailing list managers, we call "Invitations". Using our Invitation system, the administrator can buy, borrow, lease, etc, a mailing list from another source. The adminstrator can add those addresses at mailing time through the mailing interface. Those additional addresses will be sent a copy of your mailing, along with an invitation, of your writing, offering these new people the ability to join your list by clicking on a link provided. If they do not click the subscription list, their address will not be added to your list. If they do, they are added to your list as if they came to your site and joined your list. We call it "Proactive Listbuilding". It pushes the boundries of Listbuilding, but we feel it keeps within the best nature of Internet marketing. We think you will agree once you've tried it. If upgrading from a previous version of Subscribe Me Professional, YOU WILL NEED TO MAKE SOME MINOR MODIFICATIONS to your Response Screens, as explained at: http://www.subscribemepro.com/upgrade/smproee.shtml Please be sure to follow the instructions for the modifications, as we will not be responsible for problems that occur due to not reading and implementing the changes. Version 2.01 06/13/2000 1) Thanks to one of our Enterprise users, we were alerted to the fact that problems were occuring when having over nine (9) mailing lists created, and allowing subscribers to subscribe to them. This problem will affect ALL Subscribe Me Enterprise users that have created (deleted mailing lists count) over nine (9) mailing lists. We strongly recommend upgrading to version 2.01 at your earliest convenience. 2) Version 2.01 adds its own unique News and Information section on the main Administration login screen. Enterprise users will now have their own Update and Information pages. Version 2.01 is now available and does fix this problem. Upgrade instructions are available at: http://www.subscribemepro.com/upgrade/smproee201.shtml Please be sure to follow the instructions for the modifications, as we will not be responsible for problems that occur due to not reading and implementing the changes. Version 2.02 06/20/2000 1) Added the ability to ban addresses and domains. By adding any full e-mail address, such as: anyaddress@domain.com the particular address will be banned from joining the particular list that you banned it from. If you choose to ban the entire domain, simply add: domain.com or *@domain.com Either will work. The Address Banning link is found in the "Details" area of any mailing address that you've created. Version 2.03 06/26/2000 1) Bug found in the "Invitations" feature of Subscribe Me Enterprise. Users were seeing multiple invitations on each mailing. Fixed - version 2.03 2) Added a dividing text line between the invitations and the actual mailing 3) Removed the Unsubscribe link for those that were sent an invitation to join, as they are not listed and therefore can not unsubscribe. No special upgrade instructions for version 2.03. Just upload your script files (as shown in the basic installation instructions) and install by pressing the "Install/Update" button on your /setup.pl script page. If you see Version 2.03, your installation was successful. 06/28/2000 - Version 2.031 1) Added the ability to send your Mass Mailings out in "Batch" format. Internet Service Providers have literally hundreds, if not thousands, of customers on each of their web servers. Each web server has a finite amount of resources. Every customer on that server must compete with other customers for the available "shared" resources. Sending out a mass mailing to a large list of users can tie up all available resources for a long period of time, which makes Internet Service Providers unhappy... not to mention the rest of the customers on that server. The solution is supplying a method for you to send out your mass mailings in groups of (you supply the number) per (you supply the time interval). Example: Send to 500 addresses every 15 minutes. If your list is say 10,000 addresses long, your first "batch" of 500 will go out. Once that batch is completed, the program will wait 15 minutes and send out the second batch, exactly 15 minutes later, and so on until the mailing is complete. The only drawback to this method is that it can become time consuming to send out your mailings. If you prefer not to use the "Batch" method on large lists, your host may request or require you to use a "dedicated" mail server, which I'm sure they will be happy to provide you with for an additional fee (sarcasm intented). 08/07/2000 - Version 2.032 1) We've found two instances of File Locking problems, which we've fixed in version 2.032. File Locking ensures that no other instance of the program can access your list database at the same time, helping to keep your list from experiencing any corruption (loss of addresses). Be sure to make regular back-ups of your lists, using the List Backup feature of Subscribe Me Professional. 12/13/2000 - Version 2.033E 1) By popular request, we've upgraded both Subscribe Me Professional and Enterprise to "Batch Add" addresses without stopping the administrator when bad or duplicate addresses were found on the additional addresses. This means that Batch Add's will be seamless, without additional work on the part of the administrator. 2) Your e-mail headers will now include your Company Name before your administrators e-mail address. Many users have been asking for this, as some servers will block mailings without names before the address, as potential spam. This upgrade addresses this problem. Upgrade instructions are simple. Just upload the script files, and press the "Install/Update" button on your /setup.pl script interface. Be sure your administration panel says "Version 2.033E" when you are through upgrading. 01/15/2001 - Version 2.034E Beta 1 This release marks a change in the way Subscribe Me's core systems work. Until now, each time a subscriber requested to be removed from a Subscribe Me mailing list, their e-mail address was removed from the list at the time of request. This is fine for smaller lists with a moderate amount of simultaneous REMOVE requests, however, larger lists of 75,000+ with a large number of simultaneous REMOVE requests has produced some data loss in some cases. This is caused by the actual mailing list having to be rewritten each time an address is removed from the list. Smaller lists can be rewritten quickly, however, larger lists can take several seconds in some cases. Coupled with hundreds if not thousands simultaneous instant REMOVE requests, larger lists could possibly become corrupted. Subscribe Me Professional and Enterprise now offer the ability to add each REMOVE request to a temporary REMOVE list, which will be removed by the program all at once just prior to your next mailing. This means that your primary mailing list is not modified for unsubscription requests more than once, and just prior to your next mailing. Upgrade instructions are simple. Just upload the script files, and press the "Install/Update" button on your /setup.pl script interface. Be sure your administration panel says "Version 2.033E" when you are through upgrading. 03/04/2001 - Version 2.034E Beta 2 When trying to resubscribe to a list that a subscriber recently removed themselves from, they were unable to resubscribe until after the next mailing was sent and the temporary REMOVE list was cleared. Version Beta 2 now allows subscribers to resubscribe, by removing them from the temporary REMOVE list. Added a way for the list administrator to send a test mailing to the administrator's e-mail address first, so that the administrator may see if the e-mailing is properly formatted, prior to sending it to the entire list. Beta 2 not publicly released. 06/01/2001 - Version 2.034E Beta 3 Several bug fixes to Beta 2. 1) Added the Bounce Removal information to the program, for use with the Bounce Removal system, upon its release. Information regarding Bounce Removal will soon be available at: BounceRemoval.com (not available as of this writing). 2) Obfuscated the script code, for the security of our script code. The obfuscated version installs just as the previous versions. a) Make sure the setup.pl file has the correct path to Perl on your server. b) Upload all the files over your existing script files. c) Press "Install/Update" on your setup.pl installation panel. Beta 3 not publicly released. 06/10/2001 - Version 2.034E Beta 4 1) Discovered a bug in the "BATCH ADD" feature, used to import addresses to an already existing mailing list. During import, addresses imported are passed through a cleaning process, to make sure that the imported addresses are free of any characters that are not intended to be used in an e-mail address. We found two characters that were being screened in the "List Import" filtering process but were not screened in the "BATCH ADD" filtering process. We've updated the BATCH ADD filtering process. 06/10/2001 - Version 2.035E Beta 1 Many customers have some subscribers who's e-mail reading programs can only read TEXT, while the rest can read HTML. In the past, choosing to send HTML mailings to your subscribers meant you would always receive 3 to 5% complaints from those who's e-mail readers could not parse the HTML mailings, thus giving the subscriber a mailing they could not read. This lead to a decline in subscribers, albeit a small one. Now you can send 1 mailing, with two parts. Your SEND MAIL form page will now have two large mailing windows, one for HTML and the other for TEXT mailings. Choose to create one or both, HTML and/or TEXT mailings to send your subscribers. If you create both an HTML and a TEXT mailing to send your subscribers, Subscribe Me will be able to deliver to your subscribers a version that their e-mail reading program can properly parse and read. This way, TEXT-ONLY e-mail readers will receive and properly open the TEXT mailing portion, and none of the HTML version of the mailing will be seen by that particular subscriber, while subscribers with HTML-capable e-mail readers will receive and open the HTML formatted message you send. 06/22/2001 - Version 2.035E Beta 2 1) Goof. Sent out the wrong files for Beta 1, which were the defective files. Renamed the working files as Beta 2. Mass Mailings and Sign Up e-mails weren't being properly formatted because of it. 2) Found that we were calling the "totalsubscribers" subroutine twice in the administration panel. Some people with large lists were seeing long wait times to access their administration panel because of it. Fixed. 3) MIME content header was causing the Subscribe and Unsubscribe links to become unusable. Headers were modified. 06/22/2001 - Version 2.035E Beta 3 1) Thanks to Mike Clark of TheMag FS News (http://www.themag-fs-news.co.uk), we discovered that if you send an HTML mailing and DO NOT include the "Powered by Subscribe Me" links, the mailing is sent malformed. We were missing two carriage returns. Fixed. 06/25/2001 - Version 2.035E Beta 4 1) Appears that some UNIX servers using Sendmail had some incompatibilities with the existing mailing routines. Modifications were made and tested. Fixed. 06/27/2001 - Version 2.035E Beta 5 1) The Mass Mail routine for NT/Win2000 servers needed modification to the new mailing system. Fixed. 07/02/2001 - Version 2.035E Beta 6 1) NT/Sockets version of MIME needed modification for some servers. Modification made. Fixed. 07/23/2001 - Version 2.035E Beta 7 1) Individually control the SERVER NAME that will appear on each list. Some customers have hosting accounts which allow them to run more than one Domain Name on their account. Some wanted to just use their IP address rather than the Domain Name for the Subscribe and Unsubscribe links. Previously, Subscribe Me queried the web server for the server's Domain Name each time. Subscribe Me still queries the server for that information, however, the list administrator may now modify that information, if he/she sees fit to do so. 09/19/2001 - Version 2.035E Beta 8 1) Users upgrading from previous versions of Subscribe Me were seeing a Zero in the URL's of the Subscribe and Unsubscribe links, like so: http://0/cgi-bin/subpro/s.pl This was caused by the upgrade, as existing lists need to have the "UPDATE LIST" button pressed on the "EDIT" section of that list. This is due to the request to have the URL editable for Subscribe and Unsubscribe, for servers that don't provide the correct URL for the server, or for those wishing to use IP addresses instead. The Zero was caused by a database input field which does not update unless someone manually updates this field. This is a security precaution. We've fixed this issue by using the URL provided by the server, unless the administrator updates the list manually to change that URL. 10/05/2001 - Version 2.035E Beta 9 2.035E Beta 8 fixed the link issues for signup/remove emails, however the mass mailings still had the Zero (0) problem in the unsubscribe links. Oversight on our part. Fixed in version 2.035E Beta 9. Again, this issue only affects those upgrading from a previous versions, and with existing lists. 10/31/2001 - Version 2.035E Beta 10 Added < > to the TO and FROM addresses SMTP mailing routines, to work with ESMTP mail servers. NT/Win2000 servers were having a problem with the BATCH mailing process. This was caused by the obfuscation process, which improperly modified some of the BATCH mailing code. Beta 10 fixes this. 11/13/2001 - Version 2.035E Beta 11 Added a routine to the mass mailings which first removes all duplicate addresses from the list. Although Subscribe Me does not allow duplicate addresses to be added to the list, if a subscriber presses the "SUBMIT" button multiple times during their signup, it is possible for an address to be added more than once during that signup process. 12/01/2001 - Version 2.035E Beta 12 Added the ability to edit the Headers and Footers to the administration panel, to offer more easy integration of the Subscribe Me administration panel with your website. Added the capability to edit the headers and footers of the list response screens, seen by subscribers. 12/10/2001 - Version 2.035E Beta 13 Skipped for superstitious reasons. ;) 12/10/2001 - Version 2.035E Beta 14 Added the capability to accept e-mail addresses from the domain .info or any other future domain with up to four letters. 12/10/2001 - Version 2.035E Beta 15 Edit made to version Beta 9 (affecting users of Beta 9-14) made the URL tracking feature error. Beta 15 not only fixes these errrors, but also imporves the tracking functionality by allowing the administrator to set not only the directory and filename but also the domain name. This will allow the administrator to track links to pages on domains other than the domain of the program. Previous versions required tracking to be done by using the following code: page=/directory/pagename.html as of Beta 15, administrators can (and must) set the domain as well, with the following code: page=/domainname.com/directory/pagename.html No "http://" is required in the domain name. If the site you are directing subscribers to requires a "www" in the domain name, be sure to type it as so: page=/www.domainname.com/directory/pagename.html Complete usage is explained at: http://www.cgiscriptcenter.com/subscribe/install/trackmailings-new.shtm 12/11/2001 - Version 2.035E Beta 16 One of the changes made to version Beta 15 made it impossible to use graphics in your HTML mailings. Beta 16 fixes this error. 12/12/2001 - Versoin 2.035E Beta 17 NT/Windows2000 and other Win server users were seeing very long load times for the administration panels, due to the way Windows servers use their resources while counting the number of subscribers. As such, we've disabled the Total Lists and Total Subscribers headers from each administration panel. This should bring down the total server resources used by both Windows and UNIX server users. 12/19/2001 - Versoin 2.035E Beta 18 1) An unusual problem found occuring on only one customer site, but we thought it important enough to address with a workaround to fix the problem. One customer site reported seeing the unsubscribe links changing from: http://?r=1&l=&e= to: http://?r=1&l=&e= where the & ampersand sybol is being changed to the ascii value of &. While this is perfectly normal for an HTML web page, this is not properly read by a Perl program. Therefore, we've made sure that anytime the ascii value of & is entered in a response field, and UPDATE LIST is pressed, Subscribe Me will change the & to &. This will ensure that no unsubscribe link ampersands (&) will ever be modified to the ascii value (&) by a users HTML editing program, which is what we suspect happened in this customer's case. 12/23/2001 - Versoin 2.035E Beta 19 The "unsubscribe" sub-routine was reading in the mailing list file twice when checking to see if the address is on the list. Although this caused no problem for the function of the program, it did use up twice the amount of memory (RAM) than necessary. This caused problems on lists that had subscribers of 100,000+. Fixed. 12/27/2001 - Versoin 2.035E Beta 20 The Administration Headers and Footers were not showing up in the configuration panel when having to reinstall or upgrade the program. The problem was forcing the administrator to have to re-edit the Administration Headers and Footers each time a modification was made. This version fixes this problem. Javascript errors experienced on installation routine when attempting to use the context-sensitive help menus. This error is only seen prior to installation or upgrade to the modifiable header versions of the program. This upgrade fixes this problem. 01/09/2002 - Version 2.036E Subscribe Me 2.035E taken out of Beta. Released as 2.036E. NT installations were not able to properly use the "Send to Administrator" test mailing feature. Fixed in this release. Additional file locking added to ensure that the mailing lists are not corrupted under heavy use. 01/14/2002 - Version 2.036.01E Extented the time limit on file locking from 5 seconds to 30 seconds. Some customers were seeing the "Multiple Submissions" error screen more often than necessary. The extention of the time limit on file locking will keep this from happening unless a file is locked for more than 30 seconds. Full upgrade instructions for non-Beta release upgrades found at: http://www.subscribemepro.com/upgrade ========================================================== Description: Introducing Subscribe Me Professional - Enterprise Edition 2.0. Designed to assist with the building, maintaining, mailing, and tracking of your customer/prospect mailing lists! ========================================================== Features: * Completely run from a browser. No text files to edit. * Edit configurations from your Administration panel. * Unlimited Mailing Lists * Mail-back confirmation to subscriber of mailing list subscription and removal. * Mail-back confirmation to Administrator of mailing list subscription and removal, option to the Administrator. * List Importer for importing existing mailing lists. * Customize the mailing responses that each list receives. * Sophisticated "User Management" system which protects your Admin from unauthorized access. * Include automatic Add or Remove links in each e-mail, so users can add/remove themselves easily. * Effectiveness Tracking - unique to Subscribe Me Pro. Tracks all "clicks" from links placed in your mailings. Used to keep track of which mailings are/were effective and which are/were not. * Works on both UNIX and NT machines that are properly configured to run CGI programs! Yes, including IIs! * Mail your mailings using either Sendmail, BLAT, or Sockets! (See program requirements) * NO MAILING TIMEOUTS, EVER! Even on NT web servers! (See program requirements) * View the contents of every mailing list! See every e-mail address subscribed to your mailing lists. * Subscribe Me Professional even gives you the code to place in your website for each mailing list! * Version and News updates provided every time you log into your Administration panel! (See program requirements) * Just added! Double Opt In Sign-Up option. This lets the list administrator choose to have their subscribers not only sign up but also confirm their addition prior to their e-mail address being added to the list! No more bouncing e-mails or unhappy subscribers! Version 2.034 Adds: * HTML E-mail! Offer the power of HTML in your e-mails. Create fully interactive web page advertisements/mailings that capture your subscribers' attention. (Sendmail and Sockets mail only) * Editable HTML Responses! Modify the response screens that your customers will receive when they subscribe, unsubscribe, or receive an error. * Double-Opt Out option. Designed to ensure that the person UNsubscribing from your list is actually the e-mail address owner, not your business competitor. * Copy and Paste multiple addresses at once, using the new Batch Address Addition feature, while still ensuring your addresses are in valid format, and not duplicated in your existing list! Enterprise Edition 2.0 adds: * Multiple List concurrent subscription * Multiple List concurrent unsubscription * Batch Address removal * Invitations address additions ============================================================ ============================================================ Program Requirements - 1) Web server account that has CGI capabilities 2) Perl 5 installed on that web server. Contact your server administrator if you are unsure. 3) Access to either Sendmail, BLAT, or Sockets mail. No mail can be sent without at least ONE of the above. 4) If you are using either BLAT or Sockets mail (NT users usually), you will also need access to an SMTP mail server. Contact your server administrator to find out if you do. 5) To receive program update information, your web browser software must be Javascript capable and enabled. Most come standard as such. ============================================================ ============================================================ Installation - UNIX (NT Installation below) ** NOTE: IF UPGRADING FROM VERSION 2.033a OR PREVIOUS VERSIONS, ** ** PLEASE BE SURE TO FOLLOW THE UPGRADE TUTORIAL FOUND AT: ** ** http://www.subscribemepro.com/upgrade ** ** If installing on a Best.com/Best.net account, please see ** ** the Manual Installation information below! ** 1) Upload a) setup.pl b) subscribe_eng.pl c) unixmail_eng.pl to a CGI capable directory. Name the directory anything you like. As an example, we'll use "smpro". 2) Set the permissions on SMPRO directory to 755 (some servers require up to 777 to make CGI programs run). 3) Make sure that all the files have the proper extension that your web server requires (.pl or .cgi). 4) Make sure the path to Perl 5 in your setup.pl file is correct: #!/usr/bin/perl is the default address that most servers use. Contact your server administrator if you are unsure of the path. 6) Set 755 (or 777 if your server requires it) permissions on the setup.cgi file. 7) Next, run the setup.cgi file from the browser. The rest of your setup is done completely from the browser. If you would like the Subscribe Me logo to appear in the top left corner, upload the included sub3.gif into the /graphics directory, created by Subscribe Me Professional, once you've completed your installation. That's it! ============================================================ ============================================================ Installation - NT (UNIX Installation above) ** NOTE: IF UPGRADING FROM VERSION 2.033a OR PREVIOUS VERSIONS, ** ** PLEASE BE SURE TO FOLLOW THE UPGRADE TUTORIAL FOUND AT: ** ** http://www.subscribemepro.com/upgrade ** ** If installing on a Best.com/Best.net account, please see ** ** the Manual Installation information below! ** 1) Upload a) setup.pl b) subscribe_eng.pl c) ntmail_eng.pl d) blatmail_eng (Even if you are only using Sockets mail) to a CGI capable directory. Name the directory anything you like. As an example, we'll use "smpro". 2) Set the permissions on SMPRO directory to READ/WRITE/EXECUTE (99% of NT servers require the server administrator to set permissions. Contact your server administrator if you are unsure). 3) Make sure that all the files have the proper extension that your web server requires (.pl or .cgi) Most NT servers use .pl, but contact your server administrator if you are unsure. 4) Make sure the path to Perl 5 in your setup.pl file is correct: #!c:/perl/bin/perl.exe is the default address that most servers use. Contact your server administrator if you are unsure of the path. 6) Set EXECUTE permissions on the setup.pl file. Most NT servers require that the server administrator set permissions. Contact your server administrator if you are unsure. 7) Next, run the setup.pl file from the browser. The rest of your setup is done completely from the browser. You may have to have your server administrator set READ/WRITE permissions on the directories that Subscribe Me Pro creates for you, in your SMPRO directory. If you would like the Subscribe Me logo to appear in the top left corner, upload the included sub3.gif into the /graphics directory, created by Subscribe Me Professional, once you've completed your installation. Thats it! ============================================================ Manual Installations ============================================================ We've, so far, only found 1 server that will not allow Subscribe Me Professional's self-installer to do its job for you. That's Best.com/Best.net servers. If you are installing Subscribe Me Professional on a Best.com/Best.net web server, you will need to install your program manually (sorry, we tried to make it simple, but some hosts just won't let us). Directories to create: /sm This is your CGI directory. Permission it 755. If you are using Best.com/Best.net, permission it at 710. Next, we need to create your data directories. These are the directories that your Subscribe Me program will write your data files to. For security purposes, its best to place your data directory *outside* your server's web root. That means that they won't be avaiable to snooping eyes trying to locate your subscriber addresses. Only your Subscribe Me program will have access to them. If you are unsure if you have access to a data directory that isn't accessible from the web, contact your host to find out, as only they would know. Create a directory called "s" (or whatever you choose to name it). /s <-- Permissioned at 644 to 766, depending on your server's settings. If you are on Best.com/Best.net, set this directory to 730. Inside the /s directory, create the following directories: (these directory names must NOT be changed!) /info /pass /maildir /tempdir /trackdir /maildir /lists Permission the directories at 644 to 766, depending on your server's settings. If you are on Best.com/Best.net, set this directory to 730. Once you've done this, you have no more directories to create or permission. Next, create a text file called config.pl (or config.cgi if your server requires .cgi extensions). Inside this file, copy and paste the following information: #! /usr/bin/perl5 # Full directory path to Perl 5 on your webserver. $perlpath = "/usr/bin/perl"; # Full directory paths to the following directories $passfile = "/full/directory/path/to/s/pass"; $memberinfo = "/full/directory/path/to/s/info"; $trackdir = "/full/directory/path/to/s/trackdir"; $tempdir = "/full/directory/path/to/s/tempdir"; $maildir = "/full/directory/path/to/s/maildir"; $lists = "/full/directory/path/to/s/lists"; $graphics = "/full/directory/path/to/s/graphics"; # Place the path to your Mail Program. If you are using Sendmail # place the path to Sendmail here. If you are using BlAT, place # the directory path to BLAT here. Contact your host if you are unsure # of the paths. $mailprog = "/usr/bin/sendmail"; # To "lock" your data files while being written to, keep the default # setting of "2" below. If you are on a Windows95/98 web server, you # may have to remove the "2" as Windows95/98 doesn't allow "File Locking". # Such as: $LOCK_EX = ""; # WE RECOMMEND LEAVING THE DEFAULT SETTINGS $LOCK_EX = "2"; # Place your site URL path here $websiteurl = "http://www.airtreks.com"; # If you are on a UNIX machine, place "unix" between the quotes. # If you are on an NT machine, place "nt" between the quotes. $os = "unix"; # If you are using Sendmail, place "sendmail" between the quotes. # If you are using Sockets mail, place "sockets" between the quotes. # If you are using BLAT mail, place "blat" between the quotes. # We recommend anyone considering using BLAT mail to use Sockets instead. $mailusing = "sendmail"; # If you are using Sockets mail, place the URL path to your SMTP mail server here. # Contact your host for the correct URL, if you are unsure. $smtp_addr = "mail.yourserver.com"; # Place the full directory path to your CGI directory here. This is the directory # that your CGI scripts are kept in. $cgipath = "/full/directory/path/to/sm"; # Place the full directory path to your Data directory here. This is the directory # that your data files are stored/written to. $information = "/full/directory/path/to/s"; # If your server requires .pl extensions, place .pl between the quotes. # If your server reqiures .cgi extensions, place .cgi between the quotes. $extension = "pl"; # If you wish to receive notification of new signups and removals, leave the # default setting of "ON" between the quotes. # If you choose not to receive notifications of signups and removals, place # the word "OFF" between the quotes below. $notification = "ON"; # Here you can set the amount of time that your "Session Management" password # will stay active. The time is measured in seconds, so 1800 seconds equals # 30 minutes. $config_session = "1800"; # This setting will not matter if you have installed this manually. No change # is necessary here. $permissions = "0755"; # Do not change this line $ready = "1"; # Do not change this line 1; # The end of your configuration file - Do not change this line Once you've copied and pasted the above to your config.pl (or config.cgi) file, you can then modify the settings as needed. Then, save the file and upload it to your /sm (your CGI script) directory. Give it the same permission settings as your other CGI script files, permissioned at 644 to 766, depending on your server's settings. If you are on Best.com/Best.net, set this directory to 730. Lastly, rename: subscribe_eng.pl --> s.pl unixmail_eng.pl --> unix_mail.pl Once you've renamed the two files, open each in a text editor and add the following lines to the top of each file, respectively: #! /usr/bin/perl require "/full/directory/path/to/your/config.pl"; require "/full/directory/path/to/your/unix_mail.pl"; The above gets pasted to your s.pl file. #! /usr/bin/perl require "/full/directory/path/to/your/config.pl"; The above gets pasted to your unix_mail.pl file. Save both files and upload them to your CGI script directory, along with your config.pl file. Give it the same permission settings as your other CGI script files, permissioned at 644 to 766, depending on your server's settings. If you are on Best.com/Best.net, set this directory to 730. Once you've done the above, you are ready to go! Call the /s.pl file from your web browser. If you've done your installation correctly, you should be asked to set your administration password. If you get stuck, feel free to contact our Technical Support team for help. Our Support information is below. ============================================================ Support Look for the little ? (question mark) links throughout the program. Click on them for context sensitive help. http://support.cgiscriptcenter.com or use your Username and Password to enter our Registered Users Area (link available on our main web page) to access our Subscribe Me Professional support site. If you lose/forget your Username and/or Password, you can retrieve them at: http://www.cgiscriptcenter.com/registered/index.html ============================================================ We appreciate your feedback at: support@cgiscriptcenter.com CGI Script Center Team http://www.cgiscriptcenter.com