You are here

Please support the sustainable development of CK-ERP / 请支持时机商计的可持续发展 / Apoye por favor el desarrollo sostenible de CK-ERP
捐助 EUR8.00
捐助 US$10.00
TUTORIAL on typical CK-ERP Work Flow
捐助 AUD$10.00
捐助 CAD$10.00

Installation







INSTALLATION MANUAL
(applicable to CK-ERP 0.30.1 - for earlier releases, please refer to the file, /ck-admin/doc/Installation Manual.html , embedded within CK-ERP's distribution tarball)

General Description :

CK-ERP is an open source accounting / educational / MRP / ERP / CRM system written in php and operates above multiple middlewares. It runs as a web application with Apache and supported middleware serving as middle layer. Internal data is managed by PostgresSQL/MySQL/SQLite. Database server can either be local or remote. Client access is via web browsers, Firefox, Konqueror, Opera and the like.

Functionally, it is divided into 32 modules:
Contact Management, Customer Relationship Management, Customer Self Service, Vendor Relationship Management, Material Requirement Planning, Warehouse, Inventory, Service, Accounting Ledger, Bank Reconciliation, Accounts Payable, Accounts Receivable, Purchase Order, Sales Order, Quotation, POS for Cashier, POS for Manager, Human Resources, Staff Self Service, Payroll, Administration, Internationalization, Access Control, Data Import, Teacher, Counsellor, Student, Applicant, Family, Registrar, Edu Administration, Volunteer Management.

Each of these modules can be made visible or hidden from users/groups utilizing eGroupWare's native account management function.

Most transactions are provided with standard search, add, view, copy, edit, delete and view log facilities. Journal reversing feature is included. Two separate streams are provided to handle invoices, POs, SOs, Quotations and Cash Sale that do and do not carry transactional tax (sales tax or VAT). For detail features, please refer to the Features List (Docs).

Supported MiddleWares:

Category MiddleWares Typical User of (MiddleWare+CK-ERP)
[::SPECIFIC INDUStrY::]
Online Ticketing FusionTicket Ticketing Agent
Sport Club/League phpMySport Club/League Manager
Restaurant MyHandyRestaurant,PSCafePOS Restaurant, Cafe
Reservation php-residence, phpScheduleIT Resort, Hotel Operator
Job Site / Job Board OpenCATS Recruitment agency, Job site operator
Online Advertisement OpenX Advertising agency, Online Ad publisher
Classified Advertisement Open-Realty, LandShop, FladsClassified Real Estate Agent, Classified Ad operator
Hardware Repair/Maintenance IRM Hardware Repair/Maintenance Vendor
Legal Service LegalCase Lawyer
Medical Service ClearHealth, OpenEMR, Care2X Doctor, Dentist, Medical Practitioner, Hospital
Shopping Cart Zencart, osCommerce Online Retailer
Auction Site WebAuction Online Retailer
Online Education Moodle, ATutor, OpenConference, OpenJournal,OpenBiblio elearning Institute
Online Album Coppermine, Gallery Online Album Operator
[::FUNCTIONAL PLATFORM::]
GroupWare eGroupWare, Horde-GroupWare, WebCalendar Project Manager, Group Moderator
CMS Drupal, Joomla, Mambo, e107, XOOPS, Xaraya Business with Web Presence
CRM vTiger Sales Oriented Business
Blog WordPress, b2evolution Blogger
Wiki TikiWiki Project Manager, Group Moderator
Forum phpBB Forum Operator
Asset Management AssetMan Asset Manager

Information Website:
http://ck-erp.org
http://ck-erp.net
http://ck-erp.info

Latest Version:
The latest version is available from,
http://sourceforge.net/projects/ck-erp
http://gforge.oss.org.cn/projects/ck-erp
http://gf.cs.hit.edu.cn/projects/ck-erp
http://gforge.lupaworld.com/projects/ck-erp
http://gro.clinux.org/projects/ck-ledger

Platforms :
CK-ERP has been tested against the following configurations (LAMP + Supported MiddleWare),

MiddleWare OS/Server Platform Web Server / Database / PHP Config
PSCafePOS 2.0.5 MagicLinux 2.5 + xampp 1.7.3a Apache 2.2.14 / Mysql 5.1.41 / PHP 5.3.1
OpenBiblio 0.6.1 Kubuntu 10.04 Apache 2.2.14 / Mysql 5.1.41 / PHP 5.3.2
IRM 1.6-b3 OpenRays 2.0 + xampp 1.6.8a Apache 2.2.9 / Mysql 5.0.67 / PHP 5.2.6
LegalCase 0.7.3 MagicLinux 2.5 + xampp 1.7.3a Apache 2.2.14 / Mysql 5.1.41 / PHP 5.3.1
ClearHealth 2.3 OpenRays 2.0 + xampp 1.6.8a Apache 2.2.9 / Mysql 5.0.67 / PHP 5.2.6
OpenEMR 3.2 Kubuntu 10.04 Apache 2.2.14 / Mysql 5.1.41 / PHP 5.3.2
eGroupWare 1.6.003-2 Fedora 13 Apache 2.2.15 / Pgsql 8.4.3 / PHP 5.3.2
Zencart 1.3.9c Kubuntu 10.04 Apache 2.2.14 / Mysql 5.1.41 / PHP 5.3.2
Joomla 1.5.17 RedFlag 7 + xampp 1.7.3a Apache 2.2.14 / Mysql 5.1.41 / PHP 5.3.1
Drupal 6.17 Fedora 13 Apache 2.2.15 / Pgsql 8.4.3 / PHP 5.3.2
Moodle 1.9.8+ Fedora 13 Apache 2.2.15 / Pgsql 8.4.3 / PHP 5.3.2
vTiger 5.1.0 Kubuntu 10.04 Apache 2.2.14 / Mysql 5.1.41 / PHP 5.3.2
phpBB 3.0.7 RedFlag 7 + xampp 1.7.3a Apache 2.2.14 / Sqlite 2.8.17 / PHP 5.3.1
TikiWiki 4.2 OpenSUSE 11.2 Apache 2.2.13 / Mysql 5.1.36 / PHP 5.3.0
WordPress 2.9.2 OpenSUSE 11.2 Apache 2.2.13 / Mysql 5.1.36 / PHP 5.3.0
Xaraya 2.0 RedFlag 7 + xampp 1.7.3a Apache 2.2.14 / Sqlite 2.8.17 / PHP 5.3.1
ATutor 1.6.4 RedFlag 7 + xampp 1.7.3a Apache 2.2.14 / Sqlite 2.8.17 / PHP 5.3.1
b2evolution 3.3.3 MagicLinux 2.5 + xampp 1.7.3a Apache 2.2.14 / Mysql 5.1.41 / PHP 5.3.1
e107 0.7.21 Kubuntu 10.04 Apache 2.2.14 / Mysql 5.1.41 / PHP 5.3.2
Horde-GroupWare 1.2.6 RedFlag 7 + xampp 1.6.8a Apache 2.2.9 / Mysql 5.0.67 / PHP 5.2.6
Mambo 4.6.5 OpenRays 2.0 + xampp 1.6.8a Apache 2.2.9 / Mysql 5.0.67 / PHP 5.2.6
XOOPS 2.4.4 RedFlag 7 + xampp 1.7.3a Apache 2.2.14 / Mysql 5.1.41 / PHP 5.3.1
osCommerce 2.2rc2a OpenRays 2.0 + xampp 1.6.8a Apache 2.2.9 / Mysql 5.0.67 / PHP 5.2.6
OpenX 2.8.5 Kubuntu 10.04 Apache 2.2.14 / Mysql 5.1.41 / PHP 5.3.2
LandShop 0.9.2 Kubuntu 10.04 Apache 2.2.14 / Mysql 5.1.41 / PHP 5.3.2
MyHandyRestaurant 0.8.5 OpenRays 2.0 + xampp 1.6.8a Apache 2.2.9 / Mysql 5.0.67 / PHP 5.2.6
phpMySport 1.4 Kubuntu 10.04 Apache 2.2.14 / Mysql 5.1.41 / PHP 5.3.2
AssetMan 2.5b MagicLinux 2.5 + xampp 1.7.3a Apache 2.2.14 / Mysql 5.1.41 / PHP 5.3.1
CopperMine 1.5.4 OpenSUSE 11.2 Apache 2.2.13 / Mysql 5.1.36 / PHP 5.3.0
Gallery 2.3 Fedora 13 Apache 2.2.15 / Pgsql 8.4.3 / PHP 5.3.2
Fusion Ticket beta6 OpenSUSE 11.2 Apache 2.2.13 / Mysql 5.1.36 / PHP 5.3.0
WebAuction 0.3.5 OpenRays 2.0 + xampp 1.6.8a Apache 2.2.9 / Mysql 5.0.67 / PHP 5.2.6
OpenJournal 2.3.1-2 Fedora 13 Apache 2.2.15 / Pgsql 8.4.3 / PHP 5.3.2
OpenConference 2.3.2 Fedora 13 Apache 2.2.15 / Pgsql 8.4.3 / PHP 5.3.2
FladsClassified 091201 OpenSUSE 11.2 Apache 2.2.13 / Mysql 5.1.36 / PHP 5.3.0
WebCalendar 1.2.1 Fedora 13 Apache 2.2.15 / Pgsql 8.4.3 / PHP 5.3.2
phpScheduleIT 1.2.12 PC-BSD 8.0 + xampp 1.6.8a Apache 2.2.9 / Mysql 5.0.67 / PHP 5.2.6
OpenCATS 0.9.1a PC-BSD 8.0 + xampp 1.6.8a Apache 2.2.9 / Mysql 5.0.67 / PHP 5.2.6
php-residence 1.3.0 RedFlag 7 + xampp 1.7.3a Apache 2.2.14 / Sqlite 2.8.17 / PHP 5.3.1
Open-Realty 2.5.8 OpenRays 2.0 + xampp 1.6.8a Apache 2.2.9 / Mysql 5.0.67 / PHP 5.2.6
Care2X 2.5rc1 PC-BSD 8.0 + xampp 1.6.8a Apache 2.2.9 / Mysql 5.0.67 / PHP 4.4.9

php.ini Setting: register_globals may be set to [on] or [off] (with [off] being recommended).

Hardware Requirement :
If everything (Operating System, webserver, dbserver, middleware, client desktop, browser) runs on a single machine, the
system will probably need at least,
CPU - Intel Celeron 1.8G, RAM - 512M, H/D - 40M (excluding the space needed to house application data, which varies depending on transaction volume). However, if other middleware modules are utilizing the same machine, the configuration above is most likely to be inadequate.

Installation Procedure :

0. Target middleware (anyone of these) - PSCafePOS 2.0.5 / OpenBiblio 0.6.1 / IRM 1.6-b3 / LegalCase 0.7.3 / ClearHealth 2.3 / OpenEMR 3.2 / eGroupWare 1.6.003-2 / Zencart 1.3.9c / Joomla 1.5.17 / Drupal 6.17 / Moodle 1.9.8+ / vTiger 5.1.0 / phpBB 3.0.7 / TikiWiki 4.2 / WordPress 2.9.2 / Xaraya 2.0 / ATutor 1.6.4 / b2evolution 3.3.3 / e107 0.7.21 / Horde-GroupWare 1.2.6 / Mambo 4.6.5 / XOOPS 2.4.4 / osCommerce 2.2rc2a / OpenX 2.8.5 / LandShop 0.9.2 / MyHandyRestaurant 0.8.5 / phpMySport 1.4 / AssetMan 2.5b / CopperMine 1.5.4 / Gallery 2.3 / Fusion Ticket beta6 / WebAuction 0.3.5 / OpenJournal 2.3.1 / OpenConference 2.3.2 / FladsClassified 091201 / WebCalendar 1.2.1 / phpScheduleIT 1.2.12 / OpenCATS 0.9.1a / php-residence 1.3.0 / Open-Realty 2.5.8 / Care2X 2.5rc1
1. Setup a working Linux environment with Apache and PostgreSQL/MySQL/SQLite fully installed and started.
2. Download ck-erp-0.30.1.tar.gz from http://sourceforge.net/projects/ck-erp.
3. Untar the CK-ERP software tarball into pscafepos' (management) / openbiblio's (admin) / irm's base / legalcase's base / clearhealth's (modules) / openemr's (accounting) / egw's base / zencart's (admin) / joomla's (modules) / drupal's (modules) / moodle's (admin) / vtiger's (modules) / phpbb's base / tikiwiki's base / wordpress' (wp-admin) / xaraya's (html/modules) / atutor's (mods) / b2evoultion's (blogs) / e107's (e107_plugins) / horde-groupware's base / mambo's (modules) / xoops' (htdocs/modules) / oscommerce's (catalog/admin) / openx's (plugins) / landshop's (admin) / myhandyrestaurant's (manage) / phpmysport's base / assetman's base / coppermine's (plugins) / gallery's (modules) / fusionticket's (admin) / webauction's base / openjournal's (plugins) / openconference's (plugins) / fladsclassified's (system/plugins) / webcalendar's base / phpscheduleit's base / opencats' (modules) / phpresidence's base / openrealty's (addons) / care2x' (modules) directory (# tar -xzvf <full path name of ck-erp-0.30.1.tar.gz>) .
4. Setup/Install the target middleware.
5. Test to ensure you have a working target middleware environment.
6. Login the target middleware as a user named [admin]. *** DO NOT LOGIN AS ANY OTHER USER ***
6a. Add CK-ERP entry link onto middleware's screen display,

PSCafePOS Edit (pscafepos root)/management/index.php to insert [CK-ERP] into PSCafePOS's left hand column menu,
At around line 203 and below the clause :- .... "menuFrame\">\n" );
add the following phrase - if ( $_SESSION[_level_] >= 1 ) echo ( "<div class=\"menuItem\" onMouseover=\"this.className='menuItemOver'\" onMouseout=\"this.className='menuItem'\"><font class=\"small\">    <a href=\"" .dirname( $_SERVER["PHP_SELF"]) . "/ck-ledger\">CK-ERP</a></font></div>\n" );
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(pscafepos root)/management/ck-admin/index.php
OpenBiblio Edit (openbiblio root)/navbar/admin.php to insert [CK-ERP] into OpenBiblio's Admin menu,
At around line 75 and below the clause :- .... getText("help");?></a>
add the following phrase - <br><a href="../admin/ck-ledger/index.php" class="alt1">CK-ERP</a>
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(openbiblio root)/admin/ck-admin/index.php
IRM Edit (irm root)/include/functioins.php to insert [CK-ERP] into IRM's Header menu,
At around line 306 and before the clause :- PRINT MenuItem($userbase, "logout.php", $logoutImage, _("Logout"));
add the following phrase - PRINT MenuItem("/irm/ck-ledger", "index.php", "../../ck-admin/images/logo.png", _("CK-ERP"));
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(irm root)/ck-admin/index.php
LegalCase Edit (legalcase root)/inc/inc_presentation.php to insert [CK-ERP] into LegalCase's Main menu,
At around line 272 and below the clause :- echo show_navmenu_item("listauthors.php", 'main_authors');
add the following phrase - ..... echo show_navmenu_item('ck-ledger/index.php', 'CK-ERP [Home -> Logout, when finished]'); .....
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] BLOCK LINK.
- Instead use your browser to visit directly http://(domainname or localhost)/(legalcase root)/ck-admin/index.php
ClearHealth Edit (clearhealth root)/local/templates/main/general_list.html to insert [CK-ERP] into ClearHealth's header menu display,
At around line 144 and after the clause - <a href="{$base_dir}index.php/main/admin">Admin</a>
add the following phrase - ..... <li><a href="{$base_dir}modules/./ck-ledger/index.php">CK-ERP</a></li> {if 1==1}
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] BLOCK LINK.
- Instead use your browser to visit directly http://(domainname or localhost)/(clearhealth root)/modules/ck-admin/index.php
OpenEMR Edit (openemr root)/interface/main/left_nav.php to insert [CK-ERP] into OpenEMR's lefthand radio button menu display,
At around line 105 and before the clause :- 'ros' => array(xl('Roster') , 0, 'reports/players_report.php?embed=1'),
add the following phrase - 'erp' => array(xl('CK-ERP'), 0,'../accounting/ck-ledger/index.php'),
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] BLOCK LINK.
- Instead use your browser to visit directly http://(domainname or localhost)/(openemr root)/accounting/ck-admin/index.php
eGroupWare - Login eGW setup screen -> Step 5 - Advanced Application Management -> Check to ensure all the ck-??? modules are installed -> Re-do module installation (if necessary)
- Access eGW admin module -> User groups -> Edit [Admins] group -> Anable all the ck-??? modules -> Submit Changes
Zencart Edit (zencart root)/admin/includes/header.php to insert [CK-ERP] into Zencart's header display,
At around line 230 and behind the following clause - <td class="headerBarContent" align="center"><b><?php echo date("r", time()) . 'GMT' . ' [' . $_SERVER['REMOTE_ADDR'].' ] ';?></b></td>
add the following phrase - <td class="headerBarContent" align="right"><b><?php echo '<a href="' . zen_href_link('ck-ledger/index.php', '', 'NONSSL') . '" class="headerLink">' . 'CK-ERP' . '</a> ' ?></b></td>
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(zencart root)/admin/ck-admin/index.php
Joomla Login to Joomla Administration
Create CK-ERP mainmenu choice
- Menu -> mainmenu -> New -> Wrapper -> Name: CK-ERP; Wrapper link: (domain)/(joomla root)/modules/ck-ledger/ ; AutoHeight: Yes -> Save
- Logout of Joomla Administration
- Using admin level account, login to Joomla site frontend
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(joomla root)/modules/ck-admin/index.php
Drupal Create CK-ERP entrance block at left hand column
- Administer -> blocks -> add block -> Block description: CK-ERP Block; Block title: (any); Block body: <a href="/(drupal root)/modules/./ck-ledger/index.php"> CK-ERP </a> -> Save block
- Enable CK-ERP Block and If necessary, adjust positioning of CK-ERP Block
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] ENTRANCE BLOCK LINK.
- Instead use your browser to visit directly http://(domainname or localhost)/(drupal root)/modules/ck-admin/index.php
Moodle - Turn editing on
- Blocks -> Add (HTML) -> Block Title: CK-ERP; Content (please make sure the editor is toggled to allow raw html source input): <a href="http://(domainname or localhost)/(moodle root)/admin/ck-ledger/index.php"> CK-ERP </a> -> Save changes
- Site Administration -> Users -> Permissions -> Define roles -> Add a new role -> Name: ck-erp-user -> Add a new role
- Site Administration -> Users -> Permissions -> Assign roles -> ck-erp-user -> Make sure [Current context: Site] -> move admin user (along with other appropriate users) from [potential users] to [existing users]
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] BLOCK LINK.
- Instead use your browser to visit directly http://(domainname or localhost)/(moodle root)/admin/ck-admin/index.php
vTiger Edit (vtiger root)/Smarty/templates/Header.tpl to insert [CK-ERP] into vTiger's header display,
At around line 183 and before the clause - <td align=right style="padding-right:10px" nowrap >
add the following phrase - <td><a href="modules/ck-ledger/index.php">CK-ERP</a></td>
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(vtiger root)/modules/ck-admin/index.php
phpBB3 Edit (phpbb root)/styles/prosilver/template/overall_header.html to insert [CK-ERP] into phpBB's header menu display,
At around line 133 and below the clause - {L_PRINT_PM}

add the following phrase - ..... <li class="linklist rightside"><a href="ck-ledger/index.php">CK-ERP</a> .....
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(phpbb root)/ck-admin/index.php

TikiWiki - Access Admin -> Features -> Activate [User Files]
- Access Admin -> User files -> Activate [Use a directory to store userfiles] and set path to the desired location (Note: this directory must be writable by the web process)
- Access Admin -> Modules -> Create new user modules [Name:CK-ERP; Title:CK-ERP; Data:<a href="././ck-ledger/index.php">
<img src="././ck-admin/images/abacus.png" width="16" height="16" alt="CK-ERP"> CK-ERP</a>]
- [Edit the new modules so it is accessible to both the 'Anonymous' and 'Registered' group and adjust the positioning of the module, as desired]
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MODULE LINK.
- Instead use your browser to visit directly http://(domainname or localhost)/(tikiwiki root)/ck-admin/index.php
WordPress Edit (wordpress root)/wp-admin/menu.php to insert [CK-ERP] into WordPress' Admin lefthand menu display,
At around line 115 and after the clause - $submenu['options-general.php'][45] = array(__('Miscellaneous'), 'manage_options', 'options-misc.php');
add the following line - $menu[991] = array(__(' CK-ERP'), 'edit_posts', 'ck-ledger/index.php', '', 'menu-top', 'abc', 'div');
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(wordpress root)/wp-admin/ck-admin/index.php
Xaraya Access Admin -> Themes -> Modify Config -> set Site Slogan to <a href="modules/ck-ledger/index.php"><font size=+2>Click here to access CK-ERP</font></a>
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] ENTRY LINK.
- Instead use your browser to visit directly http://(domainname or localhost)/(xaraya root)/html/modules/ck-admin/index.php
ATutor Edit (atutor root)/include/header.inc.php to insert [CK-ERP] into ATutor's header display,
At around line 117 and before the clause - if (empty($_top_level_pages)) {
add the following line - $_top_level_pages[] = array('url' => HOME_URL.'mods/ck-ledger/index.php', 'title' => 'CK-ERP');
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(atutor root)/mods/ck-admin/index.php
b2evolution Edit (b2evolution root)/blogs/skins_adm/_adminUI_general.class.php to insert [CK-ERP] into b2evolution's Admin header display,
At around line 1651 and before the clause - $Plugins->trigger_event( 'AdminAfterMenuInit' );
add the following phrase - $this->add_menu_entries( NULL, array( 'ckerp' => array( 'text' => T_('CK-ERP'), 'title' => T_('CK-ERP Title'), 'href' => 'ck-ledger/index.php', ),) );
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(b2evolution root)/blogs/ck-admin/index.php
e107 Create CK-ERP Main Menu choice
- Admin Area -> Show Admin Functions -> Site Links -> Create New Link -> Link Name: CK-ERP; Link URL: e107_plugins/ck-ledger/index.php ; Update Link -> Leave Admin
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
Instead use your browser to visit directly http://(domainname or localhost)/(e107 root)/e107_plugins/ck-admin/index.php
Horde
GroupWare
Append the content of <horde-groupware base directory>/ck-api/horde/registry.php.ck-erp to the end of <horde-groupware base directory>/config/registry.php
- Access Administration -> Setup -> General -> Set [If you want to use a temporary directory ... enter it here] to the desired location (Note: this directory must be writable by the web process)
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] ENTRY LINK.
- Instead use your browser to visit directly http://(domainname or localhost)/(horde-groupware root)/ck-admin/index.php?Horde=(session key)
Mambo Login to Mambo Administration
Create CK-ERP mainmenu choice
- Menu -> mainmenu -> New -> Wrapper -> Name: CK-ERP; Wrapper link: (domain)/(mambo root)/modules/ck-ledger/ ; -> Save
- Logout of Mambo Administration
- Using admin level account, login to Mambo site frontend
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(mambo root)/modules/ck-admin/index.php
XOOPS Create CK-ERP entrance block at left hand column
- Adminstration menu -> System Admin -> Blocks -> Add a new block -> Block type: Side-Block-Left; Visible in: All Page; Title: CK-ERP; Content: <a href="{X_SITEURL}modules/ck-ledger/index.php"><img src="{X_SITEURL}modules/ck-admin/images/abacus.png"> CK-ERP </a> -> Submit
- If necessary, adjust the weighting of CK-ERP entrance block to position CK-ERP appropriately
- Update Anonymous group's Block Access Right to allow access to CK-ERP entrance block via Administration menu -> System Admin -> Groups
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] ENTRANCE BLOCK LINK.
- Instead use your browser to visit directly http://(domainname or localhost)/(xoops root)/htdocs/modules/ck-admin/index.php
[Additional Note: If you need to control ck-????? module access via XOOPS' group-module access right, then you have to install ck-????? module via Adminstration menu -> System Admin -> Modules (Be sure to set Order = 0). After module installation, ck-????? will show up in Adminstration menu -> System Admin -> Groups (Module Access rights section)]
osCommerce Edit (osc root)/catalog/admin/includes/header.php to insert a [CK-ERP] entry into the header menu,
After line 22 - <td class="headerBarContent">  <?php echo '<a href="' . tep_href_link(FILENAME_DEFAULT, '', 'NONSSL') . '" class="headerLink">' . HEADER_TITLE_ADMINISTRATION . '</a>  |  <a href="' . tep_catalog_href_link() . '" class="headerLink">' . HEADER_TITLE_ONLINE_CATALOG . '</a>  |  <a href="http://www.oscommerce.com" class="headerLink">' . HEADER_TITLE_SUPPORT_SITE . '</a>'; ?</td>
insert a new line - <td class="headerBarContent" align="right"><?php echo (tep_session_is_registered('admin') ? '<a href="' . tep_href_link('ck-ledger/index.php') . '" class="headerLink">CK-ERP</a>': '') ; ?>  </td>
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(oscommerce root)/catalog/admin/ck-admin/index.php
OpenX Edit (openx root)/lib/OA/Admin/UI.php to insert [CK-ERP] into OpenX's header menu,
At around line 226 and before the clause :- $this->_compileLeftMenuNavigation($oCurrentSection, $oMenu, $aLeftMenuNav);
add the following phrase - $aMainNav[]= array('title'=>'CK-ERP','filename'=>"../../plugins/ck-ledger/index.php",'selected'=>False);
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(openx root)/plugins/ck-admin/index.php
LandShop Edit (landshop root)/admin/templates/standard.tmpl to insert [CK-ERP] into LandShop's left hand column menu,
At around line 44 and below the clause :- <A href="<#G_ADMIN_URL#>/action/maintenance.php"><#maintenance#></a>
add the following phrase - <A href="<#G_ADMIN_URL#>/ck-ledger/index.php">CK-ERP</a>
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(landshop root)/admin/ck-admin/index.php
My
Handy
Restaurant
Edit (myhandyrestaurant root)/include/menu_admin.php to insert [CK-ERP] into MyHandyRestaurant's header menu,
At around line 140, replace the clause :- <tr><td height="20"> </td></tr>
with - <tr><td height="20"><br><a href="../manage/ck-ledger/index.php">CK-ERP</a><br> </td></tr>
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(myhandrestaurant root)/manage/ck-admin/index.php
phpMySport Edit (phpmysport root)/template/defaut/index.html to insert [CK-ERP] into phpMySport's header menu,
At around line 73 and above the clause :- <li><a href="{link_deconnection}">{L_deconnection}</a></li>
add the following phrase - <li><a href="ck-ledger/index.php">CK-ERP</a></li>
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(phpmysport root)/ck-admin/index.php
AssetMan Edit (assetman root)/header.inc.php to insert [CK-ERP] into AssetMan's header menu,
At around line 125 and below the clause :- <td><img src="images/spacer.gif" width="1" height="20" border="0" alt=""></td>
add the following phrase - <td><a href="ck-ledger/index.php">CK-ERP</a></td>
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(assetman root)/ck-admin/index.php
Coppermine Edit (coppermine root)/themes/curve/theme.php to insert [CK-ERP] into Coppermine's header menu,
At around line 36 and before the clause :- <!-- BEGIN home -->
add the following phrase - <li><a href="plugins/ck-ledger/index.php" title="CK-ERP" class="firstlevel"><span class="firstlevel"> CK-ERP</span></a></li>
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(coppermine root)/plugins/ck-admin/index.php
Gallery Edit (gallery root)/themes/matrix/templates/theme.tpl to insert [CK-ERP] into Gallery's header menu,
At around line 47 and before the clause :- <div class="gbBreadCrumb">
add the following phrase - <div class="gbSystemLinks"><a href="modules/ck-ledger/index.php">CK-ERP</a></div>
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(gallery root)/modules/ck-admin/index.php
FusionTicket Edit (fusionticket root)/includes/admin/class.adminmenu.php to insert [CK-ERP] into FusionTicket's header menu,
At around line 85, and before the clause :- echo "<tr><td class='menu_admin_item'>
add the following phrase - echo "<tr><td class='menu_admin_item><a href='ck-ledger/index.php' class='menu_admin_item'> CK-ERP</a></td></tr><br />";
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(fusionticket root)/admin/ck-admin/index.php
WebAuction Edit (webauction root)/dataface/Dataface/templates/Dataface_NavMenu.html to insert [CK-ERP] into WebAuction/Dataface's header menu,
At around line 38, and after the clause :- {block name="tables_menu_tail"}
add the following phrase - <li><a href="{$ENV.DATAFACE_SITE_URL}/ck-ledger/index.php">CK-ERP</a> </li>
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(webauction root)/ck-admin/index.php
OpenJournal Edit (openjournal root)/templates/common/navbar.tpl to insert [CK-ERP] into OpenJournal's header menu,
At around line 11, and after the clause :- <ul class="menu">
add the following phrase - <li><a href="/(openjournal root)/plugins/ck-ledger/index.php">CK-ERP</a></li>
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(openjournal root)/plugins/ck-admin/index.php
OpenConference Edit (openconference root)/templates/common/navbar.tpl to insert [CK-ERP] into OpenConference's header menu,
At around line 23, and before the clause :- {if $currentConference}
add the following phrase - <li><a href="/(openconference root)/plugins/ck-ledger/index.php">CK-ERP</a></li>
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(openconference root)/plugins/ck-admin/index.php
FladsClassified Edit (fladsclassified root)/system/application/views/fl_ads.php to insert [CK-ERP] into FladsClassified's header menu,
At around line 23, and before the clause :- $ads_anchors0[] = anchor($this->config->item('Fl_ads_index_uri') . $append_lang, $this->lang->line('Fl_ads_home_h1'));
add the following phrase - $ads_anchors0[] = anchor('http://localhost/fladsos/system/plugins/./ck-ledger/index.php' . $append_lang, 'CK-ERP');
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(fladsclassified root)/system/plugins/ck-admin/index.php
WebCalendar Edit (webcalendar root)/includes/menu/menu_config.php to insert [CK-ERP] into WebCalendar's header menu,
At around line 58, and after the clause :- $menuExtras = array ();
add the following phrase - $menuExtras[7] = array ( 'item', '../../../ck-admin/images/logo.png', '', 'ck-ledger/index.php', '' ) ;
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(webcalendar root)/ck-admin/index.php
phpScheduleIT Edit (phpscheduleit root)/lib/Template.class.php to insert [CK-ERP] into phpScheduleIT's header menu,
At around line 111 and below the clause :- .... 'My Control Panel')) ?>
add the following phrase - | <?php $this->link->doLink($this->dir_path . './ck-ledger/index.php', 'CK-ERP') ?>
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(phpscheduleit root)/ck-admin/index.php
OpenCATS Edit (OpenCATS root)/lib/TemplateUtility.php to insert [CK-ERP] into OpenCATS' tab menu,
At around line 779 and before the clause - echo '</ul>';
add the following phrase - echo '<li><a class="inactive" href="modules/ck-ledger/index.php">CK-ERP</a></li>' ;
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(OpenCATS root)/modules/ck-admin/index.php
php-residence Edit (php-residence root)/includes/themes/sim/head.php to insert [CK-ERP] into php-residence's header menu,
At around line 269 and before the clause - echo "</td></tr></table></td>";
add the following phrase - echo "| </td> <td> <div class=\"drop\"> <ul><li> <a class=\"nav\" href=\"./ck-ledger/index.php?id_sessione=$id_sessione\">  <b>CK-ERP </b>  </a>";
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(php-residence root)/ck-admin/index.php
Open-Realty Edit (openrealty root)/admin/template/OR/main.html to insert [CK-ERP] into Open-Realty's header menu,
At around line 22 and before the clause - {check_agent} |
add the following phrase - | <a href="{baseurl}/addons/ck-ledger/index.php">CK-ERP</a>
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(openrealty root)/addons/ck-admin/index.php
Care2X Edit (care2x root)/main/menu/default/mainmenu.inc.php to insert [CK-ERP] into Care2X' left hand column menu,
At around line 54 and before the clause - echo $gui;
add the following phrase - if (trim($_SESSION['sess_login_username'])<>'') $gui.='<tr><td colspan=3><img src="'.$root_path.'modules/ck-admin/images/logo.png'.'"><b><a href="'.$root_path.'modules/ck-ledger/index.php'.'" TARGET="CONTENTS" REL="child">..CK-ERP</a></b></td></tr>';
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(care2x root)/modules/ck-admin/index.php

