CK - Common Knowledge: to be shared and developed by all - ERP

General Description :

CK-ERP is an open source accounting / 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. SQL server can either be local or remote. Client access is via web browsers, Konqueror, Mozilla, Netscape, Opera and the like.

Functionally, it is divided into 23 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, Data Import, Internationalization.

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::]
Hospital	Care2X	Hospital Administrator
School	Centre/SIS, ClaSS	School Administrator
Hotel/Motel	php-residence, phpScheduleIT	Hotel/Motel Operator, Commercial Space Leasor
Online Ticketing	phpMyTicket	Ticketing Agent
Sport Club/League	phpMySport	Club/League Manager
Restaurant/Canteen	MyHandyRestaurant, PSCafePOS	Restaurant/Canteen Operator
Logistics	FreightFleetManagementSystem(FFMS)	Transportation / Trucking Company
Employment Service	CATS	Recruitment Consultant, Employment Agency
Online Advertisement	OpenX	Advertising agency, Online Ad publisher
Classified Advertisement	LandShop, OpenRealty, FreeRealty	Real Estate Agent, Classified Ad operator
Hardware Repair/Maintenance	IRM	Hardware Repair/Maintenance Vendor
Legal Service	LegalCase	Lawyer
Medical Service	ClearHealth, OpenEMR	Doctor, Dentist, Medical Practitioner
Shopping Cart	Zencart, osCommerce	Online Retailer
Online Education	Moodle, ATutor	elearning Institute
Online Album	Coppermine, Gallery	Online Album Operator
Library	OpenBiblio	Library Operator, Comic Book/VCD/DVD rental shop owner
[::FUNCTIONAL PLATFORM::]
GroupWare	eGroupWare, Horde-GroupWare	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


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),

