Project

General

Profile

Plugin system » History » Version 30

Max Milbers, 07/07/2011 02:09 PM

1 10 Oscar van Eijk
{{>toc}}
2
3 1 Oscar van Eijk
h1. Plugin system
4
5 5 Oscar van Eijk
Since VirtueMart v2, the Joomla! plugin system is used form payment and shipper plugins.
6 1 Oscar van Eijk
7
h2. Installing plugins
8
9
During development the the VM2 branch, the plugins are not available as Joomla install packages, so for test environments, they must be installed manually.
10
11
h3. Payment plugins
12
13
At the time of writing, only 2 of the former payment plugins have been converted to the new plugin system. Others should follow soon, all help is appreciated!!
14
15
Use the SQL query below to add the plugins to your database (assuming the table prefix is "jos_"):
16
17 12 Christopher Roussel
J1.5:
18 1 Oscar van Eijk
<pre>
19 4 Devendra Kumar Shukla
INSERT INTO `jos_plugins` (`id`, `name`, `element`, `folder`, `access`, `ordering`
20 1 Oscar van Eijk
  , `published`, `iscore`, `client_id`, `checked_out`, `checked_out_time`, `params`)
21
VALUES
22
 (NULL, 'VMPayment - Authorize', 'authorize', 'vmpayment', 0, 0, 1, 0, 0, 0, '0000-00-00 00:00:00', '')
23 12 Christopher Roussel
,(NULL, 'VMPayment - Cash on delivery', 'cashondel', 'vmpayment', 0, 0, 1, 0, 0, 0, '0000-00-00 00:00:00','');
24 1 Oscar van Eijk
</pre>
25 12 Christopher Roussel
J1.6:
26
<pre>
27
INSERT INTO `jos_extensions` (`extension_id`,  `type`, `name`, `element`, `folder`, `access`, `ordering`
28
  , `enabled`, `protected`, `client_id`, `checked_out`, `checked_out_time`, `params`)
29
VALUES
30
 (NULL, 'plugin', 'plg_vmpayment_authorize', 'authorize', 'vmpayment', 1, 0, 1, 0, 0, 0, '0000-00-00 00:00:00', '')
31
,(NULL, 'plugin', 'plg_vmpayment_cashondel', 'cashondel', 'vmpayment', 1, 0, 1, 0, 0, 0, '0000-00-00 00:00:00','');
32
</pre>
33 1 Oscar van Eijk
34 13 Max Milbers
Next, when you did not use the svn checkout, copy the plugin files (authorize.php, authorize.xml, cashondel.php and cashondel.xml), located in the folder /plugins/vmpayment, to the Joomla plugin directory. If that doesn't exist, it must be created first.
35 1 Oscar van Eijk
36 19 Valérie Isaksen
Now, in the store maintenance, you can add payment methods based on one of these plugins, then click Apply button to display the appropriate parameters in the configuration tab. Note at this moment it is required to select a vendor!
37 1 Oscar van Eijk
38
h3. Shipper plugins
39 3 Oscar van Eijk
40 1 Oscar van Eijk
This is very similar to the payment plugins. Only 1 plugin has been created (again: all help is appreciated!); 'standard', which provides a basic shipping option for postal services.
41
*Note:* Installing the sample data does _NOT_ provide shipping rates anymore!
42
43
Use the SQL query below to add the plugins to your database (assuming the table prefix is "jos_"):
44
45 12 Christopher Roussel
J1.5:
46 1 Oscar van Eijk
<pre>
47
INSERT INTO `jos_plugins` (`id`, `name`, `element`, `folder`, `access`, `ordering`
48
  , `published`, `iscore`, `client_id`, `checked_out`, `checked_out_time`, `params`)
49
VALUES
50 17 Valérie Isaksen
 (NULL, 'By weight, ZIP and countries', 'weight_countries', 'vmshipper', 0, 0, 1, 0, 0, 0, '0000-00-00 00:00:00', '')
51 14 Valérie Isaksen
;
52 1 Oscar van Eijk
</pre>
53
54 12 Christopher Roussel
J1.6: 
55
<pre>
56
INSERT INTO `jos_extensions` (`extension_id`, `type`, `name`, `element`, `folder`, `access`, `ordering`
57 1 Oscar van Eijk
  , `enabled`, `protected`, `client_id`, `checked_out`, `checked_out_time`, `params`)
