Mar 31, 2009

Howto: Repackageable custom extension development in Magento – Part 7 – CRUD – Create

Author: gaweee | Filed under: development, howto

Download the source for this entire series here!

CRUD – Create

  1. More file structure goodness: 
    app/
  etc/
    modules/
      - SavantDegrees_All.xml (Or what ever your company name might be)
  code/
    local/
      SavantDegrees/ (Or what ever your company name might be)
        Twits/ (Or whatever your module name might be)
          Block/
            Admin/
              - Main.php
              Main/
                - Grid.php
              - New.php
              New/
                - Form.php
            - HelloWorld.php
          controllers/
            - AdminController.php
            - IndexController.php
          etc/
            - config.xml
          Helper/
            - Data.php
          Model/
            - Tip.php
            Mysql4/
              - Tip.php
              Tip/
                - Collection.php
          sql/
            twits_setup/
              - mysql4-install-0.2.0.php
              - mysql4-upgrade-0.1.0-0.2.0.php

    Here we’ve added the block for the New container and Form

  2. Looking at the New.php code: 
    1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

    <?php
class SavantDegrees_Twits_Block_Admin_New extends Mage_Adminhtml_Block_Widget_Form_Container
{
    public function __construct()
    {
        parent::__construct();
 
        $this->_blockGroup = 'twits';
        $this->_mode = 'new';
        $this->_controller = 'admin';
    }
 
    public function getHeaderText()
    {
        return Mage::helper('twits')->__('Add New Tip');
    }
}
  3. Then the New/Form.php code 
    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
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

    <?php
class SavantDegrees_Twits_Block_Admin_New_Form extends Mage_Adminhtml_Block_Widget_Form
{
    protected function _prepareForm()
    {
        $form = new Varien_Data_Form();
 
        $fieldset = $form->addFieldset('new_tip', array('legend' => Mage::helper('twits')->__('Tip Details')));
 
        $fieldset->addField('title', 'text', array(
            'name'      => 'title',
            'title'     => Mage::helper('twits')->__('Title'),
            'label'     => Mage::helper('twits')->__('Title'),
            'maxlength' => '250',
            'required'  => true,
        ));
 
        $fieldset->addField('author', 'text', array(
            'name'      => 'author',
            'title'     => Mage::helper('twits')->__('Author'),
            'label'     => Mage::helper('twits')->__('Author'),
            'maxlength' => '250',
            'required'  => true,
        ));
 
        $fieldset->addField('contents', 'textarea', array(
            'name'      => 'contents',
            'title'     => Mage::helper('twits')->__('Contents'),
            'label'     => Mage::helper('twits')->__('Contents'),
            'style'     => 'width: 98%; height: 200px;',
            'required'  => true,
        ));
 
        $form->setMethod('post');
        $form->setUseContainer(true);
        $form->setId('edit_form');
        $form->setAction($this->getUrl('*/*/post'));
 
        $this->setForm($form);
    }
}

    Just like your listings/grid page, the New.php and Form.php classes are the Form Container and Form respectively. So the Form Container automagically creates the form. Did I mention why containers are good? They come with nice pretty buttons! (Save and Back).

  4. Then lastly the adminController with its newAction and postAction to load and save the form respectively

    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
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

    <?php
class SavantDegrees_Twits_AdminController extends Mage_Adminhtml_Controller_Action
{
	public function indexAction()
    {
		$this->loadLayout()
			->_addContent($this->getLayout()->createBlock('twits/admin_main'))
			->renderLayout();
    }
 
	public function deleteAction()
    {
        $tipId = $this->getRequest()->getParam('id', false);
 
        try {
            Mage::getModel('twits/tip')->setId($tipId)->delete();
            Mage::getSingleton('adminhtml/session')->addSuccess(Mage::helper('twits')->__('Tip successfully deleted'));
            $this->getResponse()->setRedirect($this->getUrl('*/*/'));
 
            return;
        } catch (Exception $e){
            Mage::getSingleton('adminhtml/session')->addError($e->getMessage());
        }
 
        $this->_redirectReferer();
    }
 
