VirtueMart - 1.0 開発者ガイド

VM still contains some code parts from phpShop, but experiences phpShop coders will see similarities.

So when you have experience with phpShop or you are to integrate an existing Add-On for phpShop into VM,
you will have to know what is the difference between both scripts.

1.

VM has introduced several new parameters and parameter name changes.

page

Syntax Change Most important is the change of the page parameter syntax from a pattern
like "shop/index" to "shop.index" just to provide support for Search Engine Friendly
(SEF) links in your Joomla site. All references to the paramter page that contain a slash
instead of a dot will not be recognized and VM will print out "module not found" error.

offset

Outdated/removed The offset parameter was completely replaced by the parameter "limit-
start", which is Joomla standard for page navigation. Although there's a global
workaround to fill $offset with the value of $limitstart it's not recommended to work with
offset.

limitstart

The limitstart parameter is the replacement for offset and can be used just like this.

Itemid

This parameter is new and not VM-specific. It's a mandatory parameter that tells Joomla,
which Menu Item is selected and active, so the pathway can be written correctly (Home -
> Online-Shop) and modules which shall only be shown on specific pages are hidden/
shown.

2.

phpShop has its own database class: ps_DB, in a file called db_mysql.inc. This database class has been
completely modified to be a wrapper class for the Joomla Standard Database Class 'database'. The new file-
name is

ps_database.php

. The class name is still ps_DB, but its a Child Class of the Joomla database

class (class ps_DB extends database) and inherits all methods and properties. This has a lot of advantages:
the class is safe against Joomla database class changes and it provides backward compatibility for the
masses of database calls and queries in the scripts (which don't use the Joomla functions, but the phpShop
functions!). VM doesn't connect to the database, but it uses the connection Joomla has built up. This is for
optimal performance since VM doesn't connect to the database each time a query is to be run.

3.

Table names have changed and got a prefix!! Use

#__{vm}_tablename

instead of tablename. The

#__

stands for the dynamic Joomla table name prefix. The

{vm}

stands for the dynamic table name prefix of

VM which allows to have more than one shop in one database.

The database structure of phpShop had to be changed, because Joomla provides an excellent framework
with session handling and user management. The following tables have been removed:

•

auth_user_md5 (jos_users stores passwords)

•

intershipper

•

language

•

sessions

There have been added several tables: jos_pshop_affiliate, jos_vm_affiliate_sale, jos_vm_creditcard,
jos_vm_manufacturer,

jos_vm_manufacturer_category,

jos_vm_product_download,

jos_vm_product_mf_xref, jos_vm_product_reviews, jos_vm_product_votes, jos_vm_shipping_carrier,
jos_vm_shipping_rate, jos_vm_visit, jos_vm_waiting_list, jos_vm_zone_shipping.

4.

VirtueMart Developer Manual

2