=item pkgpart_hashref
Returns a hash reference. The keys of the hash are pkgparts. The value is
-true iff this agent may purchase the specified package definition. See
+true if this agent may purchase the specified package definition. See
L<FS::part_pkg>.
=cut
=head1 VERSION
-$Id: agent.pm,v 1.1 1999-08-04 09:03:53 ivan Exp $
+$Id: agent.pm,v 1.2 2000-12-03 13:45:15 ivan Exp $
=head1 BUGS
<body>
<h1>Administration</h1>
</body>
+<ul>
+ <li>Open up the root of the Freeside document tree in your web
+ browser. For example, if you created the Freeside document tree in
+ /home/httpd/html/freeside, and your web browser's DocumentRoot is
+ /home/httpd/html, open http://your_host/freeside/. Replace
+ "your_host" with the name or network address of your web server.
+
+ <li>Once in the Freeside web interface, you must first create a
+ service. An example of a service would be a dial-up account or a
+ hosted virtual domain.
+
+ <li>After you create your first service or services, you must then
+ create a package of that service or services which you will sell to
+ your customer. To allow flexibility in changing your service
+ offerings, Freeside requires that you bundle your services into a
+ package before customers may purchase them. For instance, you could
+ create a leased line package which would consist of a one-time
+ charge for the customer premise equipment, the monthly service fee
+ for the leased line, a backup dial-up account, and a support
+ contract. You could also create a leased line package which omits
+ the support contract simply by adding a new package that does not
+ include the support contract.
+
+ <li>After you create your first package, then you must define who is
+ able to sell that package by creating an agent type. An example of
+ an agent type would be an internal sales representitive which sells
+ regular and promotional packages, as opposed to an external sales
+ representitive which would only sell regular packages of services.
+
+ <li>After creating a new agent type, you must create an agent, and
+ assign the the agent type you just created to it.
+
+ <li>If the service you created was of type svc_acct, you may have to
+ create a POP from the main menu before you can create your first new
+ customer.
+
+ <li>If you are using Freeside to keep track of sales taxes, you must
+ define tax information for your locale by clicking on the "View/Edit
+ locales and tax rates" link on the Freeside main menu.
+
+ <li>Finally, you may optionally set up a referral by clicking on the
+ "View/Edit referrals" link in the Freeside main menu. Referrals
+ will help you keep track of how effective your advertising is, by
+ helping you keep track of where customers heard of your service
+ offerings. You must create at least one referral. If you do not wish to
+ use the referral functionality, simply create a single referral only.
+
+ <li>You should now be ready to sign up your first customer by
+ clicking on the "New Customer" link at the top of the Freeside main
+ menu.
+</ul>
+</body>
+</html>
<li><a name="apacheroot">apacheroot</a> - The directory containing Apache virtual hosts
<li><a name="apachemachine">apachemachine</a> - A machine with the apacheroot directory and user home directories. The existance of this file enables setup of virtual host directories, and, in conjunction with the `home' configuration file, symlinks into user home directories.
<li><a name="apachemachines">apachemachines</a> - Your Apache machines, one per line. This enables export of `/etc/apache/vhosts.conf', which can be included in your Apache configuration via the <a href="http://www.apache.org/docs/mod/core.html#include">Include</a> directive.
+ <li><a name="autocapnames">autocapnames</a> - The presence of this file will cause Freeside to use Javascript in /htdocs/edit/cust_main.cgi to automatically capitalize the first and last names of customers.
<li><a name="bindprimary">bindprimary</a> - Your BIND primary nameserver. This enables export of /var/named/named.conf and zone files into /var/named
<li><a name="bindsecondaries">bindsecondaries</a> - Your BIND secondary nameservers, one per line. This enables export of /var/named/named.conf
<li><a name="bsdshellmachines">bsdshellmachines</a> - Your BSD flavored shell (and mail) machines, one per line. This enables export of `/etc/passwd' and `/etc/master.passwd'.
<li><a href="upgrade5.html">Upgrading from 1.2.2 to 1.2.3</a>
<li><a href="upgrade6.html">Upgrading from 1.2.3 to 1.2.4</a>
<li><a href="config.html">Configuration files</a>
-<!--
<li><a href="admin.html">Administration</a>
-!-->
+<!--
<li><a href="../index.html#admin">Administration</a>
+!-->
<li><a href="legacy.html">Importing legacy data</a>
<li><a href="export.html">File exporting and remote setup</a>
<li><a href="passwd.html">fs_passwd</a>
<li>Create the `/usr/local/etc/freeside/counters.<i>datasrc</i>', and
`/usr/local/etc/freeside/export.<i>datasrc</i>' directories for each <i>datasrc</i> (owned by the freeside user).
<li>As the freeside user, run bin/fs-setup to create the database tables.
+ <li>Now proceed to the initial <a href="admin.html">administration</a> of your installation.
</ul>
</body>
#!/usr/bin/perl -Tw
#
-# $Id: cust_main.cgi,v 1.26 2000-06-27 12:15:50 ivan Exp $
+# $Id: cust_main.cgi,v 1.27 2000-12-03 13:45:15 ivan Exp $
#
# Usage: cust_main.cgi custnum
# http://server.name/path/cust_main.cgi?custnum
# fixed one missed day->daytime ivan@sisd.com 98-jul-13
#
# $Log: cust_main.cgi,v $
-# Revision 1.26 2000-06-27 12:15:50 ivan
+# Revision 1.27 2000-12-03 13:45:15 ivan
+# patch from Jason Spence <thalakan@frys.com>: admin.html doc, autocapgen
+#
+# Revision 1.26 2000/06/27 12:15:50 ivan
# i18n
#
# Revision 1.25 2000/03/02 08:09:38 ivan
print qq!<FONT SIZE="+1" COLOR="#ff0000">Error: !, $cgi->param('error'),
"</FONT>"
if $cgi->param('error');
-print qq!<FORM ACTION="${p1}process/cust_main.cgi" METHOD=POST>!,
+
+# JRS: Javascript to set up the form for us
+ if ( $conf->exists('autocapnames') ) {
+ print <<END;
+<SCRIPT language="Javascript"><!--
+
+function capName(name) {
+ var temp = new String();
+ var n = name.toString();
+
+// Handle "Mc", "Mac", "Von", "Van", etc...
+
+ if(n.substr(0,2).toLowerCase() == "mc") {
+ temp += "Mc";
+ temp += n.charAt(2).toUpperCase();
+ temp += n.substr(3).toLowerCase();
+ return temp;
+ }
+
+ if(n.substr(0,3).toLowerCase() == "mac") {
+ temp += "Mac";
+ temp += n.charAt(3).toUpperCase();
+ temp += n.substr(4).toLowerCase();
+ return temp;
+ }
+ if(n.substr(0,3).toLowerCase() == "von") {
+ temp += "Von";
+ temp += n.charAt(3).toUpperCase();
+ temp += n.substr(4).toLowerCase();
+ return temp;
+ }
+ if(n.substr(0,3).toLowerCase() == "van") {
+ temp += "Van";
+ temp += n.charAt(3).toUpperCase();
+ temp += n.substr(4).toLowerCase();
+ return temp;
+ }
+ temp += n.charAt(0).toUpperCase();
+ temp += n.substr(1).toLowerCase();
+ return temp;
+}
+
+//-->
+</SCRIPT>
+END
+}
+
+print qq!<FORM ACTION="${p1}process/cust_main.cgi" METHOD=POST NAME="form1">!,
qq!<INPUT TYPE="hidden" NAME="custnum" VALUE="$custnum">!,
qq!Customer # !, ( $custnum ? $custnum : " (NEW)" ),
);
print "<BR><BR>Contact information", &itable("#c0c0c0"), <<END;
-<TR><TH ALIGN="right">${r}Contact name<BR>(last, first)</TH><TD COLSPAN=3><INPUT TYPE="text" NAME="last" VALUE="$last">, <INPUT TYPE="text" NAME="first" VALUE="$first"></TD><TD ALIGN="right">SS#</TD><TD><INPUT TYPE="text" NAME="ss" VALUE="$ss" SIZE=11></TD></TR>
+<TR><TH ALIGN="right">${r}Contact name<BR>(last, first)</TH><TD COLSPAN=3>
+END
+
+if ( $conf->exists('autocapnames') ) {
+ print <<END;
+<INPUT TYPE="text" NAME="last" VALUE="$last" onChange="updateUsername();">,
+<INPUT TYPE="text" NAME="first" VALUE="$first" onChange="updateUsername();">
+END
+} else {
+ print <<END;
+<INPUT TYPE="text" NAME="last" VALUE="$last">,
+<INPUT TYPE="text" NAME="first" VALUE="$first">
+END
+}
+
+print <<END;
+</TD><TD ALIGN="right">SS#</TD><TD><INPUT TYPE="text" NAME="ss" VALUE="$ss" SIZE=11></TD></TR>
<TR><TD ALIGN="right">Company</TD><TD COLSPAN=5><INPUT TYPE="text" NAME="company" VALUE="$company" SIZE=70></TD></TR>
<TR><TH ALIGN="right">${r}Address</TH><TD COLSPAN=5><INPUT TYPE="text" NAME="address1" VALUE="$address1" SIZE=70></TD></TR>
<TR><TD ALIGN="right"> </TD><TD COLSPAN=5><INPUT TYPE="text" NAME="address2" VALUE="$address2" SIZE=70></TD></TR>