Protocols/MSNP/Tabs

From NINA Wiki
Jump to navigation Jump to search

Convert from markdown:

By WLM 2009, tabs are retrieved in a completely different manner compared to how it was performed on versions 8.5 and below.

In WLM 2009 MsgrConfig:

```xml
<LocalizedConfig Market="fr-FR">
   ...
   <TabConfig>
      <slots>
         <URL id="1">
            http://rad.msn.com/ADSAdClient31.dll?GetAd=&PG=IMFFTA
         </URL>
         <URL id="2">
            http://rad.msn.com/ADSAdClient31.dll?GetAd=&PG=IMFFTB
         </URL>
         <URL id="3">
            http://rad.msn.com/ADSAdClient31.dll?GetAd=&PG=IMFFTC
         </URL>
         <URL id="4">
            http://rad.msn.com/ADSAdClient31.dll?GetAd=&PG=IMFFTD
         </URL>
         <URL id="5">
            http://rad.msn.com/ADSAdClient31.dll?GetAd=&PG=IMFFTE
         </URL>
         ...
      </slots>
   </TabConfig>
   ...
</LocalizedConfig>
```

`LocalizedConfig` now carries its own `TabConfig` node, which carries a `slots` node defining all URLs WLM must load to retrieve each individual tab configuration.

Each URL defined is expected to return the following response, which has a similar format to the old MsgrConfig tab nodes:

```xml
<?xml version="1.0" encoding="UTF-8" ?> 
<ads>
    <tabad>
        <image>http://example.com/path/to/image.png</image>
        <name>name</name>
        <type>type</type>
        <tooltip>tooltip</tooltip> 
        <contenturl>http://example.com/path/to/content</contenturl> 
        <hiturl>http://example.com/hiturl</hiturl> 
        <siteid>0</siteid> 
        <notificationid>0</notificationid> 
    </tabad>
</ads>
```

Important nodes to note are `image`, `name`, `tooltip`, `contenturl`, and `hiturl`:  
* `image` - Icon the tab will display on Messenger
* `name`- Name of the tab's content (presumably for when the content is opened)
* `tooltip` - Text the tab will display in its tooltip
* `contenturl` - URL to load content from for the tab
* `hiturl` - Assumed to aid in tracking how many people access the tab