You are here

Installation

INSTALLATION MANUAL
(This manual is applicable to CK-ERP 0.31.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, Chrome, 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, Event Organizer
Sport Club/League phpMySport Club/League Manager
Restaurant MyHandyRestaurant,PSCafePOS Restaurant, Cafe
Reservation HotelDruid, phpScheduleIT Resort, Hotel Operator, Commercial property/space leasor
Job Site / Job Board OpenCATS Recruitment agency, Job site operator
Online Advertisement OpenX Advertising agency, Online Ad publisher
Classified Advertisement FreeRealty, LandShop, FladsClassified Real Estate Agent, Classified Ad operator
Hardware Repair/Maintenance glpi Hardware Repair/Maintenance Vendor
Legal Service LegalCase Lawyer
Medical Service OpenEMR, Care2X Doctor, Dentist, Medical Practitioner, Hospital
Shopping Cart Zencart, osCommerce, osCMax Online Retailer
Auction Site WebAuction Web Auctioneer, Online Retailer
Online Education Moodle, ATutor, OpenConference, OpenJournal,OpenBiblio elearning Institute, librarian
Online Album Coppermine, Gallery Online Album Operator
[::FUNCTIONAL PLATFORM::]
GroupWare eGroupWare, Horde-GroupWare, WebCalendar Project Manager, Group Moderator
CMS Drupal, Joomla, 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

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

MiddleWare OS/Server Platform Web Server / Database / PHP Config
OpenCATS 0.9.1a Kubuntu 11.10 Apache 2.2.20 / Mysql 5.1.58 / PHP 5.3.6
OpenEMR 4.1.0 Kubuntu 11.10 Apache 2.2.20 / Mysql 5.1.58 / PHP 5.3.6
Zencart 1.5.0 Kubuntu 11.10 Apache 2.2.20 / Mysql 5.1.58 / PHP 5.3.6
VtigerCRM 5.3.0 Kubuntu 11.10 Apache 2.2.20 / Mysql 5.1.58 / PHP 5.3.6
TikiWiki 8.3 Kubuntu 11.10 Apache 2.2.20 / Mysqli 5.1.58 / PHP 5.3.6
XOOPS 2.5.4 Kubuntu 11.10 Apache 2.2.20 / Mysql 5.1.58 / PHP 5.3.6
OpenX 2.8.8 Kubuntu 11.10 Apache 2.2.20 / Mysql 5.1.58 / PHP 5.3.6
LandShop 0.9.2 Kubuntu 11.10 Apache 2.2.20 / Mysql 5.1.58 / PHP 5.3.6
phpMySport 1.4 Kubuntu 11.10 Apache 2.2.20 / Mysql 5.1.58 / PHP 5.3.6
MyHandyRestaurant 0.8.5 Kubuntu 11.10 Apache 2.2.20 / Mysql 5.1.58 / PHP 5.3.6
OpenJournal 2.3.7 Fedora 16 + bitnami-lappstack 5.3.10 Apache 2.2.22 / Pgsql 9.1.1 / PHP 5.3.10
OpenConference 2.3.5 Fedora 16 + bitnami-lappstack 5.3.10 Apache 2.2.22 / Pgsql 9.1.1 / PHP 5.3.10
eGroupWare 1.8.002 Fedora 16 + bitnami-lappstack 5.3.10 Apache 2.2.22 / Pgsql 9.1.1 / PHP 5.3.10
Drupal 7.12 Fedora 16 + bitnami-lappstack 5.3.10 Apache 2.2.22 / Pgsql 9.1.1 / PHP 5.3.10
Moodle 2.2.2 Fedora 16 + bitnami-lappstack 5.3.10 Apache 2.2.22 / Pgsql 9.1.1 / PHP 5.3.10
WebCalendar 1.2.5 Fedora 16 + bitnami-lappstack 5.3.10 Apache 2.2.22 / Pgsql 9.1.1 / PHP 5.3.10
WordPress 3.3.1 OpenSUSE 12.1 + bitnami-lampstack 5.3.10 Apache 2.2.22 / Mysql 5.5.16 / PHP 5.3.10
Coppermine 1.5.18 OpenSUSE 12.1 + bitnami-lampstack 5.3.10 Apache 2.2.22 / Mysql 5.5.16 / PHP 5.3.10
FusionTicker Beta6 OpenSUSE 12.1 + bitnami-lampstack 5.3.10 Apache 2.2.22 / Mysql 5.5.16 / PHP 5.3.10
FladsClassified 110722 OpenSUSE 12.1 + bitnami-lampstack 5.3.10 Apache 2.2.22 / Mysql 5.5.16 / PHP 5.3.10
HordeGroupware 4.0.6 Qomo 3.0 + xampp 1.7.7 Apache 2.2.21 / Sqlite 3.6.16 / PHP 5.3.8
HotelDruid 1.3.2 Qomo 3.0 + xampp 1.7.7 Apache 2.2.21 / Sqlite 2.8.17 / PHP 5.3.8
phpBB 3.0.10 Qomo 3.0 + xampp 1.7.7 Apache 2.2.21 / Sqlite 2.8.17 / PHP 5.3.8
Xaraya 2.2 Qomo 3.0 + xampp 1.7.7 Apache 2.2.21 / Sqlite 2.8.17 / PHP 5.3.8
AssetMan 2.5b Qomo 3.0 + xampp 1.7.7 Apache 2.2.21 / Sqlite 2.8.17 / PHP 5.3.8
PSCafePOS 2.0.5 MagicLinux 2.5.12 + xampp 1.7.7 Apache 2.2.21 / Mysql 5.5.16 / PHP 5.3.8
OpenBiblio 0.7.1 MagicLinux 2.5.12 + xampp 1.7.7 Apache 2.2.21 / Mysql 5.5.16 / PHP 5.3.8
LegalCase 0.7.3 MagicLinux 2.5.12 + xampp 1.7.7 Apache 2.2.21 / Mysql 5.5.16 / PHP 5.3.8
ATutor 2.0.3 MagicLinux 2.5.12 + xampp 1.7.7 Apache 2.2.21 / Mysql 5.5.16 / PHP 5.3.8
B2evolution 4.1.3 MagicLinux 2.5.12 + xampp 1.7.7 Apache 2.2.21 / Mysql 5.5.16 / PHP 5.3.8
FreeRealty 3.1-0.6 MagicLinux 2.5.12 + xampp 1.7.7 Apache 2.2.21 / Mysql 5.5.16 / PHP 5.3.8
glpi 0.80.7 Deepin Linux 11.12 + xampp 1.7.7 Apache 2.2.21 / Mysql 5.5.16 / PHP 5.3.8
osCommerce 2.3.1 Deepin Linux 11.12 + xampp 1.7.7 Apache 2.2.21 / Mysql 5.5.16 / PHP 5.3.8
WebAuction 0.3.11 Deepin Linux 11.12 + xampp 1.7.7 Apache 2.2.21 / Mysql 5.5.16 / PHP 5.3.8
Joomla 2.5.3 Ylmf 4.0 + xampp 1.7.7 Apache 2.2.21 / Mysqli 5.5.16 / PHP 5.3.8
e107 1.0 Ylmf 4.0 + xampp 1.7.7 Apache 2.2.21 / Mysql 5.5.16 / PHP 5.3.8
Gallery 3.0.2 Ylmf 4.0 + xampp 1.7.7 Apache 2.2.21 / Mysqli 5.5.16 / PHP 5.3.8
phpScheduleIt 2.0.2 PC-BSD 9 Apache 2.2.21 / Mysql 5.5.17 / PHP 5.3.8
Care2X 2.6.27 PC-BSD 9 Apache 2.2.21 / Mysql 5.5.17 / PHP 5.3.8
osCMax 2.5PL1 PC-BSD 9 Apache 2.2.21 / Mysql 5.5.17 / PHP 5.3.8

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 :

1. Setup a working Linux environment with Apache and PostgreSQL/MySQL/SQLite fully installed and started.
2. Download ck-erp-0.31.1.tar.gz from http://sourceforge.net/projects/ck-erp.
3. Untar the CK-ERP software tarball into the target middleware's designated folder/directory.

Target MiddleWare Designated Folder/Directory
PSCafePOS 2.0.5 {pscafepos root}/management/
OpenBiblio 0.7.1 {openbiblio root}/admin/
glpi 0.80.7 (glpi root)/plugins/
LegalCase 0.7.3 (legalcase root)/
OpenEMR 4.1.0 (openemr root)/accounting/
eGroupWare 1.8.002 (egroupware root)/
Zencart 1.5.0 (zencart root)/admin/
Joomla 2.5.3 (joomla root)/modules/
Drupal 7.12 (drupal root)/modules/
Moodle 2.2.2 (moodle root)/admin/
VtigerCRM 5.3.0 (vtigercrm root)/modules/
phpBB 3.0.10 (phpbb root)/
TikiWiki 8.3 (tikiwiki root)/
WordPress 3.3.1 (wordpress root)/wp-admin/
Xaraya 2.2 (xaraya root)/html/code/modules/
ATutor 2.0.3 (atutor root)/mods/
B2evolution 4.1.3 (b2evolution root)/blogs/
e107 1.0 (e107 root)/e107_plugins/
HordeGroupware 4.0.6 (hordegroupware root)/
XOOPS 2.5.4 (xoops root)/htdocs/modules/
osCommerce 2.3.1 (oscommerce root)/catalog/admin/
OpenX 2.8.8 (openx root)/plugins/
LandShop 0.9.2 (landshop root)/admin/
MyHandyRestaurant 0.8.5 (myhandyrestaurant root)/manage/
phpMySport 1.4 (phpmysport root)/
AssetMan 2.5b (assetman root)/
Coppermine 1.5.18 (coppermine root)/plugins/
Gallery 3.0.2 (gallery root)/modules/
FusionTicker Beta6 (fussionticket root)/admin/
WebAuction 0.3.11 (webauction root)/
OpenJournal 2.3.7 (openjournal root)/plugins/
OpenConference 2.3.5 (openconference root)/plugins/
FladsClassified 110722 (fladsclassified root)/plugins/
WebCalendar 1.2.5 (webcalendar root)/
phpScheduleIt 2.0.2 (phpscheduleit root)/plugins/
OpenCATS 0.9.1a (opencats root)/modules/
HotelDruid 1.3.2 (hoteldruid root)/
FreeRealty 3.1-0.6 (freerealty root)/admin/
Care2X 2.6.27 (care2x root)/modules/
osCMax 2.5PL1 (oscmax root)/catalog/admin/

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)/navbars/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
glpi Edit (glpi root)/inc/display.functioin.php to insert [CK-ERP] into glpi's Header menu,
At around line 1222 and below the clause :- $LANG['Menu'][11]."\">".$LANG['Menu'][11]."</a></li>";
add the following phrase - echo "<li><a href='../plugins/ck-ledger/index.php' title='CK-ERP'>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)/(glpi root)/plugins/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
OpenEMR Edit (openemr root)/interface/main/left_nav.php to insert [CK-ERP] into OpenEMR's left sidebar menu display,
At around line 1337 and before the clause :- <?php } // end not athletic team ?>
add the following phrase - <li><a class="collapsed" id="misimg" ><span><?php xl('CK-ERP','e') ?></span></a><ul><?php genMiscLink('RTop','prf','0',xl('CK-ERP'),'../accounting/ck-ledger/index.php'); ?></ul>
- 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
NOTE: In your zencart installation, the folder /admin/ may have been renamed to say /zzz/. In such case, change all occurrences of /admin/ in the above passage to /zzz/
Joomla Login to Joomla Administration
Create Top Menu [CK-ERP] choice
- Menu -> Top -> New -> Iframe Wrapper -> Menu Title: CK-ERP; Template Style: Beez2-ParksSite; URL: (domain)/(joomla root)/modules/ck-ledger/ ; Scroll Bar Height: 1500; AutoHeight: Yes -> Save
- Logout of Joomla Administration
- Login to Joomla site frontend as a user named [admin].
- 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
- Structure -> blocks -> add block -> Block Title: CK-ERP Block; Block description: (any); Block body: <a href="/(drupal root)/modules/./ck-ledger/index.php"> CK-ERP </a> ; Text format: Full HTML -> Save block
- Access Configuration -> Temporary directory: (Set this to the desired location) [Note: this directory must be writable by the web process]
- 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 - Settings -> Front page settings -> Turn editing on
- Add a Block -> 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> -> Update -> Page contexts: display throughout the entire site -> Save changes
- If necessary, adjust positioning of the [CK-ERP] block
- Site Administration -> Users -> Permissions -> Define roles -> Add a new role -> Role Name: CK-ERP-user; Short name: ck-erp-user; Role archetype: Manager; Context types where this role may be: System -> Save changes
- Site Administration -> Users -> Permissions -> Assign system roles -> CK-ERP-user -> 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 254 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
phpBB Edit (phpbb root)/styles/prosilver/template/overall_header.html to insert [CK-ERP] into phpBB's header menu display,
At around line 140 and below the clause - {L_PRINT_PM}</a></li><!-- ENDIF -->
add the following phrase - ..... <li class="linklist rightside"><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)/(phpbb root)/ck-admin/index.php
TikiWiki - Access Admin -> Community -> Enable (Advanced) Preference Filters Activate -> [User Files] -> Change preferences
- 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 -> Custom Modules -> Create new custom 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> -> Create
- Access Admin -> Modules -> Assigned Modules -> Add modules -> Module name: CK-ERP -> Position: Top; Order: 4; Groups: Admins, Anonymous, Registered -> Assign
- [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 210 and before the clause - $menu[99] = array( '', 'read', 'separator-last', '', 'wp-menu-separator' );
add the following line - $menu[91] = array(__('CK-ERP'), 'edit_posts', 'ck-ledger/index.php', '', 'menu-top menu-icon-plugins', 'menu-plugins', '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 Create CK-ERP entrance block at left hand column
Getting Started -> Blocks -> New Block -> Parent Module / Type: base/content; Name: CK-ERP; Title: CK-ERP; Block Group: left -> Create -> Content: <a href="code/modules/ck-ledger/index.php">CK-ERP</a> ; Content Type: HTML -> Update
- [Adjust the positioning of the CK-ERP block, as desired]
- 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)/code/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 114 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 1272 and after 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
Copy the file, (full path of horde-groupware root)/ck-api/horde/registry.local.php , to the folder, (full path of horde-groupware root)/config/ ,
- Access Administration -> Configuration -> Horde (horde) -> 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)
XOOPS Create CK-ERP entrance block at left hand column
- Adminstration menu -> (Control Panel Home) -> Blocks -> Add 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> ; Content Type: HTML; Groups: Webmasters,Registered Users, Anonymous Users -> Submit
- [Adjust the positioning of the CK-ERP block, as desired]
- 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 -> (Control Panel Home) -> Groups (Module Access rights section)]
osCommerce Edit (osc root)/catalog/admin/includes/header.php to insert a [CK-ERP] entry into the header menu,
At around line 23 and after the clause :- <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)/modules/gallery/views/login_current_user.html.php to insert [CK-ERP] into Gallery's header menu,
At around line 2 and after the clause :- <li>
add the following phrase - <?= t("%name &nbsp&nbsp", array("name" => html::mark_clean("<a href='http://(domainname or localhost/gallery/modules/./ck-ledger/' title='CK-ERP' id=''>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)/(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_link'> 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 40, 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 122, and after 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://(domainname or localhost)/(fladsclassified root)/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 68, 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)/tpl/globalheader.tpl to insert [CK-ERP] into phpScheduleIT's header menu,
At around line 98 and below the clause :- .... {if $CanViewAdmin}
add the following phrase - <li class="menubaritem"><a href="{$Path}../plugins/ck-ledger">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)/(phpscheduleit root)/plugins/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
HotelDruid Edit (hoteldruid root)/themes/sim/php/head.php to insert [CK-ERP] into hoteldruid's header menu,
At around line 287 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)/(hoteldruid root)/ck-admin/index.php
Care2X Utilize a database client program or phpMyAdmin or other similar mechanism to execute the sql statement listed below, in order to insert [CK-ERP] into Care2X' left hand column menu,
The same effect may also be acheived by appending the sql statement at end of the following file, (full path of care2x root)/installer/db/sql/mysql_dump.sql , before the actual installation of Care2X itself.
SQL statement: INSERT INTO care_menu_main VALUES ('99', '88', 'CK-ERP', '', 'LDCK-ERP', 'modules/ck-ledger/index.php', '1', '', '', 20030922232015, 00000000000000);
- 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
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
osCMax Utilize a database client program or phpMyAdmin or other similar mechanism to execute the sql statement listed below, in order to insert [CK-ERP] into osCMax' left hand column menu,
The same effect may also be acheived by appending the sql statement at end of the following file, (full path of oscmax root)/catalog/install/oscmax.sql , before the actual installation of osCMax itself.
SQL statement: INSERT INTO quick_links VALUES (99, 'CK-ERP', 'ck-ledger/index.php', '_top', 99, '1,2', now(), now(), '../../ck-admin/images/abacus.png');
- AT THIS POINT, DO NOT CLICK ON THE [CK-ERP] MENU CHOICE.
- Instead use your browser to visit directly http://(domainname or localhost)/(oscmax root)/catalog/admin/ck-ledger/index.php
NOTE: In your osCMax installation, the folder /admin/ may have been renamed to say /zzz/. In such case, change all occurrences of /admin/ in the above passage to /zzz/

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____Cash and Myself___Myself, via [ck-crm] -> Customer Info -> Start Search -> Edit.
19. Adjust the Primary and Secondary Tax of vendor, Myself___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 CK-ERP. You are using CK-ERP or any derivative of CK-ERP 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
Starting from v.0.28.1, facility to upgrade from previous versions has been added.

Special Handling

Last Updated: 2012-04-14