ALPHA STORE DESIGN STUDIO - authorized Yahoo! Small Business Partner
call us at (908).338.3992
 
About Us
Portfolio
System Additions for Store Pages
Custom Graphic Design. How It Works
/
BLOG: A few "tips" and "RTML secrets" of Yahoo store.

OUR BLOG: Yahoo Store from A to Z and RTML development "secrets".


Editing of RTML templates

Let’s suppose that you’ve just opened a brand new Yahoo store account. You’re excited and ready to put up your items for sale. But hold on a second. Before you upload the inventory items we insist that you follow these steps to create a list of Editable Templates.

By default RTML templates cannot be edited. To be capable of enhancing these templates, you need to make copies of all your base templates. This is a necessary step because afterwards, these template copies and newly created templates will have the possibility of being altered and edited.

As we have already said, you must make this list of Editable Templates before you upload any items because it will help you avoid the process of changing the templates for each item one by one.

So how does someone create a list of Editable Templates?

The first step you must take is to turn on the Advanced Editor Mode in the Control panel.

Yahoo Store Advance Editor Button

You will now see a second row of control buttons on the bottom of your main page

Yahoo Store Advance Editor Mode

-Click on the tab called “Contents”

-In the contents page, click the yellow button named “Templates

-Once you access this page you will see a list of all the templates.

-Find the template “Storetemplate.” and click to open it.

-Find the “Copy Template” button and click it.

RTML "Storetemplate." Copy Template button

-There will be a field that will appear where you have to type in a name for the new template. An example could be, “New-Storetemplate

-Click the “Copy” button.

Yahoo Store Editor - Template Copy

Congratulations. You have successfully created a List of Editable Templates! To recap, this was made possible through a process of copying the parental template (Storetemplate). Afterward, the RTML system automatically copies subsequent templates on it’s own, and all you need to do is apply this new template to your store pages by editing the store properties. This method will benefit you because you will have fewer pages to edit, and your workload will greatly decrease.

For example, let’s edit the first page of the site (Home page). Open up the Home page and click Edit. Then within the “Template” property change Storetemplate to New-Storetemplate and click on the Update button. Do not worry; the page layout will remain the same, because the new template is the exact copy of the old one.

Finally, all you need to do is apply some changes to the Config page. This is marked by a yellow button called “Config” at the top or bottom of your store pages (depending on the page settings).

Yahoo Store Editor Config Button

When you are in the Config page you must edit three drop-down menus (Default-item-template, Default-section-template, Default-group-template) and change Store-template to the new editable template.

As a result of taking these steps you now have the possibility to edit templates and to have all newly created pages under an editable template by default.

In our future articles we will discuss how to improve your Yahoo Store functionality by adding some small changes to the templates.

-Click on the tab called “Contents”

-In the contents page, click the yellow button named “Templates”

How to add the “AddThis” button to Yahoo Store pages

1) To add “Bookmark & Share” button to store pages, go to www.Addthis.com first and receive the code from there.

There is the example of such a code:

<!– AddThis Button BEGIN –>
<a class=”addthis_button” href=”http://www.addthis.com/bookmark.php?v=250&amp;username=xa-4c3eff9c2b54f517″><img src=”http://s7.addthis.com/static/btn/v2/lg-share-en.gif” width=”125″ height=”16″ alt=”Bookmark and Share” style=”border:0″/></a><script type=”text/javascript” src=”http://s7.addthis.com/js/250/addthis_widget.js#username=xa-4c3eff9c2b54f517″></script>
<!– AddThis Button END –>

Note: If you want to get the sharing statistics, you have to register on addthis.com.

2) Create a global variable -share-code (med-text) and place and paste the code into it. See more details here: http://www.alphastoredesign.com/blog/2010/03/11/how-to-add-global-or-local-properties ).

3) Open a list of store Templates. Then find custom Item-order template.

Store template Item-order
Click on it and open.

Find the RTML expression:

WHEN OR
       @price
       @sale-price

Click on WHEN.

Click the “New” button and create a TEXT operator. Then click the “Paste After”. After this click the “EDIT” button and set the value of TEXT operator to @-share-code

After these simple procedures the “Add This” button will appear on every item page near the “Add to Cart” button.

RTML Operator “BLUE”

Within Yahoo Store RTML Template, this operator is showing as:

BLUE nil

The operator takes color value and returns its blue component of RGB (red green blue) color model in numeric value between 0 and 255.

EXAMPLES:

  WITH= variable blue
        value BLUE @background-color
    WITH= variable red
          value RED @background-color
      WITH= variable green
            value GREEN @background-color
        BODY background-color COLOR red red - 20
                                    green green - 20
                                    blue blue - 20

At this example, we took Red Green and Blue color components from the global variable @background-color. Then, we are using these components to make the body background darker.

Custom Yahoo Store Availability 2

In the previous “Custom Availability” post we explained how to use the Custom Availability property together with the system Availability property. This method requires basic RTML knowledge.

