Tuttavia si trovano pochissimi risultati che illustrino quali siano gli oggetti coinvolti nel processo di pagamento e come essi interagiscano fra loro. In questi giorni abbiamo provato a ricostruire il processo: di seguito riportiamo i risultati di tale ricostruzione basata su Magento CE 1.5.1.

Innanzitutto illustriamo i principali soggetti coinvolti.

• Mage_Sales_Model_Order è l’oggetto order vero e proprio. Tutte le azioni passano da qui: place(), cancel(), invoice()…
• Mage_Sales_Model_Order_Payment è un oggetto pagamento generico. È quello che si ottiene da order con $order->getPayment().
• Il nostro metodo di pagamento che sarà normalmente un estensione di Mage_Payment_Model_Method_Abstract. Si ottiene dal Payment con un $this->getMethodInstance()

1. Viene invocata l’azione saveOrder di Mage_Checkout_OnepageController. Tra le varie istruzioni questa azione chiama

   399	$this->getOnepage()->saveOrder()

   il quale chiama il metodo saveOrder() di Mage_Checkout_Model_Type_Onepage. Questo invoca il comando

   742	$service->submitAll();

   il quale chiama il metodo submitAll() e quindi submitOrder() di Mage_Sales_Model_Service_Quote.
   Arrivati a questo punto finalmente viene eseguito il place() dell’order tramite le istruzioni.

   173 174 175

   $transaction->addObject($order); $transaction->addCommitCallback(array($order, 'place')); $transaction->addCommitCallback(array($order, 'save'));

   Se vi aspettavate di trovare da qualche parte del codice un bel $order->place()… Magento is never easy!

2. La funzione place() di Mage_Sales_Model_Order è la funzione che da il via al processo di pagamento. Oltre a lanciare gli eventi correlati, infatti lancia _placePayment che effettua il pagamento tramite l’oggetto Mage_Sales_Model_Order_Payment
3. La funzione place() di Mage_Sales_Model_Order_Payment effettua molte operazioni.
   • cambia lo stato prima a New poi a Processing
   • imposta tutti i parametri del pagamento (importo, costi spedizione…)
   • distingue se il metodo di Pagamento è Authorize oppure Authorize and Capture. Nel primo caso lancia il comando _authorize nel secondo il comando capture
4. Analizziamo in prima battuta il caso authorize. La funzione _authorize chiama a sua volta la funzione authorize che sarà definita nel nostro metodo di pagamento (che estenderà una funzione praticamente vuota presente in Mage_Payment_Model_Method_Abstract). authorize normalmente conterrà tutte le istruzioni che si interfacciano con il webservice della banca. Tra le altre dovrà contenere anche le istruzioni di creazione di un oggetto di tipo sales/order_payment_transaction. Questo passaggio è importante per la fase di cancellazione: senza transaction la cancellazione è impossibile.

Kingdom of Roi:

Creating Your Own Payment Gateway For Magento – Part 1
Creating Your Own Payment Gateway For Magento – Part 2
Creating Your Own Payment Gateway For Magento – Part 3

Alan Storm:

Magento Payment flow

Stephen Gray:

Magento create a custom payment method

Da qualche tempo in Magento Solutions abbiamo abbandonato l’importazione classica di Magento (che usa i moduli DataFlow) per problemi di performance dato che il ritmo di DataFlow è di 50-100 prodotti/minuto.
Sebbene in Magento 1.5 anche la Varien abbia inserito un nuovo importatore con prestazioni migliorate, la soluzione che utilizziamo correntemente è il Magento Mass Importer sviluppato da Dweeves sul forum di Magento.

Il MagMI oltre a risolvere molti dei problemi che con DataFlow rimanevano irrisolti (importazione dei configurabili, importazione delle immagini, related, crosssell, upsell, tier prices) ha una velocità considerevole che si attesta sui 1500-2500 prodotti/min (e la velocità arriva anche a 5000-6000 in caso di aggiornamento di un singolo attributo come la disponibilità o il prezzo).
Inoltre MagMI ha una struttura a plugin per cui si possono aggiungere facilmente nuove funzionalità.

