The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
JGORMAN / DBIx-CodeKit-1.07 / doc / ck_setup_perl.html 
<html>
<head>
<title>CodeKit Perl Source Code Setup</title>
<link rel="STYLESHEET" type="text/css" href="main.css">
</head>

<!--
  Copyright (C) 2003 John Gorman <jgorman@webbysoft.com>
  http://www.webbysoft.com/codekit
-->

<body bgcolor="#F0FFFF" text="#000000"
      link="#873852" vlink="#873852" alink="#B52E2E">

<center>
<table width="600">
<tr>
<td>


<div align="right">
[<a href="ck_setup_php.html">PHP Setup</a>]
[<a href="index.html">Index</a>]
[<a href="ck_admin.html">Code Administration</a>]
</div>


<center><h2>
<a href="http://www.webbysoft.com/codekit">CodeKit</a>
Perl Source Code Setup</h2></center>

Read the <a href="ck_overview.html">Overview</a> and the
<a href="ck_schema.html">Code Table Setup</a> pages first.

<p>
The CodeKit Perl source code is in the perl directory:

<pre>
    CodeKit.pm        - CodeKit module definition.
    ck_admin.pl       - Setup for ck_admin_main.pl.
    ck_admin_main.pl  - CodeKit Translation Utility.
    ck_connect.pl     - Database connection setup.
    ck_demo.pl        - CodeKit Demo page.
    regression.test   - Regression test.
    Makefile.PL       - Makefile setup.
</pre>

CodeKit.pm requires the DBI.pm module.  The Translation
Utility and the Demo page need the CGI.pm module.

<h4>1. Database Schema and Core Record Loading</h4>

Read and follow directions for
<a href="ck_schema.html">Code Table Setup</a>.

<p>
Load and test the ck_code table schema definition as well
as the core data records.  If you want to run the demo
load the demo data records as well.


<h4>2. Database Connection Setup</h4>

Customize the ck_connect.pl file to open
a database handle to your database.  If your application
setup has already opened a database handle, use that
handle instead of opening a new one.  The handle
should be set up to autocommit.

<p>
ck_connect.pl is used by ck_admin.pl, ck_demo.pl
and by regression.test.


<h4>3. CodeKit.pm Installation</h4>

Copy the CodeKit.pm file into a directory on your Perl
include path.  Or do the makefile thing:

<pre>
    $ perl Makefile.PL
    $ make
    $ make test
    # make install
</pre>

<p>
Run regression.test on the basic BabelKit class functions.
This will fail unless you have completed the above steps!


<h4>4. CodeKit Administration Page Setup</h4>

You may wish to customize the ck_admin.pl file to your situation:

<ul>
<li>
Require and open a <a href="ck_new_perl.html">CodeKit handle</a>.
</li>
<li>
Set the $perm_add, $perm_upd and $perm_del global variables.
These let the user add, update and delete codes.
</li>
<li>
Define the cka_sess_url() function.  Customize this if
you are carrying session identifiers in your urls.
</li>
<li>
Require ck_admin_main.pl and call the cka_admin_main() function.
</li>
</ul>

It is fine to make multiple copies of ck_admin.pl
to set up different permissions for different classes
of users.


<h4>5. Demo Page Setup</h4>

In order for the demo page to function, you will need
to load the <a href="ck_schema.html#demodata">demo data records</a>.


<p>
<div align="right">
[<a href="ck_setup_php.html">PHP Setup</a>]
[<a href="index.html">Index</a>]
[<a href="ck_admin.html">Code Administration</a>]
</div>


</td>
</tr>
</table>
</center>

</body>
</html>