    public function newAction()
    {
        $this->loadLayout()
        ->_addContent($this->getLayout()->createBlock('twits/admin_new'))
        ->renderLayout();
    }
 
    public function postAction()
    {
        if ($data = $this->getRequest()->getPost()) {
            $tip = Mage::getModel('twits/tip')->setData($data);
            try {
                $tip->save();
                Mage::getSingleton('adminhtml/session')->addSuccess(Mage::helper('twits')->__('Tip was successfully saved'));
                $this->getResponse()->setRedirect($this->getUrl('*/*/'));
                return;
            } catch (Exception $e){
                Mage::getSingleton('adminhtml/session')->addError($e->getMessage());
            }
        }
        $this->getResponse()->setRedirect($this->getUrl('*/*/'));
        return;
    }
}
  5. Reward yourself for your lightning fast copy-and-paste kung foo! Whats happening though?
    When the script receives a call newAction, it’ll show the form to enter data. The data is posted to the postAction method. That method creates an instance of the model, sets the post data into the model, saves it then redirects it back to the indexAction. Did i mention automagically? Yes, thats why we had to learn so much of the Magento code just to write this simple tutorial. The sql is automagically generated and run and the form is automagically created! *sheds a tear*

    Again, your well deserved create form can be found by clicking on the “Add New Tip” button from the Grid!

» Just 1 more … CRUD – Update

read users' comments (4)
Mar 31, 2009

Howto: Repackageable custom extension development in Magento – Part 6 – CRUD – Delete

Author: gaweee | Filed under: development, howto

Download the source for this entire series here!

CRUD – Delete

  1. The simplest step thus far, add a new function to your AdminController.php 
    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
27

    <?php
class SavantDegrees_Twits_AdminController extends Mage_Adminhtml_Controller_Action
{
    public function indexAction()
    {
		$this->loadLayout()
			->_addContent($this->getLayout()->createBlock('twits/admin_main'))
			->renderLayout();
    }
 
    public function deleteAction()
    {
        $tipId = $this->getRequest()->getParam('id', false);
 
        try {
            Mage::getModel('twits/tip')->setId($tipId)->delete();
            Mage::getSingleton('adminhtml/session')->addSuccess(Mage::helper('twits')->__('Tip successfully deleted'));
            $this->getResponse()->setRedirect($this->getUrl('*/*/'));
 
            return;
        } catch (Exception $e){
            Mage::getSingleton('adminhtml/session')->addError($e->getMessage());
        }
 
        $this->_redirectReferer();
    }
}

» Almost there … CRUD – Create

read users' comments (1)
Mar 31, 2009

Howto: Repackageable custom extension development in Magento – Part 5 – CRUD – Retrieve

Author: gaweee | Filed under: development, howto

Download the source for this entire series here!

CRUD – Retrieve

  1. Lets add a new block to the file structure 
    app/
  etc/
    modules/
      - SavantDegrees_All.xml (Or what ever your company name might be)
  code/
    local/
      SavantDegrees/ (Or what ever your company name might be)
        Twits/ (Or whatever your module name might be)
          Block/
            Admin/
              - Main.php
              Main/
                - Grid.php
            - HelloWorld.php
          controllers/
            - AdminController.php
            - IndexController.php
          etc/
            - config.xml
          Helper/
            - Data.php
          Model/
            - Tip.php
            Mysql4/
              - Tip.php
              Tip/
                - Collection.php
          sql/
            twits_setup/
              - mysql4-install-0.2.0.php
              - mysql4-upgrade-0.1.0-0.2.0.php

    We’ll create folder called Admin to store all the admin related blocks. Inside we’ll have a Main.php file that contains the Grid Container. Why do we need a grid container? To put the title and Create button!

  2. The Main.php code

    1
2
3
4
5
6
7
8
9
10
11
12
13

    <?php
class SavantDegrees_Twits_Block_Admin_Main extends Mage_Adminhtml_Block_Widget_Grid_Container
{
    public function __construct()
    {
        $this->_addButtonLabel = Mage::helper('twits')->__('Add New Tip');
        parent::__construct();
 
        $this->_blockGroup = 'twits';
        $this->_controller = 'admin_main';
        $this->_headerText = Mage::helper('twits')->__('Tips(s)');
    }
}

    Here you see a first use of the helper, which will assist in translation

  3. The Grid.php itself

    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
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
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98

    <?php