Un grande grazie a Dweeves per averci messo a disposizione uno strumento tanto potente e completo.

Tale baco è stato risolto in Magento 1.5. Riportiamo qui di seguito la correzione da fare per propagare la correzione anche in Magento 1.4.2:

Nel file app/code/core/Mage/CatalogSearch/Model/MySQL4/Fulltext.php bisogna sostituire la riga 342:

342

$likeCond = '(' . join(' OR ', $like) . ')';

con:

342

$likeCond = '(' . join(' AND ', $like) . ')';

• My Account
• My Wishlist
• My Cart
• Checkout
• Login

Questi link sono regolamentati di solito da un blocco chiamato top.links definito nel layout page.xml. Il template relativo a questo blocco è il page/template/links.phtml, template che viene dichiarato implicitamente quando un blocco è dichiarato di tipo page/template_links (a questo proposito si veda il metodo _construct() in app/code/core/Mage/Page/Block/Template/Links.php).

I link sono aggiunti al blocco tramite i metodi addLink/addCartLink/addCheckoutLink/addWishlistLink nei seguenti layout:

• checkout.xml
• customer.xml
• wishlist.xml

Saranno proprio questi i layout da modificare per spostare o nascondere i link dal menu.

Se però il campo aggiuntivo deve essere una select popolata dinamicamente, serve qualche ulteriore passo.
Il file mysql4-install-0.1.0.php dovrà essere così:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

startSetup();
 
$installer->addAttribute('catalog_category', 'drilldown_link', array(
                        'type'              => 'int',
                        'backend'           => '',
                        'frontend'          => '',
                        'label'             => 'Attributo collegato (drilldown L2):',
                        'input'             => 'select',
                        'class'             => '',
                        'source'            => 'bundle/drilldownl2',
                        'global'            => Mage_Catalog_Model_Resource_Eav_Attribute::SCOPE_GLOBAL,
                        'visible'           => 1,
                        'required'          => 0,
                        'user_defined'      => 0,
                        'default'           => '',
                        'searchable'        => 0,
                        'filterable'        => 0,
                        'comparable'        => 0,
                        'visible_on_front'  => 0,
                        'unique'            => 0,
                        'position'          => 1,
			'note'		    => '',
			'apply_to'	    => 'bundle',
                    ));
 
$installer->endSetup();

Le righe modificate rispetto al tutorial seguito sono:
'input' => 'select'
'source' => 'bundle/drilldownl2'
con la seconda, specifichiamo il model che Magento andrà a cercare per popolare la select.
In altre parole, il sistema si aspetta di trovare questo file:
app/code[/local]/Mage/Bundle/Model/drilldownl2.php
che dovrà contenere un metodo getAllOptions().
Ecco il codice:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

<?php
 
class Mage_Bundle_Model_DrilldownL2 extends Mage_Eav_Model_Entity_Attribute_Source_Abstract
{
 public function getAllOptions()
 {
 if (is_null($this->_options)) {
 $this->_options = array();
 
 $this->_options = array(
 array(
 'label' => Mage::helper('bundle')->__('Uno'),
 'value' =>  1
 ),
 array(
 'label' => Mage::helper('bundle')->__('Due'),
 'value' =>  0
 ),
 );
 }
 return $this->_options;
 }
}
 
?>

L’estensione si installa via MagentoConnect da qui:
http://www.magentocommerce.com/magento-connect/Yarhajile/extension/728/multiple-tablerates

(se MagentoConnect non riuscisse a scaricare i files, ecco il link diretto:
http://connect.magentocommerce.com/community/get/Pw_Multipletablerates-0.2.2.tgz )

Un tutorial utile per la configurazione:
http://webshop-conversion.com/2009/06/27/importing-and-exporting-table-rates-in-magento/

Ecco i passaggi:

1)   System -> Configuration -> Shipping Methods

2)  scegliere Multiple Tablerates:
sono visibili le opzioni di configurazione generali, ma non la funzione import/export CSV

3)  scegliere il website dalla tendina in alto a sinistra:
a questo punto compaiono i pusanti Import e Export.

Le regole vengono definite nel file CSV che poi bisogna importare. La sintassi è spiegata qui:
http://www.magentocommerce.com/boards/viewthread/26751/
“Country,Region/State,Zip/Postal Code,Condition Value,Shipping Price,method Code,Method Name,Method Description,Condition Type”

4)  dopo aver costruito correttamente il CSV, eseguire l’import e cancellare la cache.

Purtroppo tale modulo è affetto da un bug per cui, quando un prodotto viene inserito nel carrello, non vengono visualizzate le opzioni configurabili che sono state selezionate. Tale comportamento è dovuto al fatto che quando SimpleConfigurableProducts è attivo, nel carrello non viene inserito il prodotto configurabile con le sue opzioni, ma viene inserito direttamente il prodotto semplice.

Riportiamo di seguito la correzione del bug.
Il file che va modificato è app/code/community/OrganicInternet/SimpleConfigurableProducts/Checkout/Block/Cart/Item. Bisogna aggiungere alla fine del file la funzione getProductOptions()

43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

public function getProductOptions()
{
   $options = array();
   $parent=$this->getConfigurableProductParent();
 
   $attributes=$parent->getTypeInstance()->getConfigurableAttributes();
 
   foreach($attributes as $attribute){
      $attribute_id=$attribute->getProductAttribute()->getId();
      $attribute_code=$attribute->getProductAttribute()->getAttributeCode();
      $childProduct=Mage::getModel('catalog/product')->load($this->getProduct()->getId());
 
      $options[] = array(
         'label' => $attribute->getProductAttribute()->getFrontend()->getLabel(),
         'value' => $childProduct->getAttributeText($attribute_code),
         'print_value' => $childProduct->getAttributeText($attribute_code),
         'option_id' => $attribute_id,
         'option_type' => $attribute->getType()
         );
   }      
 
   return $options;
}

Riportiamo di seguito uno script da eseguire a importazione avvenuta. La funzione ricorsiva orderCategories riordina ordina tutto l’albero delle categorie avente radice nella categoria con id $cat_id

< ?php
function orderCategories($cat_id){
    $collection=Mage::getModel('catalog/category')-> getCollection()
            ->addAttributeToFilter('parent_id',array("like"=>$cat_id))
            ->addAttributeToSelect('url_path')
            ->setOrder('name','asc')
            ->load()->getItems();
    if (count($collection)==0)
        return;
    else{
        $i=1;
        foreach ($collection as $category)
            {$category->setPosition($i)->save();
            $category_id=$category->getId();
            print ($i.". ".$category->getName()."<br />");
            flush();
            $i++;
            orderCategories($category_id);
            }
    }
}
?>

Per riordinare tutte le categorie del website e dello store di default basta estrarre la Root Category Id

< ?php
require_once 'app/Mage.php';
Mage::app()->setCurrentStore(Mage_Core_Model_App::ADMIN_STORE_ID);
 
$website=Mage::app()->getWebsite(true);
$store=$website->getDefaultStore();
$category_id=$store->getRootCategoryId();
orderCategories($category_id);
?>

La visualizzazione dei prezzi scontati si può aggiungere modificando il template /app/design/frontend/default/{template_name}/template/catalog/product/price.phtml

Innanzitutto recuperiamo l’array di tutti i tassi di sconto:

$rules = Mage::getModel('catalogrule/rule')->getCollection()
             ->addFieldToFilter('is_active', 1)->load();
$discount_amount=array();
foreach($rules as $rule)
    {$discount_amount[]=$rule->getDiscountAmount();}

Supponendo che lo sconto che vogliamo pubblicizzare sia in $discount_amount[0], la visualizzazione del prezzo scontato si può ottenere aggiungendo sotto a

		<span class="regular-price" id="product-price-<?php echo $_id ?>
		<?php echo $this->getIdSuffix() ?>"><?php echo Mage::helper('core')->currency($_price,true,true) ?></span>
	<?php endif; ?>
<?php endif; ?>

il seguente codice:

<?php if (!Mage::getSingleton( 'customer/session' )->isLoggedIn()): ?>
<p class="special-price">
	<span class="price-label" id="registered-price-label<?php echo $this->getIdSuffix() ?>">
	<?php echo $this->__('Registered Price:'); ?></span>
	<span class="price" id="registered-product-price-<?php echo $_id ?><?php echo $this->getIdSuffix() ?>">
		<?php echo Mage::helper('core')->currency($_finalPrice*(1-$discount_amount[0]/100) ,true,false) ?>
	</span>
</p>
<?php endif; ?>

Una possibile soluzione è ricreare in uno script esterno a Magento tutte le chiamate al controller effettuando il ciclo direttamente in php. Il controller deputato a gestire gli script di importazione è Mage_Adminhtml_System_Convert_ProfileController.

Per fare uno script esterno a magento che utilizzi le funzioni magento bisogna ricreare il contesto. Questa operazione è effettuata tramite:

1
2
3

require_once 'app/Mage.php';
 
Mage::app()->setCurrentStore(Mage_Core_Model_App::ADMIN_STORE_ID);

Bisogna fare molta attenzione soprattutto all’istruzione presente alla riga 3: in molti script che presenti in rete al suo posto si trova spesso un semplice Mage::app();. Non sono la stessa cosa! Un possibile problema introdotto dall’utilizzo di un semplice Mage->app(); è che, al momento in cui si carica un prodotto, l’oggetto non viene caricato completamente (la variabile _origData viene impostata a null) e di conseguenza le operazioni di update non vengono eseguite correttamente.

Il nome del file in cui sono contenuti i dati da importare e il l’id del profilo di importazione sono passati in get.

4
5
6
7
8

$profileId =  Mage::app()->getRequest()->getParam('profile_id');
$filename = Mage::app()->getRequest()->getParam('files'); 
if (!isset($filename))  {
    die("No file has been set!");
}

Ultimo passaggio della fase di ricreazione del contesto è l’inizializzazione delle sessioni magento.

9
10
11

$userModel = Mage::getModel('admin/user');
$userModel->setUserId(0);
Mage::getSingleton('admin/session')->setUser($userModel);

Dato che il nostro script verrà eseguito in background, i messaggi di notifica dello stato di avanzamento delle operazioni vengono inviati a un file di log piuttosto che a schermo (come invece fanno normalmente gli script di importazione). Il codice che segue serve a inizializzare il log (si ricorda che il log deve essere abilitato da backend andando su System -> Configuration -> Developer -> Log Settings e imponendo Enabled a “Yes”).

12
13
14
15

$logFileName= $filename.'.log';  
$recordCount = 0;
umask(0);
Mage::log("Inizio dell'importazione di ".$filename,null,$logFileName);

Nel momento in cui da backend si lancia uno script di importazione viene lanciato il metodo runAction() che a sua volta lancia tutte le operazioni di inizializzazione del profilo tramite _initProfile(). Riportiamo nel nostro script tali operazioni.

16
17
18
19
20
21
22
23
24

$profile = Mage::getModel('dataflow/profile');
if ($profileId) {
    $profile->load($profileId);
    if (!$profile->getId()) {
        Mage::getSingleton('adminhtml/session')->addError('The profile you are trying to save no longer exists');
    }
}
 
Mage::register('current_convert_profile', $profile);

A questo punto l’esecuzione normale del profilo prevede la renderizzazione tramite toHtml() di Mage_Adminhtml_Block_System_Convert_Profile_Run. Come già accennato l’esecuzione del profilo viene effettuata tramite chiamate AJAX Eliminando tutto il codice che serve alla creazione della pagina HTML, nel nostro script viene mantenuto esclusivamente il codice che manda in esecuzione il profilo. In particolare il codice che importa effettivamente le righe è contenuto nella funzione batchRunAction() del controller Mage_Adminhtml_System_Convert_ProfileController.

25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66

$profile->run();
 
$batchModel = Mage::getSingleton('dataflow/batch');
if ($batchModel->getId()) {
    if ($batchModel->getAdapter()) {
        $batchId = $batchModel->getId(); 
        $batchImportModel = $batchModel->getBatchImportModel();
        $importIds = $batchImportModel->getIdCollection();  
        $batchModel = Mage::getModel('dataflow/batch')->load($batchId);      
        $adapter = Mage::getModel($batchModel->getAdapter());
        $adapter->setBatchParams($batchModel->getParams());
        foreach ($importIds as $importId) {
            $recordCount++;
            try {
                $batchImportModel->load($importId);
                if (!$batchImportModel->getId()) {
                    $errors[] = Mage::helper('dataflow')->__('Skip undefined row');
                    continue;
                }
 
                $importData = $batchImportModel->getBatchData();
                try {
                    $adapter->saveRow($importData);
                } catch (Exception $e) {
                    Mage::log($e->getMessage(),null,$logFileName);          
                    continue;
                }
 
                if ($recordCount%10 == 0) {
                    Mage::log($recordCount . ' - Completed!! ',null,$logFileName);
                }
            } catch(Exception $ex) {
                Mage::log('Record# ' . $recordCount . ' - SKU = ' . $importData['sku']. ' - Error - ' . $ex->getMessage(),null,$logFileName);        
            }
        }
        foreach ($profile->getExceptions() as $e) {
            Mage::log($e->getMessage(),null,$logFileName);          
        }
 
    }
}
Mage::log("Importazione di $filename completata: $recordCount record inseriti",null,$logFileName);

Per avere il controllo sull’avanzamento del processo si è scelto di scrivere un record nel file di log ogni 10 prodotti importati (vedi righe 53-55).

Lo script risultante è:

require_once 'app/Mage.php';
 
Mage::app()->setCurrentStore(Mage_Core_Model_App::ADMIN_STORE_ID);
$profileId =  Mage::app()->getRequest()->getParam('profile_id');
$filename = Mage::app()->getRequest()->getParam('files'); 
if (!isset($filename))  {
    die("No file has been set!");
}
$userModel = Mage::getModel('admin/user');
$userModel->setUserId(0);
Mage::getSingleton('admin/session')->setUser($userModel);
$logFileName= $filename.'.log';  
$recordCount = 0;
umask(0);
Mage::log("Inizio dell'importazione di ".$filename,null,$logFileName);  
$profile = Mage::getModel('dataflow/profile');
if ($profileId) {
    $profile->load($profileId);
    if (!$profile->getId()) {
        Mage::getSingleton('adminhtml/session')->addError('The profile you are trying to save no longer exists');
    }
}
 
Mage::register('current_convert_profile', $profile);
$profile->run();
 
$batchModel = Mage::getSingleton('dataflow/batch');
if ($batchModel->getId()) {
    if ($batchModel->getAdapter()) {
        $batchId = $batchModel->getId(); 
        $batchImportModel = $batchModel->getBatchImportModel();
        $importIds = $batchImportModel->getIdCollection();  
        $batchModel = Mage::getModel('dataflow/batch')->load($batchId);      
        $adapter = Mage::getModel($batchModel->getAdapter());
        $adapter->setBatchParams($batchModel->getParams());
        foreach ($importIds as $importId) {
            $recordCount++;
            try {
                $batchImportModel->load($importId);
                if (!$batchImportModel->getId()) {
                    $errors[] = Mage::helper('dataflow')->__('Skip undefined row');
                    continue;
                }
 
                $importData = $batchImportModel->getBatchData();
                try {
                    $adapter->saveRow($importData);
                } catch (Exception $e) {
                    Mage::log($e->getMessage(),null,$logFileName);          
                    continue;
                }
 
                if ($recordCount%10 == 0) {
                    Mage::log($recordCount . ' - Completed!! ',null,$logFileName);
                }
            } catch(Exception $ex) {
                Mage::log('Record# ' . $recordCount . ' - SKU = ' . $importData['sku']. ' - Error - ' . $ex->getMessage(),null,$logFileName);        
            }
        }
        foreach ($profile->getExceptions() as $e) {
            Mage::log($e->getMessage(),null,$logFileName);          
        }
 
    }
}
Mage::log("Importazione di $filename completata: $recordCount record inseriti",null,$logFileName);