cleatsquad / magento-smarty
Smarty template engine for Magento 2
Installs: 4
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 1
Forks: 0
Open Issues: 0
Type:magento2-module
Requires
- magento/framework: >=100.0.0
- magento/module-backend: >=100.0.0
- magento/module-config: >=100.0.0
- smarty/smarty: ^3.0
Requires (Dev)
- php-coveralls/php-coveralls: ^2.1
- phpmd/phpmd: ^2.6
- phpunit/phpunit: ^6.5
- sebastian/phpcpd: ^3.0
- squizlabs/php_codesniffer: ^3.3
This package is auto-updated.
Last update: 2024-10-12 02:05:05 UTC
README
Magento Version Support
Purpose
CleatSquad_Smarty
is a Magento 2 module is an integration of the Smarty template engine in Magento2.
To use this package you need to write your Magento2 module, or you can write all your template files in Smarty.
This template engine is intended to be used in addition to the .tpl
files.
Getting Started
This module is intended to be installed via Composer. To add it to your Magento 2 project, follow these steps:
Installation
-
Download the package
composer require cleatsquad/magento2-smarty
-
Enable the module
./bin/magento module:enable CleatSquad_Smarty ./bin/magento setup:upgrade
Magento 2
Components
A new engine has been added to this module which will allow you to use smarty. and this the injection of the new engine in the class Magento\Framework\View\TemplateEngineFactory.
Frontend Integration
Your template files must have the file extension .tpl
to get automatically recognized.
In your layout xml files or blocks please specify the new template
<referenceBlock name="page.main.title" template="Magento_Theme::html/title.tpl"/>
Example header.phtml converted to header.tpl
<?php /** * @var $block \Magento\Theme\Block\Html\Title */ $cssClass = $block->getCssClass() ? ' ' . $block->getCssClass() : ''; $titleHtml = ''; if (trim($block->getPageHeading())) { $titleHtml = '<span class="base" data-ui-id="page-title-wrapper" ' . $block->getAddBaseAttribute() . '>' . $block->escapeHtml($block->getPageHeading()) . '</span>'; } ?> <?php if ($titleHtml) : ?> <div class="page-title-wrapper<?= $block->escapeHtmlAttr($cssClass) ?>"> <h1 class="page-title" <?php if ($block->getId()) : ?> id="<?= $block->escapeHtmlAttr($block->getId()) ?>" <?php endif; ?> <?php if ($block->getAddBaseAttributeAria()) : ?> aria-labelledby="<?= $block->escapeHtmlAttr($block->getAddBaseAttributeAria()) ?>" <?php endif; ?>> <?= /* @noEscape */ $titleHtml ?> </h1> <?= $block->getChildHtml() ?> </div> <?php endif; ?>
{if ($block->getCssClass())} {assign var = "cssClass" value = {$block->getCssClass()}}} {else} {assign var = "cssClass" value = ''}} {/if} {if (trim($block->getPageHeading()))} {assign var = "titleHtml" value = '<span class="base" data-ui-id="page-title-wrapper" {$block->getAddBaseAttribute()}>{$block->escapeHtml($block->getPageHeading())}</span>'} {else} {assign var = "titleHtml" value = ''}} {/if} {if ($titleHtml)} <div class="page-title-wrapper{$block->escapeHtmlAttr($cssClass)}"> <h1 class="page-title" {if ($block->getId()) : ?> id={$block->escapeHtmlAttr($block->getId())}"{/if} {if ($block->getAddBaseAttributeAria()) : ?> aria-labelledby="{$block->escapeHtmlAttr($block->getAddBaseAttributeAria())}" {/if}> {$titleHtml} </h1> {$block->getChildHtml()} </div> {/if}
<referenceBlock name="breadcrumbs" template="Magento_Theme::html/breadcrumbs.tpl"/>
Example breadcrumbs.phtml converted to breadcrumbs.tpl
<?php if ($crumbs && is_array($crumbs)) : ?> <div class="breadcrumbs"> <ul class="items"> <?php foreach ($crumbs as $crumbName => $crumbInfo) : ?> <li class="item <?php echo $crumbName ?>"> <?php if ($crumbInfo['link']) : ?> <a href="<?php echo $crumbInfo['link'] ?>" title="<?php echo $this->escapeHtml($crumbInfo['title']) ?>"> <?php echo $this->escapeHtml($crumbInfo['label']) ?> </a> <?php elseif ($crumbInfo['last']) : ?> <strong><?php echo $this->escapeHtml($crumbInfo['label']) ?></strong> <?php else: ?> <?php echo $this->escapeHtml($crumbInfo['label']) ?> <?php endif; ?> </li> <?php endforeach; ?> </ul> </div> <?php endif; ?>
{if $crumbs} <div class="breadcrumbs"> <ul class="items"> {foreach from = $crumbs key = crumbName item = crumbInfo} <li class="item {$crumbName}"> {if $crumbInfo.link} <a href="{$crumbInfo.link}" title="{$crumbInfo.title}"> {$crumbInfo.label} </a> {elseif $crumbInfo.last} <strong>{$crumbInfo.label}</strong> {else} {$crumbInfo.label} {/if} </li> {/foreach} </ul> </div> {/if}
Access helper methods
Write in your .tpl
file:
{assign var = "directoryHelper" value = $this->helper("Magento\Directory\Helper\Data")} {$directoryHelper->getDefaultCountry()}
Configurations
Configuration options can be found Stores -> Settings -> Configuration -> Advanced -> Developer -> Smarty.
Support
If you need help or have a question, you can:
- Open an issue through GitHub for bug reports and feature requests.
- Check the Magento Community Forums for general questions and support on Magento.
- Check on Magento Stack Exchange for general programming questions.
Versioning
We use SemVer for versioning. For the versions available, see the tags on this repository.
Authors
- Mohamed EL Mrabet - Initial work - mimou78
License
This project is licensed under the MIT License - see the LICENSE file for details.