58
VALUES
59 16 Valérie Isaksen
 (NULL, 'plugin', 'plg_vmshipper_weight_countries', 'weight_countries', 'vmshipper', 1, 0, 1, 0, 0, 0, '0000-00-00 00:00:00', '')
60 14 Valérie Isaksen
;
61 12 Christopher Roussel
</pre>
62 19 Valérie Isaksen
Next, when you did not use the svn checkout, copy the plugin files (weight_countries.php, weight_countries.xml, products_countries.php and products_countries.XML), located in the folder /plugins/vmshipper, to the Joomla plugin directory. If that doesn't exist, it must be created first.
63 1 Oscar van Eijk
64 19 Valérie Isaksen
Now use the 'Shipping methods' menu item in the backend to add 1 or more shipping methods. Give a shipping method name, select the shipping method,and click Apply button to display the appropriate parameters in the configuration tab. All you need to do here is give the shipper a name and select a vendor (this is optional; when no vendor is selected, this carrier is valid for all vendors).
65
Make sure a there's always a valid shipping rate: the plugin must be able to find a matching rate based on the shipto address!
66 1 Oscar van Eijk
67 5 Oscar van Eijk
h2. Plugin Development
68 1 Oscar van Eijk
69 5 Oscar van Eijk
All plugins for VirtueMart should be developed confirming the Joomla! plugin development methods. Refer to http://docs.joomla.org/Tutorial:Plugins for developers documentation for Joomla! plugins.
70
71 30 Max Milbers
h3. [[Payment Plugins]]
72 5 Oscar van Eijk
73 1 Oscar van Eijk
Payment plugins are used both in the front-end and the backend. They must be created as classes deriving from the base class *vmPaymentPlugin*:
74 30 Max Milbers
75
76 9 Oscar van Eijk
<pre><code class="php">
77 7 Oscar van Eijk
class plgVmPayment<myPlugin> extends vmPaymentPlugin {
78
	function plgVmPayment<myPlugin>(&$subject, $config) {
79
		$this->_pelement = basename(__FILE__, '.php');	// Required!
80
		$this->_createTable();				// Required, see below
81
		parent::__construct($subject, $config);
82
	}
83
}
84 9 Oscar van Eijk
</code></pre>
85 7 Oscar van Eijk
86
Below is the list with events and a description on what moment they are fired.
87 6 Oscar van Eijk
* *plgVmOnSelectPayment()* - This event is fired during the checkout process. It allows the shopper to select one of the available payment methods.
88 5 Oscar van Eijk
It should display a radio button (name: paym_id) to select the payment method. Other information (like credit card info) might be selected as well, depending on the plugin.
89
+Return:+
90
It must return the HTML code for displaying the form (radio button and optional extra selections).
91
+Parameters:+
92
# (VirtueMartCart object) The cart object 
93
# (integer, default 0) ID of an already selected payment method ID, if any
94
95 6 Oscar van Eijk
* *plgVmOnPaymentSelectCheck()* - This event is fired after the payment method has been selected. It can be used to store
96 5 Oscar van Eijk
additional payment info in the cart.
97
+Return:+
98
Plugins that were not selected must return null, otherwise True of False must be returned indicating Success or Failure.
99
+Parameters:+
100
# (VirtueMartCart object) The cart object 
101
102 10 Oscar van Eijk
103
104 6 Oscar van Eijk
* *plgVmOnCheckoutCheckPaymentData()* - This event is fired during the checkout process. It can be used to validate the payment data as entered by the user.
105 5 Oscar van Eijk
+Return:+
106
Plugins that were not selected must return null, otherwise True of False must be returned indicating Success or Failure.
107
+Parameters:+
108
None
109
110 6 Oscar van Eijk
* *plgVmOnConfirmedOrderStorePaymentData()* - This event is fired after the payment has been processed; it stores the payment method-specific data.
111 5 Oscar van Eijk
All plugins _must_ reimplement this method.
112
+Return:+
113
If the plugin is NOT actually executed (not the selected payment method), this method must return NULL
114
If this plugin IS executed, it MUST return the order status code that the order should get. This triggers the stock updates if required
115
+Parameters:+
116
# (integer) The ordernumber being processed
117
# (object) Data from the cart
118
# (array) Price information for this order
119
	
