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".


RTML resources


RTML Operator “AS-LIST”

In an RTML template the newly created operator looks like:

AS-LIST type nil
        class nil
        id nil
        style nil
        title nil

This operator insert <ul>….</ul> or <ol>….</ol> lists html tags into the page code. The type of tag depends on the attribute type value, either :оrdered or :unordered

EXAMPLE

AS-LIST type :оrdered
  ITEM 
    TEXT "First Notation"
  ITEM
    TEXT "Second Notation"

The HTML code will be generated as:

<ol><li>First Notation</li><li>Second Notation</li></ol>

RTML Operator “ACCUMULATE”

In an RTML Template, the “ACCUMULATE” operator looks like:

ACCUMULATE result_var nil
           iter_var nil
           result_init nil
           sequence nil

This operator accumulates certain values in result_var. At the beginning of iteration, result_var holds the value of the result_init variable. Sequence holds the list of objects (for example: the list of items). The ACCUMULATE operator takes elements from this list and passes them into iter_var variable one by one. Then the ACCUMULATE operator evaluates the expression assigned within it and passes the result to result_var.

Let’s look at the following example:

WITH= variable maximum-price
      value ACCUMULATE result_var maxprice
                       iter_var item
                       result_init MINNUM
                       sequence @contents
              MAXIMUM
                maxprice
                WITH-OBJECT item
                  ELEMENT position 0
                          sequence OR
                                     @price
                                     @sale-#price
  WITH= variable minimum-price
        value ACCUMULATE result_var minprice
                         iter_var item
                         result_init MAXNUM
                         sequence @contents
                MINIMUM
                  minprice
                  WITH-OBJECT item
                    ELEMENT position 0
                            sequence OR
                                       @price
                                       @sale-price
    TEXT GRAB
           "price from $"
           TEXT minimum-price
           " to $"
           TEXT maximum-price

In this example, we are defining the minimum and maximum price for the products that is in the listing page’s built-in property contents. For this purpose, we are also using RTML operators MINNUM and MAXNUM. They hold the minimum and maximum numbers in the Yahoo store system. If we want to get the minimum price, then we have to determine the maximum value first in result_init , if we want to obtain the maximum item price, then we have to determine the minimum value first in result_init. Within the ACCUMULATE operator we compare item_var and item price. Then the result will passed to item_var

RTML Operator “>” [greater than]

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

> value1 nil
  value2 nil

The purpose of this operator is to compare two numbers. If the first argument is greater than the second one, then the operator returns “true”.

EXAMPLES:

TEXT IF test > value1 @custom-variable
               value2 20
        then "Your number greater than 20"
        else "Your number is less or equal to 20"

As a result, if the number defined in the custom property “custom-variable” will be greater than 20, then the text “Your number is greater than 20” will appear at the page spot, otherwise the text ” Your number is less or equal to 20” will appear.

Useful Links & Bookmarks

A list of useful links to Yahoo store resources and other web tools :

Yahoo Help pages for store users: http://help.yahoo.com/help/us/store/edit/index.html

Find broken links on web sites: http://home.snafu.de/tilman/xenulink.html

SEO book: http://www.seobook.com/

Search Engine Keyword Tracker & Keyword Ranking Tool: http://www.digitalpoint.com/tools/keywords/

Search Engine Friendly Redirect Checker: http://www.webconfs.com/redirect-check.php

How is your site viewed by SE crawlers? http://www.delorie.com/web/lynxview.html

Google on-line sitemap generator : http://www.xml-sitemaps.com/

If you have any other resources which might be useful in development and maintenance, please  let us know about them!

RTML Operator “AS-NUMBER”

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

AS-NUMBER nil

The purpose of this operator is to take an argument and convert it (if possible) to a numerical type.

EXAMPLES:

AS-NUMBER “$77”

The argument in this example starts with “$”, where “$” is not a numerical character and therefore the AS-NUMBER returns 0

AS-NUMBER “10.44 20 30”

This example returns 10.44 because AS-NUMBER stops at the not numerical blank character.

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 “<=" [less than or equal to]

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.