Operating System	Webserver	DB Engine	Middleware
PC-BSD 1.5.1+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	CATS 0.9.1
OpenRays 2.0+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	php-residence 1.1
OpenRays 2.0+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	OpenRealty 2.5.2
PC-BSD 1.5.1+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	phpScheduleIT 1.2.10
OpenRays 2.0+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	PSCafePOS 1.1.4
Kubuntu 8.04	Apache 2.2.8	Mysql 5.0.51a	OpenBiblio 0.6.1
Fedora 9	Apache 2.2.8	Pgsql 8.3.1	Centre/SIS 2.14.1
OpenRays 2.0+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	ClaSS 0.8.51
OpenRays 2.0+XAMPP 1.6.7	Apache 2.2.9/php4	Mysql 5.0.51b	Care2X
RedFlag 6+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	IRM 1.6-b3
MagicLinux2+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	LegalCase 0.7.3
Fedora 9	Apache 2.2.8	Mysql 5.0.51a	ClearHealth 2.2
RedFlag 6+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	OpenEMR 2.9
Fedora 9	Apache 2.2.8	Pgsql 8.3.1	eGroupWare 1.6pre1
MagicLinux2+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	Zencart 1.3.8a
RedFlag 6+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	Joomla 1.5.5
Fedora 9	Apache 2.2.8	Mysql 5.0.51a	Drupal 6.3
Fedora 9	Apache 2.2.8	Pgsql 8.3.1	Moodle 1.9.2
Kubuntu 8.04	Apache 2.2.8	Mysql 5.0.51a	vTigerCRM 5.0.4
RedFlag 6+XAMPP 1.6.7	Apache 2.2.9	Sqlite 2.8.17	phpBB 3.0.2
Fedora 9	Apache 2.2.8	Mysql 5.0.51a	TikiWiki 2.0
MagicLinux2+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	WordPress 2.6.1
OpenRays 2.0+XAMPP 1.6.7	Apache 2.2.9	Sqlite 2.8.17	Xaraya 1.1.4
RedFlag 6+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	ATutor 1.6.1pl1
MagicLinux2+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	b2evolution 2.4.2
Kubuntu 8.04	Apache 2.2.8	Mysql 5.0.51a	e107 0.7.11
Kubuntu 8.04	Apache 2.2.8	Mysql 5.0.51a	Horde-groupware 1.1.2
RedFlag 6+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	Mambo 4.6.5
RedFlag 6+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	XOOPS 2.0.18.2
PC-BSD 1.5.1+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	osCommerce 2.2rc2a
Kubuntu 8.04	Apache 2.2.8	Mysql 5.0.51a	OpenX 2.6.1
Kubuntu 8.04	Apache 2.2.8	Mysql 5.0.51a	LandShop 0.9.1
PC-BSD 1.5.1+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	FreeRealty 3.0rc7
OpenRays 2.0+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	FFMS/truck 1.0
PC-BSD 1.5.1+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	MyHandyRestaurant 0.8.5
Kubuntu 8.04	Apache 2.2.8	Mysql 5.0.51a	phpMySport 1.3
Fedora 9	Apache 2.2.8	Mysql 5.0.51a	AssetMan 2.5b
PC-BSD 1.5.1+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	Coppermine 1.4.19
Fedora 9	Apache 2.2.8	Pgsql 8.3.1	Gallery 2.2.5
MagicLinux2+XAMPP 1.6.7	Apache 2.2.9	Mysql 5.0.51b	FusionTicket 1.3.5beta3

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) - CATS 0.9.1 / php-residence 1.1 / Open-Realty 2.5.2 / phpScheduleIT 1.2.10 / PSCafePOS 1.1.4 / OpenBiblio 0.6.1 / CentreSIS 2.14.1 / ClaSS 0.8.51 / Care2X 2.5rc1 / IRM 1.6b3 / LegalCase 0.7.3 / ClearHealth 2.2 / OpenEMR 2.9 / eGroupWare 1.6pre1 / Zencart 1.3.8a / Joomla 1.5.5 / Drupal 6.3 / Moodle 1.9.2 / vTiger 5.0.4 / phpBB 3.0.2 / TikiWiki 2.0 / WordPress 2.6.1 / Xaraya 1.1.4 / ATutor 1.6pl1 / b2evolution 2.4.2 / e107 0.7.11 / Horde-gw 1.1.2 / Mambo 4.6.5 / XOOPS 2.0.18.2 / oscommerce 2.2rc2a / OpenX 2.6.1 / LandShop 0.9.1 / FreeRealty 3.0rc7 / FFMS 1.0 / myhandyrestaurant 0.8.5 / phpmysport 1.3 / assetman 2.5b / coppermine 1.4.19 / gallery 2.2.5 / FusionTicket 1.3.5beta3
1. Setup a working Linux environment with Apache and PostgreSQL/MySQL/SQLite fully installed and started.
2. Download ck-erp-0.28.1.tar.gz from http://sourceforge.net/projects/ck-erp.
3. Untar the CK-ERP software tarball into cats' (modules) / php-residence's / openrealty's (addons) / phpscheduleit's / pscafepos's (management) / openbiblio's (admin) / centre's (modules) / class' / care2x' (modules) / irm's / legalcase's / clearhealth's (modules) / openemr's (accounting) / egw's / zencart's (admin) / joomla's (modules) / drupal's (modules) / moodle's (admin) / vtiger's (modules) / phpbb's / tikiwiki's / wordpress' (wp-admin) / xaraya's (html/modules) / atutor's (mods) / b2evoultion's (blogs) / e107's (e107_plugins) / horde-groupware's / mambo's (modules) / xoops' (htdocs/modules) / oscommerce's (catalog/admin) / openx' (plugins) / landshop's (admin) / freerealty's (admin) / ffms's (main) / myhandyrestaurant's (manage) / phpms' / coppermine's (plugins) / gallery's (modules) / fusionticket's (admin) / assetman's target base directory (# tar -xzvf <full path name of ck-erp-0.28.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 admin level user. ***DO NOT LOGIN AS NON-ADMIN USER***.
6a. Add CK-ERP entry link onto middleware's screen display,

CATS	Edit (CATS root)/lib/TemplateUtility.php to insert [CK-ERP] into CATS' tab menu, At around line 774 and before the clause - echo '</ul>'; add the following phrase - <li><a class="inactive" href="modules/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)/(CATS 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 213 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
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
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
Centre/SIS	Edit (centre root)/Side.php to insert [CK-ERP] into Centre/SIS' left hand column menu, At around line 247 and below the clause :- .... echo '<BR>'; add the following phrase - echo '<TABLE border=0 cellpadding=0 cellspacing=0 width=100%><TR><TD><A HREF="modules/ck-ledger/index.php" target=body>CK-ERP</A></TD></TR></table>'; - AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE. - Instead use your browser to visit directly http://(domainname or localhost)/(centre root)/modules/ck-admin/index.php
ClaSS	Edit (class root)/class/admin.php to insert [CK-ERP] into ClaSS' Admin/Configure menu, At around line 74 and below the clause :- .... 'servertest' add the following phrase - ,'../../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)/(class root)/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
FusionTicket	Edit (fusionticket root)/includes/admin/AdminPage.php to insert [CK-ERP] into FusionTicket's header menu, At around line 117, change the clause :- echo"</td></tr></table><br>"; to the following - echo"</td><td><a href='ck-ledger/index.php'>CK-ERP</a></td></tr></table><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
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
Coppermine	Edit (coppermine root)/include/themes.inc.php to insert [CK-ERP] into Coppermine's header menu, At around line 136 and below the clause :- // {HREF_LNK}{HREF_TITLE}{HREF_TGT}{BLOCK_ID}{SPACER} add the following phrase - addbutton($sys_menu_buttons,'CK-ERP', 'CK-ERP', 'plugins/ck-ledger/index.php', 'ck-erp', $template_sys_menu_spacer); - 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
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
phpMySport	Edit (phpmysport root)/template/defaut/index.html to insert [CK-ERP] into phpMySport's header menu, At around line 61 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
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
Freight Fleet Management System (FFMS)	Edit (ffms root)/main/admin_template.php to insert [CK-ERP] into FFMS' lead-in menu page, At around line 114 and below the clause :- ... Truck Set Up</a></td> <td> </td></tr> add the following phrase - <tr><td colspan="7"> </td></tr><tr><td height="58" align="center" background="images/menu.gif"><a href="ck-ledger/index.php" class="link2">CK-ERP</a></td><td> </td></tr> Edit (ffms root)/main/template.php to insert [CK-ERP] into FFMS' left-hand column menu, At around line 96 and below the clause :- ... <a href="truck_info.php" class="link2">»</a></font></td> add the following phrase - <tr> <td height="32" align="center" valign="middle"><img src="images/icon1.gif" width="35" height="35"></td> <td height="32"><a href="ck-ledger/index.php" class="link2" onClick="return temp();"><font color="003366">CK-ERP </font></a><font color="003366"><a href="ck-ledger/index.php" class="link2">...</a></font></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)/(ffms root)/main/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 272 and below the clause :- // Account switcher add the following phrase - $GLOBALS['strWorkingAs']='<a href="../../plugins/ck-ledger/index.php">CK-ERP</a>......'.$GLOBALS['strWorkingAs'] ; - 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
FreeRealty	Edit (freerealty root)/admin/admin_upper.php to insert [CK-ERP] into FreeRealty's Header menu, At around line 30 and below the clause :- <a href=\"$admin_url/admin.php?action=config\">Configure site</a> | add the following phrase - <a href=\"$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)/(freerealty 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 142 and below {/if} add the following phrase - ..... <li><a href="{$base_dir}modules/./ck-ledger/index.php">CK-ERP</a></li> ..... - 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 124 and below the clause :- 'cod' => array('Charges' , 2, 'patient_file/encounter/encounter_bottom.php'), add the following phrase - 'erp'=>array('CK-ERP (click [Open New Window] to enlarge working area)',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
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
ATutor	Edit (atutor root)/include/header.inc.php to insert [CK-ERP] into ATutor's header display, At around line 92 and below the clause - $_current_top_level_page = get_current_main_page($current_page); add the following phrase - $_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
vTiger	Edit (vtiger root)/Smarty/templates/Header.tpl to insert [CK-ERP] into vTiger's header display, At around line 99 and before the clause - <td align=right style="padding-right:10px" > 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
WordPress	Edit (wordpress root)/wp-admin/menu.php to insert [CK-ERP] into WordPress' Admin header display, At around line 27 and after the clause - $menu[40] = array(__('Options'), 'manage_options', 'options-general.php'); add the following phrase - $menu[999] = array(__('CK-ERP'), 'edit_posts' ,'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)/(wordpress root)/wp-admin/ck-admin/index.php
b2evolution	Edit (b2evolution root)/blogs/_header.php to insert [CK-ERP] into b2evolution's Admin header display, At around line 330 and before the clause - $Plugins->trigger_event( 'AdminAfterMenuInit' ); add the following phrase - $AdminUI->add_menu_entries(NULL, array('ck-erp' => array('text'=>T_('CK-ERP'),'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
Joomla	Login to Joomla Administration Create CK-ERP mainmenu choice - Menu -> mainmenu -> New -> Wrapper -> Title: [extract title from (joomla root)/modules/ck-api/joomla/ruler)]; 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
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
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
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)]
Zencart	Edit (zencart root)/admin/includes/header.php to insert [CK-ERP] into Zencart's header display, At around line 167 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
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
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> - Access Admin -> Base -> Modify Config -> Languages and Locales -> Activate [Per Page Mode (BOXED)] and Language/Locale combos that you wish to make available -> Update - Access Admin -> Blocks -> Add Instance -> Set Module/Type to roles/languages, Name to (anything), Title to GUI Language, Block Group to left -> Create Instance - 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
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)
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
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 ... {L_PRINT_PM}<!-- ENDIF --> 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
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

7. The CK-ERP modules will show up as icons with an [abacus] background.
8. You may have to click all 23 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. Some of the menu choices are still not implemented.
2. 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.
3. 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.
4. 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
Starting from v.0.28.1, facilities to upgrade from previous version have been added.


Special Handling



Last Updated: 2008-09-05