120 6 Oscar van Eijk
* *plgVmOnShowOrderPaymentBE()* - This method is fired when showing the order details in the backend. It displays the the payment method-specific data.
121 5 Oscar van Eijk
All plugins _must_ reimplement this method.
122
+Return:+
123
Null when for payment methods that were not selected, text (HTML) otherwise
124
+Parameters:+
125
# (integer) The order ID
126
# (integer) Payment method used for this order
127
128 6 Oscar van Eijk
* *plgVmOnCancelPayment()* - This event is fired each time the status of an order is changed to Cancelled. It can be used to refund payments, void authorization etc.
129 5 Oscar van Eijk
When reimplementing this methis, the body _must_ start with this code:
130 9 Oscar van Eijk
<pre><code class="php">$_paymethodID = $this->getPaymentMethodForOrder($_orderID);
131 5 Oscar van Eijk
if (!$this->selectedThisMethod($this->_pelement, $_paymethodID)) {
132
	return;
133 9 Oscar van Eijk
}</code></pre>
134 5 Oscar van Eijk
+Parameters:+
135
 (integer The order ID
136
 (char) Previous order status
137
 (char) New order status
138
139 6 Oscar van Eijk
* *plgVmOnShipOrderPayment()* - This event is fired when the status of an order is changed to Shipped. It can be used to confirm or capture payments
140 5 Oscar van Eijk
When reimplementing this methis, the body _must_ start with this code:
141 9 Oscar van Eijk
<pre><code class="php">$_paymethodID = $this->getPaymentMethodForOrder($_orderID);
142 5 Oscar van Eijk
if (!$this->selectedThisMethod($this->_pelement, $_paymethodID)) {
143
	return;
144 9 Oscar van Eijk
}</code></pre>
145 5 Oscar van Eijk
+Return:+
146
True on success, False on failure, Null if this plugin was not activated
147
+Parameters:+
148 1 Oscar van Eijk
# (integer) Order ID
149 7 Oscar van Eijk
150
Other helper functions inherited from the base class:
151
152 9 Oscar van Eijk
* *_ createTable()* - This method is used to create and maintain the plugin specific database table(s).
153 7 Oscar van Eijk
It _must_ be reimplemented by all plugins.
154 1 Oscar van Eijk
+Example:+
155 8 Oscar van Eijk
<pre><code class="php">
156 7 Oscar van Eijk
$_scheme = DbScheme::get_instance();
157
$_scheme->create_scheme('#__vm_order_payment_'.$this->_pelement);
158
$_schemeCols = array(
159
	 'id' => array (
160
			 'type' => 'int'
161
			,'length' => 11
162
			,'auto_inc' => true
163
			,'null' => false
164
	)
165
	,'order_id' => array (
166
			 'type' => 'int'
167
			,'length' => 11
168
			,'null' => false
169
	)
170
	,'payment_method_id' => array (
171
			 'type' => 'text'
172
			,'null' => false
173
	)
174
);
175
$_schemeIdx = array(
176
	 'idx_order_payment' => array(
177
			 'columns' => array ('order_id')
178
			,'primary' => false
179
			,'unique' => false
180
			,'type' => null
181
	)
182
);
183
$_scheme->define_scheme($_schemeCols);
184
$_scheme->define_index($_schemeIdx);
185
if (!$_scheme->scheme()) {
186
	JError::raiseWarning(500, $_scheme->get_db_error());
187
}
188
$_scheme->reset();
189 8 Oscar van Eijk
</code></pre>
190 7 Oscar van Eijk
191 8 Oscar van Eijk
* *getPaymentMethodForOrder()* - Get the order payment ID for a given order number
192 7 Oscar van Eijk
+Return:+
193
The payment method ID, or -1 when not found 
194
+Parameters:+
195
# (integer) The order ID
196
197 8 Oscar van Eijk
* *getThisMethodName()* - Get the name of the payment method.
198 7 Oscar van Eijk
This method can _not_ be reimplemented
199
+Return:+
200
Paymenent method name
201
+Parameters:+
202
# (integer) The payment method ID
203
204 8 Oscar van Eijk
* *selectedThisMethod()* - This method checks if the selected payment method matches the current plugin
205 7 Oscar van Eijk
+Return:+
206
True if the calling plugin has the given payment ID, False otherwise.
207
+Parameters:+
208
# (string) Element name, taken from the plugin filename
209
# (integer) The payment method ID
210
211 8 Oscar van Eijk
* *writePaymentData()* - This method writes all payment plugin specific data to the plugin's table
212 7 Oscar van Eijk
+Return:+
213
True if the calling plugin has the given payment ID, False otherwise.
214
+Parameters:+
215
# (array) Indexed array in the format 'column_name' => 'value'
216 1 Oscar van Eijk
# (string) Table name
217 10 Oscar van Eijk
218 30 Max Milbers
h3. [[Shipper Plugins]]
219 10 Oscar van Eijk
220
Shipper plugins are used both in the front-end and the backend. They must be created as classes deriving from the base class *vmShipperPlugin*:
221
<pre><code class="php">
222
class plgVmShipper<myPlugin> extends vmShipperPlugin {
223
	function plgVmPayment<myPlugin>(&$subject, $config) {
224
		$this->_pelement = basename(__FILE__, '.php');	// Required!
225
		$this->_createTable();				// Required, see below
226
		parent::__construct($subject, $config);
227
	}
228
}
229
</code></pre>
230
231
Here's a short overview of the events:
232
* When a shopper selects a shipper, *plgOnSelectShipper()* is fired. It displays the shipper and can be used for collecting extra - shipper specific - info.
233
* After selecting, *plgVmShipperSelected()* can be used to store extra shipper info in the cart. The selected shipper ID will be stored in the cart by the checkout process before this method is fired.
234
* *plgOnConfirmShipper()* is fired when the order is confirmed and stored to the database. It is called before the rest of the order or stored, when reimplemented, it _must_ include a call to parent::plgOnConfirmShipper() (or execute the same steps to put all data in the cart)
235
236
When a stored order is displayed in the backend, the following events are used:
237
* *plgVmOnShowOrderShipperBE()* displays specific data about (a) shipment(s) (NOTE: this plugin is _OUTSIDE_ any form!)
238
* *plgVmOnShowOrderLineShipperBE()*) can be used to show information about a single orderline, e.g. display a package code at line level when more packages are shipped.
239
* *plgVmOnEditOrderLineShipperBE() can be used add a package code for an order line when more packages are shipped.
240
* *plgVmOnUpdateOrderShipperBE()* is fired inside a form. It can be used to add shipper data, like package code.
241
* *plgVmOnSaveOrderShipperBE()* is fired from the backend after the order has been saved. If one of the show methods above have to option to add or edit info, this method must be used to save the data.
242
* *plgVmOnUpdateOrderLine()* is fired from the backend after an order line has been saved. This method must be reimplemented if plgVmOnEditOrderLineShipperBE() is used.
243 22 Valérie Isaksen
* *plgVmOnShipperSelectedCalculatePrice()* is fired before the order is saved, and used to calculate the cart prices. 
244
* *plgVmOnConfirmedOrderStoreShipperData()* This event is fired after the order has been stored; it gets the shipping method specific data.
245 10 Oscar van Eijk
246
The frontend 1 show method:
247
* plgVmOnShowOrderShipperFE() collects and displays specific data about (a) shipment(s)
248
249
Below is the list with events and a description on what moment they are fired.
250
251
* *plgVmOnSelectShipper()* - This event is fired during the checkout process. It allows the shopper to select one of the available shippers.
252
It should display a radio button (name: shipper_id) to select the shipper. In the description, the shipping cost can also be displayed, based on the total order weight and the shipto country (this wil be calculated again during order confirmation)
253
+Return:+
254
HTML code to display the form
255
+Parameters:+
256
# (VirtueMartCart object)  Cart object
257
# (integer, default 0) ID of the currently shipper selected
258
259
* *plgVmOnShipperSelected()* - This event is fired after the shipping method has been selected. It can be used to store additional shipper info in the cart.
260
+Return:+
261
True on succes, false on failures, null when this plugin was not selected.
262 1 Oscar van Eijk
On errors, JError::raiseWarning (or JError::raiseError) must be used to set a message.
263
+Parameters:+
264
# (VirtueMartCart object)  Cart object
265
# (integer, default 0) ID of the shipper selected
266 16 Valérie Isaksen
267 21 Valérie Isaksen
* *plgVmOnShipperSelectedCalculatePrice()* - This event is fired before the order is saved, and used to calculate the cart prices.  
268 16 Valérie Isaksen
+Return:+
269 28 Valérie Isaksen
True on success, false on failures, null when this plugin was not selected.
270 16 Valérie Isaksen
On errors, JError::raiseWarning (or JError::raiseError) must be used to set a message.
271
+Parameters:+
272
# (VirtueMartCart object)  Cart object
273 28 Valérie Isaksen
# (array )  Shipping array containing: shipping_name, shipping_value, shipping_rate_vat_id 
274 16 Valérie Isaksen
275
276 10 Oscar van Eijk
277 20 Valérie Isaksen
* *plgVmOnConfirmShipper()* - This event is fired after the payment has been processed; it selects the actual shipping rate  and/or order weight, and optionally writes extra info to the database (in which case this method must be reimplemented).
278 10 Oscar van Eijk
Reimplementation is not required, but when done, the following check MUST be made:
279
<pre><code class="php">
280
if (!$this->selectedThisShipper($this->_selement, $_cart->shipper_id)) {
281
	return null;
282
}</code></pre>
283
+Return:+
284
The shipping rate ID
285
Do _not_ return parent::plgVmOnConfirmShipper($_cart); it is valid but will produce extra overhead!
286
+Parameters:+
287 1 Oscar van Eijk
# (VirtueMartCart object) Cart object
288 21 Valérie Isaksen
289 20 Valérie Isaksen
290
* *plgVmOnConfirmedOrderStoreShipperData()* This event is fired after the order has been stored; it gets the shipping method specific data.
291
+Return:+mixed Null when this method was not selected, otherwise true
292
#(integer) The order_id being processed
293
#(object) the cart
294
#array Price information for this order
295
296
297 10 Oscar van Eijk
298
* *plgVmOnShowOrderShipperBE()* - This method is fired when showing the order details in the backend. It displays the shipper-specific data.
299
NOTE, this plugin should NOT be used to display form fields, since it's called outside a form! Use *plgVmOnUpdateOrderBE()( instead!
300
+Return:+
301
Null for shippers that aren't active, text (HTML) otherwise
302
+Parameters:+
303
# (integer) The order ID
304
# (integer) Vendor ID
305
# (object) Object with 2 properties 'carrier' and 'name' 
306
307
* *plgVmOnEditOrderLineShipperBE()* - This method is fired when editing the order line details in the backend. It can be used to add line specific package codes
308
+Return:+
309
Null for shippers that aren't active, text (HTML) otherwise
310
+Parameters:+
311
# (integer) The order ID
312
# (integer) The order Line ID
313
314
* *plgVmOnUpdateOrderShipper()* - Save updated order data to the shipper specific table
315
+Return:+
316
True on success, false on failures (the rest of the save-process will be skipped!), or null when this shipper is not actived.
317
+Parameters:+
318
# (array) Form data
319
320
* *plgVmOnUpdateOrderLineShipper()* - Save updated orderline data to the shipper specific table
321
+Return:+
322
True on success, false on failures (the rest of the save-process will be skipped!), or null when this shipper is not actived.
323
+Parameters:+
324
# (array) Form data
325
326
* *plgVmOnShowOrderShipperFE()* - This method is fired when showing the order details in the frontend.  It displays the shipper-specific data.
327
+Return:+
328
Null for shippers that aren't active, text (HTML) otherwise
329
+Parameters:+
330
# (integer) The order ID
331
332
* *plgVmOnShowOrderLineShipperFE()* - This method is fired when showing the order details in the frontend, for every orderline. It can be used to display line specific package codes, e.g. with a link to external tracking and tracing systems
333
+Return:+
334
Null for shippers that aren't active, text (HTML) otherwise
335
+Parameters:+
336
# (integer) The order ID
337
# (integer) The order LineID
338
339
Other helper functions inherited from the base class:
340
341
* *_ createTable()* - This method is used to create and maintain the plugin specific database table(s).
342
It _must_ be reimplemented by all plugins.
343
+Example:+
344
<pre><code class="php">$_scheme = DbScheme::get_instance();
345
$_scheme->create_scheme('#__vm_order_shipper_'.$this->_selement);
346
$_schemeCols = array(
347
	 'id' => array (
348
			 'type' => 'int'
349
			,'length' => 11
350
			,'auto_inc' => true
351
			,'null' => false
352
	)
353
	,'order_id' => array (
354
			 'type' => 'int'
355
			,'length' => 11
356
			,'null' => false
357
	)
358
	,'shipper_id' => array (
359
			 'type' => 'text'
360
			,'null' => false
361
	)
362
);
363
$_schemeIdx = array(
364
	 'idx_order_payment' => array(
365
			 'columns' => array ('order_id')
366
			,'primary' => false
367
			,'unique' => false
368
			,'type' => null
369
	)
370
);
371
$_scheme->define_scheme($_schemeCols);
372
$_scheme->define_index($_schemeIdx);
373
if (!$_scheme->scheme()) {
374
	JError::raiseWarning(500, $_scheme->get_db_error());
375
}
376
$_scheme->reset();
377
</code></pre>
378
379
* *getThisShipperName()* -  Get the name of the shipper
380
+Return:+
381
Shipper name
382
+Parameters:+
383
# (integer) The Shipper ID
384
	final protected function ($_sid)
