VirtueMart

h1. Setting up a Development Environment

h2. Introduction

If you start developing for the project or just with VirtueMart you may have already set up a development environment with an IDE and a SVN program. 

If you haven't done so or if you want to know what to do better, you can follow the instructions given on this page. 

The following programs are recommended for working with VirtueMart and synchronizing the working directory with the local SVN repository: 

* SmartSVN or TortoiseSVN http://tortoisesvn.net/downloads.html

* Eclipse for php or aptana (very good PHP IDE and free!)

Of course there are other programs that can do the same as the ones mentioned above, but remember: these are just recommendations. You need in everycase jdump installed.

h2. Setup an IDE and SVN

If you want to join the project it is important that you have a similar environment like the other devs, so it makes it easier for everyone to help each other. 

First setup up an IDE, I suggest you follow the explanations here: http://docs.joomla.org/Setting_up_your_workstation_for_Joomla!_development 

For development and testing we use JDump (http://extensions.joomla.org/extensions/miscellaneous/development/1509). In official releases (beta, RC and, of course, final), all dump() calls are removed or outcommented, but for SVN checkouts of development releases this extension is required.

h3. SVN-Basics: 

For pure installation information look at the chapter "Installation of virtuemart into your IDE". The SVN folder structure is setup with 3 root folders; trunk, tags and branches. The trunk folder is used for curent active development. The tags folder is used for public releases. The branches folder can be used for code branches. 

The structure found under these root folders mimic the structure in a typical Joomla installation, however, only contain the VirtueMart code. This gives us the ability to easily commit and checkout directly from a Joomla installation as described above. 

There are 3 different folders for backend, frontend and modules 

* trunk/virtuemart/administrator/components/com_virtuemart ;pure vm

* trunk/virtuemart/administrator/language                  ;mixed

* trunk/virtuemart/components/com_virtuemart ;             ;pure vm

* trunk/virtuemart/language                                ;mixed

* trunk/virtuemart/plugins                                 ;mixed

* trunk/virtuemart/plugins/vmpayment                       ;pure vm

* trunk/virtuemart/modules/                                ;mixed

The /trunk is your joomla base root = jRoot. 

At best is if you have a joomla installation and make 1 checkout for back and frontend. Use for checkout on the joomla base root: 

svn co https://dev.virtuemart.net/svn/virtuemart/trunk/virtuemart 

After updating you should have the newest version of VirtueMart 

If you want to check the mails you may want to use hamster as mailserver

h2. Installation of virtuemart into your IDE

Now there are two ways. Be aware that the joomla installation should work.

h3. Use the virtuemart installer to set the right entries for using virtuemart. 

This step just needs that you manually delete the virtuemart files after the installation to be able to perform the checkout (most svn clients dont overwrite existing files). 

# This means download or create the installer of virtuemart and install it in joomla [[Create virtuemart installer]]. 

# Download also the all-in-one payment plugin installer at http://dev.virtuemart.net/redmine/issues/73

# Before you can checkout the svn you should delete the files that are installed by the vm installer. Just delete this directories 

* administrator/components/com_virtuemart 

* components/com_virtuemart 

* plugins/vmpayment

and to prevent warnings the language files named en-GB.com_virtuemart.ini in 

* administrator\language 

* language 

# AFTER that configure the SVN, directly into your joomla base directory.

h3. Use the right sql to inform joomla that virtuemart exists.

# Just make a checkout directly into your joomla base directory. 

# Then execute the following sql commands with phpmyadmin. Be aware that these sql assume that you use the prefix jos for your tables.

This is for virtuemart:

with joomla 1.5

<pre>

INSERT INTO `jos_components` (`id`, `name`, `link`, `menuid`, `parent`, `admin_menu_link`, `admin_menu_alt`, `option`, `ordering`, `admin_menu_img`, `iscore`, `params`, `enabled`) VALUES

(NULL, 'VirtueMart', 'option=com_virtuemart', 0, 0, 'option=com_virtuemart', 'VirtueMart', 'com_virtuemart', 0, '../components/com_virtuemart/shop_image/ps_image/menu_icon.png', 0, '', 1);

</pre>

with joomla 1.6

<pre>

INSERT INTO `jos_extensions` (`extension_id`, `name`, `type`, `element`, `folder`, `client_id`, `enabled`, `access`, `protected`, `manifest_cache`, `params`, `custom_data`, `system_data`, `checked_out`, `checked_out_time`, `ordering`, `state`) VALUES 

(10007, 'virtuemart', 'component', 'com_virtuemart', '', 0, 1, 0, 0, '{"legacy":true,"name":"VirtueMart","type":"component","creationDate":"May 2011","author":"The VirtueMart Development Team","copyright":"\\tCopyright (C) 2011 The Virtuemart Team. All rights reserved.","authorEmail":"soeren|at|virtuemart.net","authorUrl":"http:\\/\\/www.virtuemart.net","version":"2.0.0","description":"Online-Shop \\/ Complete E-Commerce system for Joomla 1.6","group":""}', '{}', '', '', 0, '0000-00-00 00:00:00', 0, 0);

</pre>

and 

<pre>

INSERT INTO `jos_menu` (`id`, `menutype`, `title`, `alias`, `note`, `path`, `link`, `type`, `published`, `parent_id`, `level`, `component_id`, `ordering`, `checked_out`, `checked_out_time`, `browserNav`, `access`, `img`, `template_style_id`, `params`, `lft`, `rgt`, `home`, `language`, `client_id`) VALUES 

(465, 'main', 'VirtueMart', 'virtuemart', '', 'virtuemart', 'index.php?option=com_virtuemart', 'component', 0, 1, 1, 10007, 0, 0, '0000-00-00 00:00:00', 0, 1, '../components/com_virtuemart/assets/images/vmgeneral/menu_icon.png', 0, '', 277, 278, 0, '', 1);

</pre>

For information on adding the plugins, please refer to [[Plugin system]].

For information on adding the modules, please refer to [[Modules system]].