home *** CD-ROM | disk | FTP | other *** search
/ Big Green CD 8 / BGCD_8_Dev.iso / NEXTSTEP / UNIX / Connectivity / PPP / Docs / NeXTPPP_HTML / websale / README < prev    next >
Encoding:
Text File  |  1997-09-18  |  6.3 KB  |  130 lines
  1. HOW TO BUILD A FIRST VIRTUAL-ENABLED MEMBERSHIP FORM
  2.  
  3. This package is intended to make it very easy to install a
  4. First-Virtual-enabled web page for selling memberships to an
  5. organization or for collecting donations.
  6.  
  7. PREREQUISITES: To use this package, you must know how to browse a web
  8. page given its URL, how to install an executable file in such a way
  9. that browsing a URL causes it to be invoked via CGI, and you must have
  10. access to a C compiler and a MAKE program and several UNIX utilities
  11. for the configuration process. You must also have a First Virtual
  12. seller's PIN and an email address. Your Internet Service Provider
  13. can help you with problems in this area. HELPFUL: Knowledge of how to
  14. write HTML, understanding of C and the compilation process, a
  15. MIME-capable email client, and for high-volume sellers, understanding
  16. of the First Virtual protocols sufficient to allow automation of the
  17. matching of various email messages for accounting purposes.
  18.  
  19. To install this package, you will need a HTTPD server that supports CGI.
  20. This package creates an executable from the HTML files you edit here
  21. and allows you to install it where you'd like.
  22.  
  23. Once installed, users will be able to browse the script and get back a
  24. form to be filled in. Submitting the form will cause its contents (in
  25. nicely readable and machine-parsable format) to be mailed to an email
  26. address of your choice. In addition, if they fill in their First
  27. Virtual Buyer's PIN (and optionally check off a price, if there is more
  28. than one), a charge will be placed to their PIN and you will
  29. receive a copy of the transfer-request and eventually the
  30. transfer-result.
  31.  
  32. On most systems, all you should have to do is type "make".  You will
  33. be asked about ten questions, and then the script will build a program
  34. ("member") for you.  If you install the member program in your cgi-bin
  35. directory (or basically anywhere that your server will execute it),
  36. the web page will be all set to process your membership applications!
  37. It will also be fairly easy to edit the embedded HTML files if you
  38. need to make any textual changes.
  39.  
  40. One of the options is the price to be charged. You may select either a
  41. single flat amount or a one-of-many list. For example, you may have
  42. different prices for students, professionals, and corporations. If
  43. there is only one price, a bill will be submitted to First Virtual
  44. only if the user fills in a valid First Virtual PIN. If
  45. multiple prices are available, the user also has to choose one. You
  46. can set the default price as well.
  47.  
  48. If you do feel the need to fine-tune the web pages, be careful not to
  49. break things by inadvertently altering the content-type line, the
  50. blank line after it, or otherwise altering the structural parts of the
  51. web form. Also, do not change the names of the fields "FVPIN" or
  52. "price". After changing the web forms, simply run "make" again to
  53. incorporate your changes into the code, then copy the executable back
  54. into your cgi-bin directory. (During the "make", the HTML files are
  55. encoded into the body of the program as string constants.) DO NOT
  56. CHANGE "ACTIONPROG" IN THE HTML FILES.  It's supposed to be there, and
  57. is dynamically changed to point to wherever you install the member
  58. executable if your web server is properly configured.
  59.  
  60. If you need to add new fields to the things returned by the form, you
  61. need only edit membership.html (after the first time you build) and
  62. run "make" again. The program will automatically pick up any fields
  63. whose names start with "QS_" and include them in email to you.  There
  64. is also an option to add fields during the initial configuration.
  65.  
  66. In addition to the QS_ fields, the program will also include in the
  67. email the transfer-ID (which will allow you to correlate the form data
  68. with the payments) and the URL used to access the script (in case you
  69. have more than one form going to the same email address).
  70.  
  71. CHANGING THINGS AFTER IT IS RUNNING:
  72.  
  73. All you need to do is edit the *.html files, then run make again, then
  74. copy the member program to the appropriate place. If you wish to
  75. change where the email goes, how much it costs, and so on, simply edit
  76. config.h (not config.x and not fields.h), run make, and copy the
  77. executable.
  78.  
  79.  
  80. DETAILS OF INSTALLATION:
  81.  
  82. Unpack the tar file into an empty directory. Run "make". Answer any
  83. questions it asks, and fix makefile options and such as appropriate to
  84. your system. Copy the "member" executable into your cgi-bin directory,
  85. then point your browser at the URL. You should get a reasonable
  86. form. Filling out the form should cause you to get email at the
  87. address you gave during the initial "make".
  88.  
  89. To modify what the forms look like, go back to your "member"
  90. directory, edit one or more of the .html files there. Be sure not to
  91. change the headers or other structural information.  Additional fields
  92. whose NAME= starts with QS_ will be included in the email generated by
  93. the "member" program without any additional effort on your part beyond
  94. adding them to the HTML.
  95.  
  96. NOTE: First, the HTML files are included in the member executable as
  97. static strings. Once "member" is built, the executable program is all
  98. you need. If you point your browser at the HTML files themselves, it
  99. won't work. If you run "member" from the command line, it won't
  100. work. You must invoke "member" via CGI for it to work.
  101.  
  102. NOTE: Do not change the ACTIONPROG string in the form. The member
  103. program uses this to fill in its own URL whenever it is run. (That's
  104. why you can't call it from the command line.)
  105.  
  106. Questions should be directed to support@fv.com.  Thank you!
  107.  
  108.  
  109.   -- Darren New
  110.      Director of Custom Software Design
  111.      First Virtual Holdings Inc
  112.      dnew@fv.com
  113.   -- Thanks to Nathaniel Borenstein for most of the "configure" program
  114.  
  115.  
  116. Copyright (c) 1994,1996 FIRST VIRTUAL HOLDINGS INCORPORATED
  117. FIRST VIRTUAL (TM) and the FIRST VIRTUAL logo are service marks
  118. of First Virtual Holdings Incorporated.
  119.  
  120. Permission to use, copy, modify, and distribute this material 
  121. for any purpose and without fee is hereby granted, provided 
  122. that the above copyright notice and this permission notice 
  123. appear in all copies, and that the name of First Virtual not be 
  124. used in advertising or publicity pertaining to this 
  125. material without the specific, prior written permission 
  126. of First Virtual Holdings Incorporated.  FIRST VIRTUAL
  127. MAKES NO REPRESENTATIONS ABOUT THE ACCURACY OR SUITABILITY 
  128. OF THIS MATERIAL FOR ANY PURPOSE.  IT IS PROVIDED "AS IS", 
  129. WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES.
  130.