X-Cart forums

[ARW VISIONS]

I'm pretty sure I asked this before.. but.

I found this.
<ul class="account-links cf " IF="isAccountLinksVisible()">
<list name="layout.header.bar.links.newby" />
</ul>

How do I edit that list. I'd like view cart and checkout added.

[totaltec]

You assign things to the list, and take them away.
Templates can assign themselves to lists, and so can PHP classes.

Here is a class adding itself to a list:
* @ListChild (list="center", zone="customer")

And a template:
* @ListChild (list="capost_create_return.form.columns", weight="15")

In both cases you will see these declarations in the commented out section at the top of the file. I prefer to add templates/classes to lists by decorating the class or overriding the original template.

You can also do a lot of heavy lifting right in your main.php file.

To add a class or a template to a list, you wrap the call to the addClassToList() method in a function called runBuildCacheHandler() like this:

    public static function runBuildCacheHandler()
    {
        parent::runBuildCacheHandler();

        \XLite\Core\Layout::getInstance()->addClassToList(
            'XLite\Module\CDev\Bestsellers\View\Bestsellers',
            'sidebar.second',
             array(
                'zone'   => \XLite\Model\ViewList::INTERFACE_CUSTOMER,
                'weight' => 100,
             )
        );

        \XLite\Core\Layout::getInstance()->addTemplateToList(
           'modules/CDev/XMLSitemap/menu.tpl',
           'sidebar.second',
           array(
               'zone'   => \XLite\Model\ViewList::INTERFACE_CUSTOMER,
               'weight' => 100,
           )
        );
    }

You can remove a class from a list, and remove a template from a list in your main.php like this:

    /**
     * Decorator run this method at the end of cache rebuild
     *
     * @return void
     */
    public static function runBuildCacheHandler()
    {
        parent::runBuildCacheHandler();

        \XLite\Core\Layout::getInstance()->removeClassFromList(
            'XLite\View\LanguageSelector\Customer',
            'layout.header.bar.links.newby',
            \XLite\Model\ViewList::INTERFACE_CUSTOMER
        );

        \XLite\Core\Layout::getInstance()->removeTemplateFromLists(
            'layout/main.location.tpl'
        );
    }

You can move classes in lists:

protected static function moveClassesInLists()
    {
        return array(
            'XLite\View\LanguageSelector\Customer' => array(
                array('layout.header.bar.links.logged', 'customer'),
                array('layout.header.magnifico.top.bar', 50, 'customer'),
            ),
        );
    }

Move templates in lists:

protected static function moveTemplatesInLists()
    {   
        $templates_list = array();
        
        $templates_list = array(
            'layout/header.bar.search.tpl' => array(
                array('layout.header.bar', 'customer'),
                array('layout.header.bar', 30, 'customer'),
            ),
            'layout/header.right.tpl' => array(
                array('layout.header', 'customer'),
                array('layout.header', 350, 'customer'),
            ),
        );
        
        return $templates_list;
    }

I took most of these examples from my Magnifico template, but you can see where I originally learned them in XLite\Core\Layout.php

[ARW VISIONS]

seems a bit heavy handed to add a couple of links to a template. why is it done like this?

[totaltec]

Originally Posted by ARW VISIONS

seems a bit heavy handed to add a couple of links to a template. why is it done like this?

This lets you have complete control! Modules can assign whatever they want to lists, create lists, take things away etc.

I may have over-complicated my answer, I just wanted to arm you with all the info.

If you want to just add a couple links, you can either create a new template with your links, and assign that template to the list using the very first method I described * @ListChild (list="capost_create_return.form.columns", weight="15")

Or you can ovverride a template that is already added using your custom skin, and add the links there.

[zychen]

Hey Mike,

If you had a little time, could you confirm that removeTemplateFromLists is working in 5.2.x please?
My templates have started to mess up since my upgrade, have you faced any similar issues with the upgrade recently?

-Niboon

[totaltec]

Niboon,
I just attempted to upgrade a test site to 5.2.X for the first time, and I am having some major issues. So I cannot confirm this yet. I have not recommended any of my clients upgrade to 5.2 yet, because I can't seem to get it to go smoothly on any of my test environments.

[zychen]

I have found out what changed from version 5.1.x. for RemoveTemplateFromLists() in 5.2.x

 RemoveTemplateFromLists('items_list\product\parts\list.button-add2cart.tpl') 

does not work but

 RemoveTemplateFromLists('items_list/product/parts/list.button-add2cart.tpl') 

works.

It seems that backslash has stopped working and you HAVE to use forward slashes only.

[qualiteam]

I believe backslashes never worked on linux servers, only Windows understands that "\" is the same as "/" in file paths.

[zychen]

Yes, I should mention that I've only used Windows for X-Cart.