You are on page 1of 5

Vfront Installation Guide

The instructions to get Vfront going on your system are:


Download the latest copy of the code from:
http://sourceforge.net/projects/vfront/files/
Please download the latest zip version from the above URL.
Unzip the contents to a folder within your docroot and name the folder as vfron
t.
In the case of my system, it is at C:\Apache\htdocs\vfront
Now access the installation folder of vfront in the docroot and go to the folder
C:\Apache\htdocs\vfront\conf and rename the config file present to conf.vfront.
php.
Now access the installation URL of vfront:
In my case it is http://localhost/vfront/_install/
Youll be able to configure using these install options:
On the first screen, Select English and UTF-8.
In the remaining screens, enter the relevant details for DB connection detai
ls. These are the same details you entered when creating the database in the SQL
Yog step.
Also for the remaining screens do remember the FRONT_ROOT setting is C:/Apac
he/htdocs/vfront
and doc_root is http://localhost/vfront
Also fill in the other details of Admin user. This are the details youll requ
ire to administer the vfront application.
On successful completion of the installation, youll encounter the login screen li
nk. If you click this and everything was OK, it should display the login page.
PLEASE NOTE: This wont work because the code isnt Win32 friendly and I realized th
is over 3 hrs of research. The code is buggy. But there are three fixes required
for the app to work perfectly.
Fix No. 1 After going through the entire installation steps, you need to patch t
he Config file.
Now again access the installation folder of vfront in the docroot and go to the
folder C:\Apache\htdocs\vfront\conf and open conf.vfront.php in EditPlus or some
other coding utility.
Make the following changes:
$db1[ dbtype ]="mysql";
$db1[ host ]="localhost";
$db1[ port ]="3306";
$db1[ user ]=" DBusername";
$db1[ passw ]=" DBPassword";

$db1[ dbname ]="DBname";


$db1[ frontend ]="vfront_Dbname";
define( FRONT_LANG , en_US );
define( FRONT_ROOT , C:/Apache/htdocs/vfront );
define( FRONT_REALPATH , C:/Apache/htdocs/vfront );
define( FRONT_DOCROOT , http://localhost/vfront );
Fix No. 2 Patch the include for the Config file.
Now after spending 2 hours (Hey, the entire damn code is in Italian) stepping th
rough the code, I found that on a Win32 system, most of the files werent able to
include the Config file as they couldnt find the path.
The following is the patch for the same:
Access the file: C:\Apache\htdocs\vfront\inc\conn.php and edit it using EditPlus
:
Add the following patch:
include $_SERVER[ DOCUMENT_ROOT ]."./vfront/conf/conf.vfront.php";
#before this line $CONF_FILE= conf.vfront.php ;
This ensures that all files get the path as absolute to the doc-root and not rel
ative to the files which was failing.
Fix No. 3
There is a legacy installation validation check related to the failed include of
the Config which also doesnt allow the app to proceed in Conn.php.
NOTE: You need to go through the previous steps and perform the install and then
only do this step (else youre configuration database will be empty).
Make this patch to remove the legacy install validation check:
#$dir_vfront= (eregi( WIN ,$_ENV[ OS ]))
#

? str_replace("\\inc\\conn.php", ,realpath(__FILE__))

: str_replace("/inc/conn.php", ,realpath(__FILE__));

#$POSIZIONE_FILE_CONFIGURAZIONE= ("../conf/".$CONF_FILE);
#$POSIZIONE_FILE_CONFIGURAZIONE = $CONF_FILE;
#if(!is_file($POSIZIONE_FILE_CONFIGURAZIONE)){
#

header("Location: ./_install/");

exit;

#}
#if(!@include_once($POSIZIONE_FILE_CONFIGURAZIONE)){
#
echo "Impossibile includere il file di configurazione. Modificare le
impostazioni del file inc/conn.php";
#

exit;

#}
All the code is commented out to remove the check.
Now using your browser, access the URL:
http://localhost/vfront/index.php
The following login page should be displayed:
VFront - Login Page
VFront Login Page
The main page will be displayed.
Click Administration.
VFront - Admin link
VFront Admin link
Click the below link to synchronize the database information with Vfront.
VFront - Sync DBs
VFront Sync DBs
In the same screen youll see the below link: Click to insert the tables in the fr
ontend.
VFront - Insert Tables
VFront Insert Tables
Post sync, the message will be displayed:
VFront - Sync over
VFront Sync over
Click on the Administration link to access the Admin page:
VFront - Admin Page
VFront Admin Page
Click the link to access DB user settings.
VFront - DB user settings
VFront DB user settings
Create a new user to access the DB.
VFront - User Mgmt
VFront User Mgmt

Fill in the requisite details and click Send.


VFront - User details
VFront User details
After any user-related change ensure you select
VFront Notify Disable
VFront Notify Disable
Now update the user profile created as below:
VFront - Update user profile
VFront Update user profile
Create a new user group other than default profile:
VFront - User Group
VFront User Group
Please ensure you change the user group assignment of all users (newly created t
o the new user group)
The confirmation will be displayed:
VFront confirm
VFront confirm
In the next part of this guide, well discuss how to complete the settings for the
table in VFront and to allow users to edit the database.
Vfront User Guide
Vfront Installation and User Guide Part 2
This article is the 2nd part of the Vfront Installation and User Guide
Post configuring the Vfront installation, we see how we can use the app to work
with DB tables.
Now access the main Admin page and click the below link:
VFront - Registries
VFront Registries
Click Administrate for the user group which youve just created.
VFront - Administrate
VFront Administrate
Click Quick functions.
VFront - Quick functions
VFront Quick functions
Select all the Allow in all tables if you want to give the user group all the ri
ghts (including Delete). Else select only the rights which you want to give the
users.

VFront - Allow all


VFront Allow all
Depending on your selections, the settings will be displayed in the below sectio
n of the page.
Select the table name for editing the settings for the table.
VFront - Table selection
VFront Table selection
Here you can change the General visibility and rights settings for all users in
the app. You can also allow attachments and links using this screen.
VFront - Table settings
VFront Table settings
The Field settings tab gives the settings of the fields in the table.
VFront - Field settings
VFront Field settings
Fields Order tab gives the Order of display of the fields in the table.
VFront - Fields Order
VFront Fields Order
Now leave the Administration section and access the Home link in the menu.
Youll see the Table name is displayed in the Main menu on the Home page.
VFront - Home - Table name
VFront Home Table name
Now click the Table name.
The table is displayed in the view of a form with the first field displayed.
VFront - Form menu
VFront Form menu
Click the Grid View icon to see the grid view of the data in the table:
VFront - Grid view
VFront Grid view
You can also export the table data in the format of your choice:
VFront - Export menu
VFront Export menu
Displayed here is the HTML view of the data:
VFront - Table Html
VFront Table Html

You might also like