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

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.

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"

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.

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

<= value1 nil
   value2 nil

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

This operator could be used in combination with “IF“, “FOR” and “WHEN” operators.

EXAMPLES:

FOR variable pos
    initial 1
    test <= value1 pos
            value2 10
    update pos + 1
  TEXT GRAB
         pos
         " "

In this example, the operator “<=” checks a loop property “pos“. The loop continues its work as long as the “pos” value is less or equal to 10.

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.

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]

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]

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