7. The CK-ERP modules will show up as icons with an [abacus] background.
8. You may have to click all 32 icons to find out which icon relates to which module.
9. Choose (CK-ERP's) Administration module (castle icon with [abacus] background).
[The following error message (or something similar) may show up,
Database error: Invalid SQL: SELECT checksum FROM ck_md5 WHERE script='/ck-admin/index.php'
MySQL Error: 1146 (Table 'ckerp.ck_md5' doesn't exist) Session halted.]
But don't worry, this is due to the absence of the checksum table which will be created in a later step.
10. Read in detail the [Welcome to Administration] page.
11. Pick the [Admin/Setup] choice at the top header menu.
12. Choose action 1 - Install Initial System
13. Press [Start Action] button.
14. Choose the appropriate Chart of Accounts to install
15. Press [Start Action] button again.
16. Numerous descriptive messages will appear.
17. Press any one of the [Done] buttons.
18. Adjust the Primary and Secondary Tax of customer, ____Cash and ___Myself, via [ck-crm] -> Customer Info -> Start Search -> Edit.
19. Adjust the Primary and Secondary Tax of vendor, ___Myself, via [ck-vrm] -> Vendor Info -> Start Search -> Edit.

At this point, CK-ERP is fully functional and all features are available for your testing.

A few points to note:

1. Irrespective of any assertion from any person or source, there are BUGS/ERRORS/SECURITY RISKS associated with this module. You are using this module or any derivative of this module at your own risk.
2. Some of the menu choices are still not implemented.
3. The cheque printing facility assumes a normal stub-based manual handwritten cheque format (not the computer stationery type). The layout would have to be tuned for different bank's cheque format. The included facility is just for sample only.
4. Since the current version is a beta release, so DO NOT, DON'T, DO NOT AGAIN use this version against any production data or environment.
5. Some browsers may show distorted display. You may need to try different browsers and font (size) to get the best fit.

Please report any error to CK-ERP-en@googlegroups.com.

Data Backup
1. Click (CK-ERP's) Administration Module icon.
2. Choose Data Backup
3. A backup (flat) file, with its name appearing on screen, will be created.

Data Restore
1. Click (CK-ERP's) Administration Module icon.
2. Choose Data Restore.
3. A list of backup files kept at your user home directory will be displayed.
4. Choose the appropriate file.
5. Press [Start Database Restoration] button.

Upgrading
Automatic upgrading from previous versions is currently not supported.

Special Handling

Last Updated: 2011-09-01