X-Git-Url: http://git.freeside.biz/gitweb/?a=blobdiff_plain;f=httemplate%2Fdocs%2Fselfservice.html;h=370704fe8c7e4b585a70fcbad023020b791f6be7;hb=4c80aee9030dc645c0e8e487ce496b9e35b06f91;hp=a4dc6aa782a0e048fec8c1a5fbb4c008d1279727;hpb=2041a9143fac20b79ead4a1ae01224dedf5b27c2;p=freeside.git
diff --git a/httemplate/docs/selfservice.html b/httemplate/docs/selfservice.html
index a4dc6aa78..370704fe8 100644
--- a/httemplate/docs/selfservice.html
+++ b/httemplate/docs/selfservice.html
@@ -14,21 +14,29 @@ machine, not the backend Freeside server. On the public machine, install:
Storable
Business-CreditCard
HTTP::BrowserDetect
+ HTML::Parser
FS::SelfService (copy the fs_selfservice/FS-SelfService directory to the external machine, then: perl Makefile.PL; make; make install)
- FS::SignupClient (copy the fs_signup/FS-SignupClient directory to the external machine, then: perl Makefile.PL; make; make install)
Then:
- Set the signup_server-default_agentnum configuration value to a default agent number.
- Set the signup_server-default_refnum to a default advertising source.
- Add the user `freeside' to the the external machine.
-
- Copy or symlink the
fs_signup/FS-SelfService/cgi/
directory into the web server's document space, for customer self-service and reseller access. Optionally, customize the .html templates.
- - Copy or symlink the
fs_signup/FS-SignupClient/cgi/
directory into the web server's document space, for signups. Optionally, customize the .html templates.
+ - Copy or symlink the
fs_selfservice/FS-SelfService/cgi/
directory into the web server's document space. Optionally, customize the .html templates. "Entry points" (useful places to link to) are:
+
+ - signup.cgi - Signup
+
- selfservice.cgi - Customer self-service
+
- agent.cgi - Reseller interface
+
- passwd.cgi - Simple password-changing interface
+
- promocode.html - Promotional code pre-signup
+
- regcode.html - Registration code pre-signup
+
- stateselect.html - State selection pre-signup
+
- When linking to signup.cgi, you can include a referring custnum in the URL as follows:
http://public.web.server/path/signup.cgi?ref=1542
- Enable CGI execution for files with the `.cgi' extension. (with Apache)
- Create the /usr/local/freeside directory on the external machine (owned by the freeside user).
-
- touch /usr/local/freeside/fs_signupd_socket; chown freeside /usr/local/freeside/fs_signupd_socket; chmod 600 /usr/local/freeside/fs_signupd_socket
+
- touch /usr/local/freeside/selfservice_socket; chown freeside /usr/local/freeside/selfservice_socket; chmod 600 /usr/local/freeside/selfservice_socket
- Use suEXEC or setuid (see install.html for details) to run signup.cgi, selfservice.cgi, agent.cgi and passwd.cgi as the freeside user.
- Append the identity.pub from the freeside user on your freeside machine to the authorized_keys file of the newly created freeside user on the external machine(s).
- Run an instance of
freeside-selfservice-server user machine agentnum refnum
on the Freeside machine for each external machine.
@@ -42,7 +50,7 @@ Then:
Optional:
- If you create a /usr/local/freeside/ieak.template file on the external machine, it will be sent to IE users with MIME type application/x-Internet-signup. This file will be processed with Text::Template with the variables listed below available.
- (an example file is included as fs_signup/ieak.template) See the section on internet settings files in the IEAK documentation for more information.
+ (an example file is included as fs_selfservice/FS-SelfService/ieak.template) See the section on internet settings files in the IEAK documentation for more information.
- Variable substitutions available in ieak.template and success.html: