Skip to content

Install

pHAlkaline edited this page Mar 24, 2023 · 140 revisions

No technical knowledge?

For those who have no technical knowledge, Contact pHAlkaline, for all the necessary services to put this software at your service.

Free support at https://groups.google.com/group/phkondo

Requirements

  • HTTP Server ( APACHE2, NGINX, IIS ).
  • Apache. mod_rewrite is preferred, but by no means required
  • Database ( MariaDB , MySql, SqlServer )
  • PHP >7.0.0 && <8.0.0.
  • All built-in drivers require PDO. You should make sure you have the correct PDO extensions installed.
  • Fileinfo PHP Extention Enabled
  • NOT MANDATORY, but requires wkhtmltopdf for PDF generation.

If you are unsure whether your server meets these requirements, please check with your host or webmaster before proceeding with the installation.

Create Database

Create a new MySQL database (utf8 charset and utf8_general_ci collation)

With downloaded .zip from pHKondo

Extract zip file to your [phkondo_directory]

Set [phkondo_directory]/app/tmp directory to writable

Open http://[pHKondoURL]/install or go to manual install -> https://github.com/pHAlkaline/phkondo/wiki/Install#manualy

Check your settings at https://github.com/pHAlkaline/phkondo/wiki/Settings

With Composer

You can install pHKondo using Composer

Run:

php composer.phar create-project phalkaline/phkondo [phkondo_directory]

If Composer is installed globally, run:

composer create-project -s stable phalkaline/phkondo [phkondo_directory] for stable version

composer create-project -s dev phalkaline/phkondo [phkondo_directory] for latest dev version

Set [phkondo_directory]/app/tmp directory to writable

Open http://[pHKondoURL]/install or Goto -> https://github.com/pHAlkaline/phkondo/wiki/Install#manualy

Check your settings at https://github.com/pHAlkaline/phkondo/wiki/Settings

With Git and Composer

Run:

git clone https://github.com/pHAlkaline/phkondo.git [phkondo directory]

cd [phkondo directory]

git tag -l to see Tagged versions list

git checkout tags/[tag_name] where [tag_name] is your selected stable version, or skip, if you want to keep master ( latest but unstable version )

composer update

Set [phkondo_directory]/app/tmp directory to writable

Open http://[pHKondoURL]/install or Goto -> https://github.com/pHAlkaline/phkondo/wiki/Install#manualy

Check your settings at https://github.com/pHAlkaline/phkondo/wiki/Settings

With downloaded .zip from GitHub

Extract zip file to your [phkondo_directory]

Use composer

cd [phkondo directory]

composer update

Set [phkondo_directory]/app/tmp directory to writable

Check your settings at https://github.com/pHAlkaline/phkondo/wiki/Settings

Open http://[pHKondoURL]/install or Goto -> https://github.com/pHAlkaline/phkondo/wiki/Install#manualy

Manual Install

Copy [phkondo_directory]/app/Config/core_app.php.default and save as core_app.php

Copy [phkondo_directory]/app/Config/bootstrap_app.ini.default and save as bootstrap_app.ini

Copy [phkondo_directory]/app/Config/email.php.default and save as email.php

Copy [phkondo_directory]/app/Config/email_notifications.php.default and save as email_notifications.php

Copy [phkondo_directory]/app/Config/organization.php.default and save as organization.php

Copy [phkondo_directory]/app/Config/database.php.default and save as database.php

Edit this files to setup your configurations

Goto -> https://github.com/pHAlkaline/phkondo/wiki/Install#set-database

Set Database

Create a new MySQL database (utf8 charset and utf8_general_ci collation) if not already ..

Config database access

Edit [phkondo_directory]/app/Config/database.php, change the details for your database connection at $default and save.

Create database tables

With SQL Files

in your SQL Editor/PHPMyAdmin run these two SQL dump files in given order:

[phkondo_directory]/app/Config/Schema/phkondo.sql

[phkondo_directory]/app/Plugin/Feedback/Config/Schema/feedback.sql

Load tables data

in your SQL Editor/PHPMyAdmin run this SQL dump file:

[phkondo_directory]/app/Config/Schema/phkondodata.sql

other translated files available.

[phkondo_directory]/app/Config/Schema/phkondodata_eng.sql English

[phkondo_directory]/app/Config/Schema/phkondodata_por.sql Portuguese and others....

demonstation condo data can be loaded with

[phkondo_directory]/app/Config/Schema/phkondo-democondo.sql .. others also available

Translations

For database data translation edit [phkondo_directory]/app/Config/Schema/phkondodata.sql before install

Goto ( IMPORTANT STEP ) -> https://github.com/pHAlkaline/phkondo/wiki/Install#secure

Secure ( IMPORTANT STEP in Manual )

Use your command line

goto [phkondo_directory]/app directory.

run these commands by this order

Console\cake Secure

Console\cake ResetPasswords

notice output with updated passwords

Check your settings at https://github.com/pHAlkaline/phkondo/wiki/Settings

Run

Open http://[pHKondoURL]/ Or Open http://[pHKondoURL]/install

PDF Files

To output PDF files pHKondo requires wkhtmltopdf engine at your system https://www.wkhtmltopdf.org/

edit [phkondo_directory]/app/Config/bootstrap_app.ini file,

You will find settings for CakePdf

Look for CakePdf.binary and set full path to your wkhtmltopdf engine ex: CakePdf.binary = /usr/local/bin/wkhtmltopdf Look for CakePdf.phkondo.active and set true ex: CakePdf.phkondo.active = true

Have fun!!