Project

General

Profile

Coding standards and hints for Virtuemart » History » Version 6

Max Milbers, 02/25/2011 11:39 PM

1 1 Max Milbers
h1. Coding standards and hints for Virtuemart
2
3 3 Max Milbers
In general we avoid the use of globals. Globals are hard to maintain and they are unsure variables. 
4
5 1 Max Milbers
h2. Code Formatting:
6
7 4 Max Milbers
We follow the joomla standard in most cases. We use camelCase for methods. For faster copypasting and working with database fields, both variable and database fields are lowercase and seperated with "_". You may use for internal variables camelCase also.
8 1 Max Milbers
9
Example:
10
11
12
<pre>
13
function exampleMethod($data = 0) {
14
    if (!$product_id) $product_id = JRequest::getInt('product_id', 0);
15
    if ($product_id > 0) {
16
        ...;
17
    }
18
}
19
</pre>
20
21
h2. SQL Formatting:
22
23
The queries should follow this format:
24
25
@$q  = 'SELECT `example_id` FROM  `#__vm_table` WHERE `user_id`=' . (int)$user_id;@
26
27
or if the
28
29
$user_id is an array, use $user_id["myId"]
30
31
Placing of the ` improves speed, because the sql-engine can parse faster ( and do not have to reparse).
32
33
h2. Variable Formatting:
34
35
Due abstract logic many people name their variables or database fields just "id", "key", "value" and so on.
36
37
In our case we want to rewrite the structure of an old code, therefore it is very important to find the variable in the code rather fields in the database.
38
39
So we want a kind of this: <classname><tablename>variable like here
40
41
$vendor_id or $payment_method_id
42
43
Exception from this rule is the use of ordering and published. Ordering and published with 0 and 1 as values are useable with the joomla standard methods.
44
45
h2. Filename Formatting:
46
47
Filenames should be lowercase.
48
49
Models filenames (mymodel.php), view direcorynames (myview), all helper files and probably all other files loaded by the Joomla Framework, must be lowercase, no matter how you load the file:
50
51
 @$this->loadHelper('adminMenu'); // looks for the file helpers/adminmenu.php@
52
53
More complex filenames that are specific to your task and loaded by your own code (using require_once()), e.g. mySpecificClass.php, can be camelcase.
54
55
Read this article for more info http://docs.joomla.org/Talk:Developing_a_Model-View-Controller_Component_-_Part_1#Use_lowercase_file_and_folder_names_in_your_components.21 
56
57
h2. Table names
58
59
Depending on the way mysqld is configured, the MySQL server might be case sensitive on linux systems too, so _always_ use the correct case, preferably lowercase only.
60
61
h2. URL Requests:
62
63
As written in the section __Filename Formatting__ above, Joomla requires lowercase filenames. However, URL requests are not lowercased by Joomla. In order to find the proper views and controllers, make sure you use lowercase only in requests, e.g.:
64
65
  $this->setRedirect('index.php?option=com_virtuemart&view=updatesMigration', $msg); // Fails
66
$this->setRedirect('index.php?option=com_virtuemart&view=updatesmigration', $msg); // Works
67
68
69
h2. Character Encoding:
70
71
Like in joomla we use UTF-8. Please ensure the right character set in your IDE.
72 2 Max Milbers
73 6 Max Milbers
h2. Path constants
74 1 Max Milbers
75 6 Max Milbers
Always use:
76
77
JPATH_VM_SITE for the frontend (points to JPATH_SITE.DS.'components'.DS.'com_virtuemart')
78
JPATH_VM_ADMINISTRATOR for the backend (points to JPATH_SITE.DS.'components'.DS.'com_virtuemart')
79
80
This is important for performance and that all pieces of code work in every application that means, plugins, modules and so on.
81
82 2 Max Milbers
h2. Standard publishing fields use:
83
84
- published with 0 and 1 formatted in the db as tinyInt(1) with standard 0
85
- publish_up and publish_down formatted in the db as datetime with standard 0000-00-00 00:00:00
86
87
The standard query is then 
88
89 5 Max Milbers
	@ $db = &JFactory::getDBO();
90
	$this->_nullDate = $db->getNullDate();
91
	$this->_now        = JFactory::getDate()->toMySQL();
92
93
 $query  = 'SELECT * FROM `#__sometable` WHERE yourexampel ="myexampelvalue" AND ';
94
 $query .= ' ( publish_up = '.$this->_db->Quote($this->_nullDate).' OR publish_up <= '.$this->_db->Quote($this->_now).' )' .
95
 ' AND ( publish_down = '.$this->_db->Quote($this->_nullDate).' OR publish_down >= '.$this->_db->Quote($this->_now).' ) '; @