PHP Master | OXID eSales - The E-Commerce Platform that Just Works! 2

This article explores OXID eSales, a robust e-commerce platform, focusing on its theming system and customization capabilities. Part one introduced the platform; this part delves into theme creation and modification.

Key Concepts:

• OXID eSales is a high-quality, easily extensible e-commerce solution leveraging the Smarty template engine for theme development. This allows for PHP-like syntax within templates.
• Themes in OXID manage data from the business logic layer (core libraries, modules, extensions). They can be built from scratch or extended from existing themes like the default "Azure" theme.
• Customization options are extensive, ranging from logo changes and element removal to adding user profile content. This is achieved by modifying templates and interacting with OXID template objects.
• OXID's modular architecture, multi-language and currency support, and robust security features make it suitable for diverse businesses.
• A future installment will cover custom module creation for advanced customization.

Understanding OXID Themes:

OXID themes function similarly to those in other applications. They allow developers and designers to manipulate data accessed through core libraries, custom modules, and extensions. The Smarty engine enables PHP-like syntax and full PHP core access if needed.

The following header.tpl snippet illustrates Smarty tags within HTML:

<code>[{assign var="slogoImg" value="logo.png"}]
<a href="https://www.php.cn/link/0b49b88c68f7ecbdb73f50496c084a1e" id="logo"> </a>
<img src="/static/imghwm/default1.png" data-src="https://img.php.cn/?x-oss-process=image/resize,p_40" class="lazy" alt="PHP Master | OXID eSales - The E-Commerce Platform that Just Works! 2">oxshops__oxtitleprefix->value}]">
[{oxid_include_widget cl="oxwCategoryTree" cnid=$oView->getCategoryId() sWidgetType="header" _parent=$oView->getClassName() nocookie=1}]
[{if $oxcmp_basket->getProductsCount()}]
    [{assign var="blAnon" value=0}]
    [{assign var="force_sid" value=$oViewConf->getSessionId()}]
[{else}]
    [{assign var="blAnon" value=1}]
[{/if}]
[{oxid_include_widget cl="oxwMiniBasket" nocookie=$blAnon force_sid=$force_sid}]
[{include file="widget/header/search.tpl"}]
[{if $oView->getClassName()=='start' && $oView->getBanners()|@count > 0 }]
    <div class="oxSlider">
        [{include file="widget/promoslider.tpl" }]
    </div>
[{/if}]</code>

OXID provides custom Smarty plugins under /core/smarty/plugins. The example above demonstrates conditional logic, template inclusion, and widget usage (oxwCategoryTree, oxwMiniBasket). Database access is achieved via magic methods on OXID objects (e.g., $oxcmp_shop->oxshops__oxtitleprefix->value).

Theme File Structure (CE 4.7 , PE/EE 5.0 ):

• /application/views/<theme>/</theme>: Templates, translations, configuration files.
• /out/<theme>/</theme>: Public files (CSS, JavaScript, images).

Creating a Custom Theme ("sitepoint"):

We'll extend the "Azure" theme. Create application/views/sitepoint/theme.php:

<code>[{assign var="slogoImg" value="logo.png"}]
<a href="https://www.php.cn/link/0b49b88c68f7ecbdb73f50496c084a1e" id="logo"> </a>
<img src="/static/imghwm/default1.png" data-src="https://img.php.cn/?x-oss-process=image/resize,p_40" class="lazy" alt="PHP Master | OXID eSales - The E-Commerce Platform that Just Works! 2">oxshops__oxtitleprefix->value}]">
[{oxid_include_widget cl="oxwCategoryTree" cnid=$oView->getCategoryId() sWidgetType="header" _parent=$oView->getClassName() nocookie=1}]
[{if $oxcmp_basket->getProductsCount()}]
    [{assign var="blAnon" value=0}]
    [{assign var="force_sid" value=$oViewConf->getSessionId()}]
[{else}]
    [{assign var="blAnon" value=1}]
[{/if}]
[{oxid_include_widget cl="oxwMiniBasket" nocookie=$blAnon force_sid=$force_sid}]
[{include file="widget/header/search.tpl"}]
[{if $oView->getClassName()=='start' && $oView->getBanners()|@count > 0 }]
    <div class="oxSlider">
        [{include file="widget/promoslider.tpl" }]
    </div>
[{/if}]</code>

Create /out/sitepoint/img and /out/sitepoint/src, adding theme.jpg and a modified logo.png. Activate the theme in the admin panel. Clear the /tmp directory to clear OXID's cache.

Customization Examples:

• Logo Change: Replacing logo.png updates the logo.
• Removing Image Scroller: Removing the relevant code block from application/views/sitepoint/tpl/layout/header.tpl (copied from azure).
• Adding User Profile Content: Modifying application/views/sitepoint/tpl/page/account/dashboard.tpl and adding translations in application/views/sitepoint/de/cust_lang.php and application/views/sitepoint/en/cust_lang.php.

Conclusion:

This guide demonstrates OXID's theming system, enabling straightforward customization. Part 3 will explore custom module development for advanced customization.

(Note: Image URLs are assumed to be correctly functional within the original context. They are retained in the output as requested.)

The above is the detailed content of PHP Master | OXID eSales - The E-Commerce Platform that Just Works! 2. For more information, please follow other related articles on the PHP Chinese website!