Next, we will show you how to implement a “Custom availability” text field instead of using the pre-defined property Availability. This method is simpler than the previous one.

First, open a list of store Templates. Then find custom Item-order template.

Store template Item-order

Click on it to open.
Find the RTML expression WHEN @availability.
Click on @availability.

Click the “New” button and create a NONEMPTY operator. Then click “Replace”. As a result, the NONEMPTY RTML operator will replace the original @availability expression.

Click the “EDIT” button and set the value of NONEMPTY operator to @custom-availability

WHEN NONEMPTY @custom-availability

Find the RTML expression STRING-APPEND:

TEXT STRING-APPEND
       GRAB
         TAG tag "em"
           TEXT "Availability: "
       @availability

We have to replace @availability property with @custom-availability. For this purpose click on the STRING-APPEND operator and then click the EDIT button. Change @availability to @custom-availability and click update:

WHEN NONEMPTY @custom-availability
  DIV class "itemavailable"
    TEXT STRING-APPEND
           GRAB
             TAG tag "em"
               TEXT "Availability: "
           @custom-availability

Finally, define the custom property @custom-availability (type text) at the item page or at the item type and fulfill it with its necessary value.

RTML Operator “APPEND”

In an RTML Template the “APPEND” operator looks like:

APPEND

This operator joins all sequences pasted within.

NOTE You cannot paste a text string within APPEND operator because it will result in RTML error.

EXAMPLE

WITH= variable bestsellers-ids-together
      value APPEND
              @local-bestsellers-ids
              @global-bestsellers-ids
  TEXT bestsellers-ids-together

In this example, we combine two ID sequences. Then we write the resulting sequence into the text spot.

RTML Operator “ACTION”

In an RTML Template the “ACTION” operator looks like:

ACTION nil

This operator returns a special Yahoo Store URL that will perform a certain action. The possible arguments are :

:email (returns argument mailto: and the e-mail address from the email global variable),
:help (returns http://stores.yahoo.com/help.html),
:request,
:search (returns search page URL), and
:show-order (returns Yahoo basket URL).

EXAMPLE:

FORM destination ACTION :show-order
     method "post"

RTML Operator “>=” [greater than or equal to]

In the Yahoo Store RTML Template a newly created “>=” operator looks like:

>= value1 nil
   value2 nil

This operator compares two numbers. If the first argument is greater or equal to the second one, then the operator returns “true”.

EXAMPLES:

FOR variable pos
    initial 10
    test <= value1 pos
            value2 0
    update pos - 2
  TEXT GRAB
         pos
         " "

In this example the operator “>=” checks a loop property “pos”. The loop continues to work as long as the “pos” value is greater or equal to zero.

How to implement the Quantity box beside the “BUY” button at your item/product pages

By default, the Yahoo store system does not include a quantity box on its store pages. After a few changes in the RTML template it will be possible to apply this feature, and customers will then have the possibility to order more than one item.

First, make sure you have editable copies of your store RTML templates.

Now open the page with a list of store Templates.

Find the template that corresponds to adding the items to the shopping cart. Because it is a copy of a default template called add-to-cart, it will be named something such as, your-store-add-to-cart. Click and open it.

Add to cart RTML Template

Now you will see the template content. At this point, we recommend you make a copy of your existing template by clicking the Copy Template button (just in case if you need to restore it).

At the top of the template content click the operator “IF”. It will become active (not linked, black colored).


Click the button [NEW] at the toolbar. There you will see a selection field called “Complex”, scroll within it to find the operator “INPUT”.

Click the button [CREATE]

Adding RTML Operator Input into the RTML Template

The newly created operator will appear in the “basement” area, below the template content. We need to place it before the recent operator IF.

Now, “IF” is active. “INPUT” is in the basement. Click the button [Replace] in the toolbar. These operators will then rotate their places: “IF” will go to the basement area, “INPUT” will become the first operator (active). Now click the button [Paste After] and then “IF” will be replaced after the “INPUT”.

The last step is to customize the operator “INPUT”.

Click it to make it active. Click the button [EDIT] in the top toolbar. Define the following values:

Name – :vwquantity
type – :text
value – 1
maxlength – 3
size – 3

Click [UPDATE]

Editing the RTML Operator Input

All done. The quantity box will now appear at your store item pages.

How to add Global or Local properties

If the property is going to be used only on a particular page, it is referred to as “Local” and is located on that page under the “Custom properties” header.
If the property is going to be used on the entire store, then it is called “Global” and is located in the “Variables” section (see page’s Editor toolbar) under “Custom Variables” header.

To add a Local custom property open a particular page, then click the [Edit] button on the Editor toolbar.

Yahoo Store Editor Edit Button

Click the [New Property] button. Input the Name of a new property, and select its type.
Click [Update]

To add a Global custom property, click the button [Variables] at the Editor toolbar.
Click the button [Define New Variable] on the page toolbar.

Define New Variable in Yahoo Store Editor

Input the Name of a new property, and then select its type.
Click [Update]