class SavantDegrees_Twits_Block_Admin_Main_Grid extends Mage_Adminhtml_Block_Widget_Grid
{
 
    public function __construct()
    {
        parent::__construct();
        $this->setId('tipsGrid');
        $this->_controller = 'twits';
    }
 
    protected function _prepareCollection()
    {
        $model = Mage::getModel('twits/tip');
        $collection = $model->getCollection();
		$this->setCollection($collection);
 
        return parent::_prepareCollection();
    }
 
 
 
    protected function _prepareColumns()
    {
 
        $this->addColumn('tip_id', array(
            'header'        => Mage::helper('twits')->__('ID'),
            'align'         => 'right',
            'width'         => '50px',
            'filter_index'  => 'dt.tip_id',
            'index'         => 'tip_id',
        ));
 
        $this->addColumn('name', array(
            'header'        => Mage::helper('twits')->__('Title'),
            'align'         => 'left',
            'width'         => '150px',
            'filter_index'  => 'dt.title',
            'index'         => 'title',
            'type'          => 'text',
            'truncate'      => 50,
            'escape'        => true,
        ));
 
        $this->addColumn('tags', array(
            'header'    	=> Mage::helper('twits')->__('Author'),
            'align'         => 'left',
            'filter_index'  => 'dt.author',
            'index'    	 	=> 'author',
            'type'     	 	=> 'text',
            'escape'		=> true,
        ));
 
        $this->addColumn('summary', array(
            'header'        => Mage::helper('twits')->__('Contents'),
            'align'         => 'left',
            'filter_index'  => 'dt.contents',
            'index'         => 'contents',
            'type'          => 'text',
            'escape'        => false,
        ));
 
        $this->addColumn('action',
            array(
                'header'    => Mage::helper('twits')->__('Action'),
                'width'     => '150px',
                'type'      => 'action',
                'getter'	=> 'getTipId',
                'actions'   => array(
                    array(
                        'caption' => Mage::helper('twits')->__('Edit'),
                        'url'     => array(
                            'base'=>'*/*/edit'
                         ),
                         'field'   => 'id'
                    ),
                    array(
                        'caption' => Mage::helper('twits')->__('Delete'),
                        'url'     => array(
                            'base'=>'*/*/delete'
                         ),
                         'field'   => 'id'
                    )
                ),
                'filter'    => false,
                'sortable'  => false
        ));
 
        return parent::_prepareColumns();
    }
 
    public function getRowUrl($row)
    {
        return $this->getUrl('*/*/edit', array(
            'id' => $row->getTipId(),
        ));
    }
}

    If you scrutinize the code (which i’d advise against), you’ll see most of the code is geared towards the setup of the grid columns and the edit/delete urls i’ll eventually call to perform the other CRUD functions.
    But whats going on? Where do we use this code? The main code (being a Grid_Container automatically adds the child Grid code associated to it. By child we’re talking about the Grid.php file in the Main folder. The folder’s name follows the file. So if you changed the folder’s name to Main2, it wouldnt work. That being said, you can just put any block code in the folder and expect it to run. The reason why this all works now is cause the geniuses at Magento already did alot of work to call the Grid child to run. They have no super time travel powers to tell what else you’re gonna put in there. So, it simply wont work (yet).

  4. Now lets make our adminController.php use that block instead of Hello world. 
    1
2
3
4
5
6
7
8
9

    class SavantDegrees_Twits_AdminController extends Mage_Adminhtml_Controller_Action
{
    public function indexAction()
    {
		$this->loadLayout()
			->_addContent($this->getLayout()->createBlock('twits/admin_main'))
			->renderLayout();
    }
}

    Well it says createBlock doesnt it? What do you think it does? twits/admin_main as always refers to the twits namespace and the admin/main.php block file.

  5. Viola! Your very very very hard earned grid!
    Magento Admin Grid

» Anytime now … Part 6 – CRUD – Delete

read users' comments (7)