By grouping I mean we create different helper which takes care of different things if putting all the methods in a single class become too cumbersome. <\/p>\n\n\n\n
One such example of grouping that you frequently observe in Magento is a helper to handle all email-related tasks.<\/p>\n\n\n\n
The helpers can be injected anywhere (i.e. in Blocks, Controllers, templates, etc) so that we can access the methods of that helper class.<\/p>\n\n\n\n
Injection of the class is just a fancy term for “mentioning the class in the constructor” so that we can create the object of that class.<\/p>\n\n\n\n
In this blog, for now, I will only create a single function to get the customer id. We can not get the customer id from the session if all the caches are enabled. <\/p>\n\n\n\n
So we need to do some hacks, which we will do later. If you remember we have used the customer id in 3-4 places. <\/p>\n\n\n\n
And everywhere we have used the session to get it. Now if we have to implement the hack, we will have to update the code in 3-4 places. <\/p>\n\n\n\n
Which is not ideal. So we will create a function in Helper to get the customer id. And we will call it everywhere else where the customer id is needed. <\/p>\n\n\n\n
So now we have to change only one function if we do some changes later. Note that we will and can keep adding more functions to the helper as we see fit.<\/p>\n\n\n\n
Creating and Using the Helper<\/h2>\n\n\n\n
To create the helpers we use a new folder named Helper inside the module directory. By default, we create a helper with the name Data. <\/p>\n\n\n\n
But we can use any name. Let’s create the helper as Helper\/Data.php<\/em><\/p>\n\n\n\n Code for Helper\/Data.php<\/em> file<\/p>\n\n\n\n Since this is a helper, we have extended the default helper class. And we have created a method to get the customer id.<\/p>\n\n\n\n Now let’s quickly update all the codes where we have used the customer id. We will have to edit Block\/BlogList.php<\/em><\/p>\n\n\n\n Updated code for Block\/BlogList.php<\/em> file<\/p>\n\n\n\n As you can see here, we have removed the session codes. And injected the helper class in the constructor and called the getCustomerId<\/strong> function.<\/p>\n\n\n\n We also have to edit the Controller\/Manage\/Edit.php<\/em><\/p>\n\n\n\n Updated code for Controller\/Manage\/Edit.php<\/em> file<\/p>\n\n\n\n And also Controller\/Manage\/Save.php<\/em><\/p>\n\n\n\n Updated code for Controller\/Manage\/Save.php<\/em> file<\/p>\n\n\n\n One more file that we have to edit is Controller\/Manage\/Delete.php<\/em><\/p>\n\n\n\n Updated code for Controller\/Manage\/Delete.php<\/em> file<\/p>\n\n\n\n Now we have created and used a helper. Please verify all the pages that these changes affect. <\/p>\n\n\n\n And please make a habit of checking\/verifying the changes even if it’s a minor<\/strong> change<\/strong>.<\/p>\n\n\n\n One more thing that I missed earlier is the use of a cacheable argument. By default, Magento cached all pages. <\/p>\n\n\n\n So if you enable all caches and check the blog listing page you will see some confusing results.<\/p>\n\n\n\n Magento recommends that all public pages (pages that can be accessed without sign-in) must be cacheable. <\/p>\n\n\n\n That means all pages such as the category page, product page, and cms page are cached. <\/p>\n\n\n\n And it makes sense because the public pages are get frequently accessed and the data on those pages do not change based on who the user is.<\/p>\n\n\n\n However, for all non-public pages (those pages which can be accessed only after logging in), we should disable the cache if the data is not static for that page. <\/p>\n\n\n\n We have not yet created any public page, we will do in the next blogs. So in our case, the private pages are blog listing, blog edit page, and blog add page. <\/p>\n\n\n\n We do not care blog add page because it is static we just show a blank form. But for the other two pages, we will have to disable the cache. Which we can do from the layout xml file.<\/p>\n\n\n\n So let’s first edit the view\/frontend\/layout\/blogmanager_manage_index.xml<\/em><\/p>\n\n\n\n Updated code for view\/frontend\/layout\/blogmanager_manage_index.xml<\/em> file<\/p>\n\n\n\n Here we have done a very minor change. We have just added cacheable=”false”<\/strong> in the node. Now this page won’t be cached. <\/p>\n\n\n\n Note that if there were multiple blocks then adding cacheable=”false”<\/strong> in any one of them will make the whole page non-cacheable. <\/p>\n\n\n\n That means we can not say that cache this block and not this in a page.<\/p>\n\n\n\n Let’s edit the other pages also view\/frontend\/layout\/blogmanager_manage_edit.xml<\/em><\/p>\n\n\n\n Updated code for view\/frontend\/layout\/blogmanager_manage_edit.xml<\/em> file<\/p>\n\n\n\n Now it will work fine even if we enable all caches.<\/p>\n\n\n\n It is not related to the previous topics. But it is a minor change so I will append it to this blog. <\/p>\n\n\n\n As you can see there are various important details are missing from the blog list on the seller side. <\/p>\n\n\n\n We will do some changes to show the status, created at, and updated at on the grid.<\/p>\n\n\n\n First, we will edit the phtml file view\/frontend\/templates\/list.phtml<\/em><\/p>\n\n\n\n Updated code for view\/frontend\/templates\/list.phtml<\/em> file<\/p>\n\n\n\n In the head section of the table, we have added the three columns, and similarly in the body section also. <\/p>\n\n\n\n We have called a method One more thing is that we are not showing the Date directly from the database.<\/p>\n\n\n\n We have created the getFormattedDate<\/strong> function in the block class which will format the date in a nice readable format.<\/p>\n\n\n\n Now let’s create these methods in Block\/BlogList.php<\/em><\/p>\n\n\n\n Updated code for Block\/BlogList.php<\/em> file<\/p>\n\n\n\n In getStatuses,<\/strong> we have used the class that we created to get the statuses for the UI component.<\/p>\n\n\n\n It is a good practice because if we want to add more statuses then we will have to change only in one file.<\/p>\n\n\n\n To get the formatted date we have used \\Magento\\Framework\\Stdlib\\DateTime\\TimezoneInterface<\/strong> which will return the date in the mentioned format. <\/p>\n\n\n\n If we want to convert then we have to pass the timestamp in date() <\/strong>and if we leave it empty then the current timestamp will be used. Note that this will return the date based on the locale.<\/p>\n\n\n\n Now you will see all the details like,<\/p>\n\n\n\n Next Blog -> Magento 2 Development 26: Blog Listing<\/a><\/p>\n\n\n\n Previous Blog -> Magento 2 Development 24: Loading Magento\u2019s Data<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<?php\nnamespace Webkul\\BlogManager\\Helper;\n\nuse Magento\\Customer\\Model\\Session;\n\nclass Data extends \\Magento\\Framework\\App\\Helper\\AbstractHelper\n{\n \/**\n * @var Magento\\Customer\\Model\\Session\n *\/\n protected $customerSession;\n \n \/**\n * Dependency Initilization\n *\n * @param Session $customerSession\n * @param \\Magento\\Framework\\App\\Helper\\Context $context\n *\/\n public function __construct(\n Session $customerSession,\n \\Magento\\Framework\\App\\Helper\\Context $context\n ) {\n $this->customerSession = $customerSession;\n parent::__construct($context);\n }\n\n \/**\n * Get Customer Id\n *\n * @return int\n *\/\n public function getCustomerId()\n {\n $customerId = $this->customerSession->getCustomerId();\n return $customerId;\n }\n}<\/pre>\n\n\n\n<?php\nnamespace Webkul\\BlogManager\\Block;\n\nclass BlogList extends \\Magento\\Framework\\View\\Element\\Template\n{\n \/**\n * @var \\Webkul\\BlogManager\\Model\\ResourceModel\\Blog\\CollectionFactory\n *\/\n protected $blogCollection;\n\n \/**\n * @var \\Webkul\\BlogManager\\Helper\\Data\n *\/\n protected $helper;\n\n \/**\n * Dependency Initilization\n *\n * @param \\Magento\\Framework\\View\\Element\\Template\\Context $context\n * @param \\Webkul\\BlogManager\\Model\\ResourceModel\\Blog\\CollectionFactory $blogCollection\n * @param \\Webkul\\BlogManager\\Helper\\Data $helper\n * @param array $data\n *\/\n public function __construct(\n \\Magento\\Framework\\View\\Element\\Template\\Context $context,\n \\Webkul\\BlogManager\\Model\\ResourceModel\\Blog\\CollectionFactory $blogCollection,\n \\Webkul\\BlogManager\\Helper\\Data $helper,\n array $data = []\n ) {\n $this->blogCollection = $blogCollection;\n $this->helper = $helper;\n parent::__construct($context, $data);\n }\n\n \/**\n * Get Blog List\n *\n * @return \\Webkul\\BlogManager\\Model\\ResourceModel\\Blog\\Collection\n *\/\n public function getBlogs()\n {\n $customerId = $this->helper->getCustomerId();\n $collection = $this->blogCollection->create();\n $collection->addFieldToFilter('user_id', ['eq'=>$customerId])->setOrder('updated_at', 'DESC');\n return $collection;\n }\n}<\/pre>\n\n\n\n<?php\nnamespace Webkul\\BlogManager\\Controller\\Manage;\n\nuse Magento\\Customer\\Controller\\AbstractAccount;\nuse Magento\\Framework\\App\\Action\\Context;\nuse Magento\\Framework\\View\\Result\\PageFactory;\n\nclass Edit extends AbstractAccount\n{\n \/**\n * @var Magento\\Framework\\View\\Result\\PageFactory\n *\/\n protected $resultPageFactory;\n\n \/**\n * @var \\Webkul\\BlogManager\\Model\\BlogFactory\n *\/\n protected $blogFactory;\n\n \/**\n * @var \\Webkul\\BlogManager\\Helper\\Data\n *\/\n protected $helper;\n\n \/**\n * @var \\Magento\\Framework\\Message\\ManagerInterface\n *\/\n protected $messageManager;\n\n \/**\n * Dependency Initilization\n *\n * @param Context $context\n * @param PageFactory $resultPageFactory\n * @param \\Webkul\\BlogManager\\Model\\BlogFactory $blogFactory\n * @param \\Webkul\\BlogManager\\Helper\\Data $helper\n * @param \\Magento\\Framework\\Message\\ManagerInterface $messageManager\n *\/\n public function __construct(\n Context $context,\n\t PageFactory $resultPageFactory,\n \\Webkul\\BlogManager\\Model\\BlogFactory $blogFactory,\n \\Webkul\\BlogManager\\Helper\\Data $helper,\n \\Magento\\Framework\\Message\\ManagerInterface $messageManager\n ) {\n\t $this->resultPageFactory = $resultPageFactory;\n\t $this->blogFactory = $blogFactory;\n\t $this->helper = $helper;\n\t $this->messageManager = $messageManager;\n parent::__construct($context);\n }\n\n \/**\n * Provides content\n *\n * @return Magento\\Framework\\View\\Result\\Page\n * @return Magento\\Framework\\Controller\\Result\\Redirect\n *\/\n public function execute()\n {\n $blogId = $this->getRequest()->getParam('id');\n $customerId = $this->helper->getCustomerId();\n $isAuthorised = $this->blogFactory->create()\n ->getCollection()\n ->addFieldToFilter('user_id', $customerId)\n ->addFieldToFilter('entity_id', $blogId)\n ->getSize();\n if (!$isAuthorised) {\n $this->messageManager->addError(__('You are not authorised to edit this blog.'));\n return $this->resultRedirectFactory->create()->setPath('blog\/manage');\n }\n\n $resultPage = $this->resultPageFactory->create();\n $resultPage->getConfig()->getTitle()->set(__('Edit Blog'));\n $layout = $resultPage->getLayout();\n return $resultPage;\n }\n}<\/pre>\n\n\n\n<?php\nnamespace Webkul\\BlogManager\\Controller\\Manage;\n\nuse Magento\\Customer\\Controller\\AbstractAccount;\nuse Magento\\Framework\\App\\Action\\Context;\n\nclass Save extends AbstractAccount\n{\n \/**\n * @var \\Webkul\\BlogManager\\Model\\BlogFactory\n *\/\n protected $blogFactory;\n\n \/**\n * @var \\Webkul\\BlogManager\\Helper\\Data\n *\/\n protected $helper;\n\n \/**\n * @var \\Magento\\Framework\\Message\\ManagerInterface\n *\/\n protected $messageManager;\n\n \/**\n * Dependency Initilization\n *\n * @param Context $context\n * @param \\Webkul\\BlogManager\\Model\\BlogFactory $blogFactory\n * @param \\Webkul\\BlogManager\\Helper\\Data $helper\n * @param \\Magento\\Framework\\Message\\ManagerInterface $messageManager\n *\/\n public function __construct(\n Context $context,\n \\Webkul\\BlogManager\\Model\\BlogFactory $blogFactory,\n \\Webkul\\BlogManager\\Helper\\Data $helper,\n \\Magento\\Framework\\Message\\ManagerInterface $messageManager\n ) {\n $this->blogFactory = $blogFactory;\n $this->helper = $helper;\n $this->messageManager = $messageManager;\n parent::__construct($context);\n }\n\n \/**\n * Provides content\n *\n * @return Magento\\Framework\\Controller\\Result\\Redirect\n *\/\n public function execute()\n {\n $data = $this->getRequest()->getParams();\n $customerId = $this->helper->getCustomerId();\n if (isset($data['id']) && $data['id']) {\n $isAuthorised = $this->blogFactory->create()\n ->getCollection()\n ->addFieldToFilter('user_id', $customerId)\n ->addFieldToFilter('entity_id', $data['id'])\n ->getSize();\n if (!$isAuthorised) {\n $this->messageManager->addError(__('You are not authorised to edit this blog.'));\n return $this->resultRedirectFactory->create()->setPath('blog\/manage');\n } else {\n $model = $this->blogFactory->create()->load($data['id']);\n $model->setTitle($data['title'])\n ->setContent($data['content'])\n ->save();\n $this->messageManager->addSuccess(__('You have updated the blog successfully.'));\n }\n } else {\n $model = $this->blogFactory->create();\n $model->setData($data);\n $model->setUserId($customerId);\n $model->save();\n $this->messageManager->addSuccess(__('Blog saved successfully.'));\n } \n return $this->resultRedirectFactory->create()->setPath('blog\/manage');\n }\n}<\/pre>\n\n\n\n<?php\nnamespace Webkul\\BlogManager\\Controller\\Manage;\n\nuse Magento\\Customer\\Controller\\AbstractAccount;\nuse Magento\\Framework\\App\\Action\\Context;\n\nclass Delete extends AbstractAccount\n{\n \/**\n * @var \\Webkul\\BlogManager\\Model\\BlogFactory\n *\/\n protected $blogFactory;\n\n \/**\n * @var \\Webkul\\BlogManager\\Helper\\Data\n *\/\n protected $helper;\n\n \/**\n * @var \\Magento\\Framework\\Serialize\\Serializer\\Json\n *\/\n protected $jsonData;\n\n \/**\n * Dependency Initilization\n *\n * @param Context $context\n * @param \\Webkul\\BlogManager\\Model\\BlogFactory $blogFactory\n * @param \\Webkul\\BlogManager\\Helper\\Data $helper\n * @param \\Magento\\Framework\\Serialize\\Serializer\\Json $jsonData\n *\/\n public function __construct(\n Context $context,\n \\Webkul\\BlogManager\\Model\\BlogFactory $blogFactory,\n \\Webkul\\BlogManager\\Helper\\Data $helper,\n \\Magento\\Framework\\Serialize\\Serializer\\Json $jsonData\n ) {\n $this->blogFactory = $blogFactory;\n $this->helper = $helper;\n $this->jsonData = $jsonData;\n parent::__construct($context);\n }\n\n \/**\n * Provides content\n *\n * @return Magento\\Framework\\Controller\\Result\\Redirect\n *\/\n public function execute()\n {\n $blogId = $this->getRequest()->getParam('id');\n $customerId = $this->helper->getCustomerId();\n $isAuthorised = $this->blogFactory->create()\n ->getCollection()\n ->addFieldToFilter('user_id', $customerId)\n ->addFieldToFilter('entity_id', $blogId)\n ->getSize();\n if (!$isAuthorised) {\n $msg=__('You are not authorised to delete this blog.');\n $success=0;\n } else {\n $model = $this->blogFactory->create()->load($blogId);\n $model->delete();\n $msg=__('You have successfully deleted the blog.');\n $success=1;\n } \n $this->getResponse()->setHeader('Content-type', 'application\/javascript');\n $this->getResponse()->setBody(\n $this->jsonData->serialize(\n [\n 'success' => $success,\n 'message' => $msg\n ]\n ));\n }\n}<\/pre>\n\n\n\nCacheable<\/h2>\n\n\n\n
<?xml version="1.0"?>\n<page xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View\/Layout\/etc\/page_configuration.xsd">\n <update handle="customer_account"\/>\n <body>\n <referenceContainer name="content">\n <block class="Webkul\\BlogManager\\Block\\BlogList" name="blogmanager.blog.list" template="Webkul_BlogManager::list.phtml" cacheable="false" \/>\n <\/referenceContainer>\n <\/body>\n<\/page><\/pre>\n\n\n\n
<?xml version="1.0"?>\n<page xmlns:xsi="http:\/\/www.w3.org\/2001\/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:View\/Layout\/etc\/page_configuration.xsd">\n <update handle="customer_account"\/>\n <head>\n\t\t<css src="Webkul_BlogManager::css\/style.css"\/>\n\t<\/head>\n <body>\n <referenceContainer name="content">\n <block class="Webkul\\BlogManager\\Block\\Blog" name="blogmanager.blog.edit" template="Webkul_BlogManager::edit.phtml" cacheable="false" \/>\n <\/referenceContainer>\n <\/body>\n<\/page><\/pre>\n\n\n\n
Show Few More Columns<\/h2>\n\n\n\n
<div class="blog-list-table-container">\n <table class="blog-list-table">\n <tr class="blog-list-table-head">\n <th class="blog-list-table-id">\n <?= __("Id")?>\n <\/th>\n <th class="blog-list-table-title">\n <?= __("Title")?>\n <\/th>\n <th class="blog-list-table-content">\n <?= __("Content")?>\n <\/th>\n <th class="blog-list-table-status">\n <?= __("Status")?>\n <\/th>\n <th class="blog-list-table-date">\n <?= __("Updated At")?>\n <\/th>\n <th class="blog-list-table-date">\n <?= __("Created At")?>\n <\/th>\n <th class="blog-list-table-action-edit">\n <?= __("Edit")?>\n <\/th>\n <th class="blog-list-table-action-delete">\n <?= __("Delete")?>\n <\/th>\n <\/tr>\n <?php\n $blogs = $block->getBlogs();\n $statuses = $escaper->escapeHtml($block->getStatuses());\n foreach ($blogs as $blog) {?>\n <tr class="blog-list-table-row">\n <td class="blog-list-table-id">\n <?= $escaper->escapeHtml($blog->getId())?>\n <\/td>\n <td class="blog-list-table-title">\n <?= $escaper->escapeHtml($blog->getTitle())?>\n <\/td>\n <td class="blog-list-table-content">\n <?= substr($escaper->escapeHtml($blog->getContent()), 0, 20).'...'?>\n <\/td>\n <td class="blog-list-table-status">\n <?= $escaper->escapeHtml($statuses[$escaper->escapeHtml($blog->getStatus())])?>\n <\/td>\n <td class="blog-list-table-date">\n <?= $escaper->escapeHtml($block->getFormattedDate($escaper->escapeHtml($blog->getUpdatedAt())))?>\n <\/td>\n <td class="blog-list-table-date">\n <?= $escaper->escapeHtml($block->getFormattedDate($escaper->escapeHtml($blog->getCreatedAt())))?>\n <\/td>\n <td class="blog-list-table-action blog-list-table-action-edit">\n <a href="<?= $escaper->escapeUrl($block->getUrl('blog\/manage\/edit', ['id'=>$blog->getId()]))?>">\n <?= __('Edit') ?>\n <\/a>\n <\/td>\n <td class="blog-list-table-action blog-list-table-action-delete">\n <a href="<?= $escaper->escapeUrl($block->getUrl('blog\/manage\/delete', ['id'=>$blog->getId()]))?>">\n <?= __('Delete') ?>\n <\/a>\n <\/td>\n <\/tr>\n <?php } ?>\n <\/table>\n<\/div>\n<script type="text\/x-magento-init">\n {\n "*": {\n "bloglist": ""\n }\n }\n<\/script><\/pre>\n\n\n\ngetStatuses<\/code><\/strong> which will return an associative array with an integer (0 or 1) as the key and the status label as the value. Using this we can show the label based on the value.<\/p>\n\n\n\n<?php\nnamespace Webkul\\BlogManager\\Block;\n\nclass BlogList extends \\Magento\\Framework\\View\\Element\\Template\n{\n \/**\n * @var \\Webkul\\BlogManager\\Model\\ResourceModel\\Blog\\CollectionFactory\n *\/\n protected $blogCollection;\n\n \/**\n * @var \\Webkul\\BlogManager\\Helper\\Data\n *\/\n protected $helper;\n\n \/**\n * @var \\Webkul\\BlogManager\\Model\\Blog\\Status\n *\/\n protected $blogStatus;\n\n \/**\n * @var \\Magento\\Framework\\Stdlib\\DateTime\\TimezoneInterface\n *\/\n protected $date;\n\n \/**\n * Dependency Initilization\n *\n * @param \\Magento\\Framework\\View\\Element\\Template\\Context $context\n * @param \\Webkul\\BlogManager\\Model\\ResourceModel\\Blog\\CollectionFactory $blogCollection\n * @param \\Webkul\\BlogManager\\Helper\\Data $helper\n * @param \\Webkul\\BlogManager\\Model\\Blog\\Status $blogStatus\n * @param \\Magento\\Framework\\Stdlib\\DateTime\\TimezoneInterface $date\n * @param array $data\n *\/\n public function __construct(\n \\Magento\\Framework\\View\\Element\\Template\\Context $context,\n \\Webkul\\BlogManager\\Model\\ResourceModel\\Blog\\CollectionFactory $blogCollection,\n \\Webkul\\BlogManager\\Helper\\Data $helper,\n \\Webkul\\BlogManager\\Model\\Blog\\Status $blogStatus,\n \\Magento\\Framework\\Stdlib\\DateTime\\TimezoneInterface $date,\n array $data = []\n ) {\n $this->blogCollection = $blogCollection;\n $this->helper = $helper;\n $this->blogStatus = $blogStatus;\n $this->date = $date;\n parent::__construct($context, $data);\n }\n\n \/**\n * Get Blog List\n *\n * @return \\Webkul\\BlogManager\\Model\\ResourceModel\\Blog\\Collection\n *\/\n public function getBlogs()\n {\n $customerId = $this->helper->getCustomerId();\n $collection = $this->blogCollection->create();\n $collection->addFieldToFilter('user_id', ['eq'=>$customerId])->setOrder('updated_at', 'DESC');\n return $collection;\n }\n\n \/**\n * Get Blog Status\n *\n * @return boolean\n *\/\n public function getStatuses()\n {\n $statuses = [];\n foreach ($this->blogStatus->toOptionArray() as $status) {\n $statuses[$status['value']] = $status['label'];\n }\n return $statuses;\n }\n\n \/**\n * Get Formatted Date\n *\n * @param date $date\n * @return date\n *\/\n public function getFormattedDate($date)\n {\n return $this->date->date($date)->format('d\/m\/y H:i');\n }\n}<\/pre>\n\n\n\n![\"2021-08-03_10-36\"](\"https:\/\/cdnblog.webkul.com\/blog\/wp-content\/uploads\/2021\/08\/2021-08-03_10-36-1200x516.png\")
<\/figure>\n\n\n\n
<\/p>\n\n\n\n