Спеціальні теги в Magento.
[tweetmeme source=”magentoua” only_single=false https://magentoua.wordpress.com/2010/06/01/magento-special-tags%5D
Ця стаття містить опис тегів, які можна використовувати на CMS сторінках, в статичних блоках та e-mail темплейтах.
Що таке тег темплейту?
Тег темплейту це шматок тексту в середині подвійних фігурних дужок, які для Magento мають своє значення, на пр., {{store url=""}}
.
Ви можете використовувати темплейт теги для:
- Вставляння посилань на сторінку в межах магазину без прописування домену
- Вставляння блоку в сторінку без того щоб редагувати layout і темплейт файли.
Темплейт теги мають багато застосувань.
Де можна використовувати темплейт теги?
Ви можете використовувати темплейт теги на CMS сторінках, в описах продуктів та категорій, в статичних блоках та e-mail темплейтах.
Яким чином їх використовувати?
Ви використовуєте теги вводячи їх у місця в Magento, які були перелічені вище.
Щоб проілюструвати процес, припустимо, що Вам потрібно показати малюнок «50% знижки» на головній сторінці вашого магазину. (Ви можете поредагувати головну сторінку в панелі адміністратора. Для цього перейдіть на CMS > Manage Pages та клікніть на «Home Page»).
Ви можете прописати шлях до малюнку наступним чином:
<img src="http://www.example.com/skin/frontend/default/default/images/media/50sale.jpg" alt="" />
Але простіше(і правильніше) використати для цього теги і прописати наступне:
<img src="{{skin url='images/media/about_us_img.jpg'}}" alt="" />
Які теги можна використовувати?
Нотатка: В наступних прикладах ми припускаємо, що робоча версія Magento встановлена на http://www.example.com.
Ви можете використовувати наступні теги:
1. {{block id=’block_id’}}
Цей тег вставляє статичний блок з ідентифікатором «block_id» (Редагувати статичні блоки можна в панелі адміністратора CMS > Static Blocks.)
Приклад:
{{block id='footer_links'}}
Цей код вставить статичний блок «Footer Links».
2. {{block type=’module/package_classname’ template=’path/to/template.phtml’}}
Цей вставить блок з типом module/package_classname
використовуючи темплейт path/to/template.phtml. Стрічка module/package_classname
перетвориться в назву класу який визначений в директорії Block
даного модуля. (Для прикладу, core/text_list
перекладається в Mage_Core_Block_Text_List
, який визначений в app/code/core/Mage/Core/Block/Text/List.php)
Якщо директорія Block
модуля не містить піддиректорій то частинка стрічки package_
упускається. (Таким чином стрічка tag/popular
перетворюється в Mage_Tag_Block_Popular
, який визначений в app/code/core/Mage/Tag/Block/Popular.php)
Значення атрибуту template
повинно бути шляхом до темплейту даного блоку, починаючи від директорії теми (на пр. tag/popular.phtml )
Приклад:
{{block type='core/template' template='cms/custom_page.phtml'}}
Цей код витягне cms/custom_page.phtml
в сторінку/e-mail.
3. {{htmlescape var=” allowed_tags=”}}
Ескейпить всі HTML теги, які є в значенні атрибуту var
, крім тих, які є в атрибуті allowed_tags
(список дозволених HTML тегів розділених комою).
Приклад:
{{htmlescape var='<a href="alert(1);">Hello</a>'}}
Результатом цього коду буде вивід <a href="alert(1);">Hello</a>
, тобто теги виведуться, як текст і не будуть інтерпритуватися браузером.
4. {{layout handle=”}}
Вставляє HTML вивід layout. Атрибут handle
повинен мати ім’я layout handle, на пр. default.
5. {{media url=”}}
Додає URL директорії media, на пр., http://www.example.com/media/. Зміна значення url
атрибуту на будь-який не порожній додасть його до цього URL.
Приклад:
{{media url='catalog/product/l/a/large_phone.jpg'}}
Буде мати такий вивід
http://www.example.com/media/catalog/product/l/a/large_phone.jpg.
6. {{skin url=”}}
Додає URL директорії skin
поточної теми, на пр., http://www.example.com/skin/frontend/default/default/.
Зміна значення url
атрибуту на будь-який не порожній додасть його до цього URL.
Приклад:
Ми припускаємо що у вас є активною тема default і default package.
{{skin url='images/media/about.jpg'}}
зконвертується в
7. {{store url=”}}
Додає base URL магазину. Якщо значення атрибуту url
порожнє, то ми потрапимо на головну сторінку (http://www.example.com/). Зміна значення url
атрибуту на будь-який не порожній додасть його до цього base url
вашого сайту, а також додасть слеш(/) вкінці згенерованого url. Це робить його зручним якщо потрібно вказати шлях до директорії на пр. customer/account.
Приклад:
{{store url='about-magento-demo-store'}}
перетвориться в
http://www.example.com/index.php/about-magento-demo-store/
8. {{store direct_url=”}}
Робить те ж саме що {{store url=''}}
, але не додає в кінці слеш (/). Його зручно використовувати для шляхів до файлів, на пр. coffee/kona-fancy-whole-bean.html
Сподобалася стаття? Підпишись на RSS або на e-mail розсилку. А ще приєднуйся до нас у Твітері @magentoua.
Де можна використовувати темплейт теги? – можно использовать и в описании товаров и категорий
Але простіше використати для цього теги і прописати наступне: – не проще, прописывать абсолютные пути это не правильно. Допустим Вы решите отдавать статику с другого домена (что бы было быстрее) или вообще измените base_url в настройках (поменяете имя сайта) так вот если все было прописано статически то придется ходить по всем полям и исправлять ручками.
Цілком слушно. Додав до статті.
Цілком згідний що не правильно, але там і не написано, що потрібно прописувати абсолютні шляхи. Навпаки ми наполегливо рекомендуємо використовувати тег
{{skin url=”}}
або{{media url=”}}
для малюнків. І якщо в майбутньому буде потрібно віддати статику з ішного місця то це буде легко налаштувати в панелі адміністратора System->Configuration->Web.