385
386
* *writeShipperData()* - This method writes all shipper plugin specific data to the plugin's table
387
+Parameters:+
388
# (array) Indexed array in the format 'column_name' => 'value'
389
# (string) Table name
390
391
* *getShippingRateIDForOrder()* - Get the shipping rate ID for a given order number
392
+Return:+
393
The shipping rate ID, or -1 when not found 
394
+Parameters:+
395
# (integer) The order ID
396
397
* *getShippingRate()* -  Get the total price for a shipping rate
398
+Return:+
399
Price in display format
400
+Parameters:+
401
# (integer) Shipping rate ID
402
	
403
* *getShipperIDForOrder()* - Get the shipper ID for a given order number
404
+Return:+
405
The shipper ID, or -1 when not found 
406
+Parameters:+
407
# (integer) The order ID
408
409
* *selectShippingRate()* - Select the shipping rate ID, based on the selected shipper in combination with the shipto address (country and zipcode) and the total order weight.
410
+Return:+
411
Shipping rate ID, -1 when no match is found. Only 1 selected ID will be returned; if more ID's match, the cheapest will be selected.
412
+Parameters:+
413
# (VirtueMartCart object) Cart object
414
# (integer, default 0) Shipper ID, by default taken from the cart
415
416
* *selectedThisShipper()* - This method checks if the selected shipper matches the current plugin
417
+Return:+
418
True if the calling plugin has the given payment ID
419
+Parameters:+
420
# (string) Element name, taken from the plugin filename
421
# (integer) The shipper ID
422
423
* *getOrderWeight()* - Get the total weight for the order, based on which the proper shipping rate can be selected.
424
+Return:+
425
Total weight for the order
426
+Parameters:+
427
# (VirtueMartCart object) Cart object
428
429 18 Valérie Isaksen
* *getShippers()* - Fill an array with all shippers found with this plugin for the current vendor
430 10 Oscar van Eijk
+Return:+
431 23 Valérie Isaksen
True when shipper(s) was (were) found for this vendor, false otherwise
432 10 Oscar van Eijk
+Parameters:+
433
# (integer) The vendor ID taken from the cart.
434
435
* *validateVendor()* - Check if this shipper has carriers for the current vendor.
436
+Return:+
437
True when a shipper_id was found for this vendor, false otherwise
438
+Parameters:+
439
# (integer) The vendor ID taken from the cart.
440 26 Valérie Isaksen
441 27 Valérie Isaksen
* *getShippingHtml* - returns the HTML code to display the form, based on the $shipper_name, $shipper_id, $selectedShipper, $shipper_logo, $shipping_value, $tax_id, $currency_id. To be used by the function plgVmOnSelectShipper().
442 26 Valérie Isaksen
+Return:+
443
returns HTML code to display the form
444
+Parameters:+
445 1 Oscar van Eijk
# (string)  shipper_name
446 26 Valérie Isaksen
# (integer) shipper_id
447 1 Oscar van Eijk
# (integer) selectedShipper id
448 28 Valérie Isaksen
# (string)  shipper_logo to be displayed
449 26 Valérie Isaksen
# (integer) shipping_value to use to calculate the SalesPriceShipping
450
# (integer) tax_id to use to calculate the SalesPriceShipping
451 28 Valérie Isaksen
452 26 Valérie Isaksen
453
* *calculateSalesPriceShipping()* - Returns the 'salesPriceShipping' for a given shipping value, tax id, and currency id.
454
+Return:+
455
returns salesPriceShipping
456
+Parameters:+
457
# (integer) shipping_value 
458
# (integer) tax_id
459
# (integer) currency_id
460
461
* *getShipperLogo()* - Returns the shipper logo image html.
462
+Return:+
463
returns the html code to display the image
464
+Parameters:+
465
# (string) logo image name
466
# (string) alt text to the image