Protocols/MSNP/Tabs: Difference between revisions

From NINA Wiki
Jump to navigation Jump to search
(Created page with "Convert from markdown: <pre> 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 MsgrCon...")
 
No edit summary
Line 1: Line 1:
Convert from markdown:
{{Protocols/MSNP}}


<pre>
Tabs are embedded websites on the Messenger client, set by the server.
 
 
= 2009 =
By WLM 2009, tabs are retrieved in a completely different manner compared to how it was performed on versions 8.5 and below.
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:
In WLM 2009 MsgrConfig:


```xml
<pre>
<LocalizedConfig Market="fr-FR">
<LocalizedConfig Market="fr-FR">
   ...
   ...
Line 31: Line 34:
   ...
   ...
</LocalizedConfig>
</LocalizedConfig>
```
</pre>


`LocalizedConfig` now carries its own `TabConfig` node, which carries a `slots` node defining all URLs WLM must load to retrieve each individual tab configuration.
<code>LocalizedConfig</code> now carries its own <code>TabConfig</code> node, which carries a <code>slots</code> 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:
Each URL defined is expected to return the following response, which has a similar format to the old MsgrConfig tab nodes:


```xml
<syntaxhighlight lang="xml"><?xml version="1.0" encoding="UTF-8" ?>  
<?xml version="1.0" encoding="UTF-8" ?>  
<ads>
<ads>
     <tabad>
     <tabad>
Line 50: Line 52:
         <notificationid>0</notificationid>  
         <notificationid>0</notificationid>  
     </tabad>
     </tabad>
</ads>
</ads></syntaxhighlight>
```
Important nodes to note are <code>image</code>, <code>name</code>, <code>tooltip</code>, <code>contenturl</code>, and <code>hiturl</code>:
 
* <code>image</code> - Icon the tab will display on Messenger
* <code>name</code> - Name of the tab’s content (presumably for when the content is opened)
* <code>tooltip</code> - Text the tab will display in its tooltip
* <code>contenturl</code> - URL to load content from for the tab
* <code>hiturl</code> - Assumed to aid in tracking how many people access the tab


Important nodes to note are `image`, `name`, `tooltip`, `contenturl`, and `hiturl`:
== 8.5 and prior ==
* `image` - Icon the tab will display on Messenger
 
* `name`- Name of the tab's content (presumably for when the content is opened)
In 8.5 and prior's MsgrConfig, it gets TabConfig from the MsgrConfig itself.
* `tooltip` - Text the tab will display in its tooltip
 
* `contenturl` - URL to load content from for the tab
<pre>
* `hiturl` - Assumed to aid in tracking how many people access the tab
<TabConfig>
    <msntabdata>
        <tab>
            <type>page</type>
            <contenturl>https://escargot.chat/forums/</contenturl>
            <hiturl>https://escargot.chat/forums/</hiturl>
            <image>http://storage.levelleap.com/nina/clients/msnp/tabicon/escargot.png</image>
            <name>Escargot Forums</name>
            <tooltip>Escargot Forums</tooltip>
            <siteid>0</siteid>
            <notificationid>0</notificationid>
        </tab>
        <tab>
            <type>page</type>
            <contenturl>http://m.facebook.com</contenturl>
            <hiturl>http://m.facebook.com</hiturl>
            <image>http://storage.levelleap.com/nina/clients/msnp/tabicon/facebook.png</image>
            <name>Facebook</name>
            <tooltip>Facebook</tooltip>
            <siteid>0</siteid>
            <notificationid>0</notificationid>
        </tab>
        <tab>
            <type>page</type>
            <contenturl>http://m.youtube.com</contenturl>
            <hiturl>http://m.youtube.com</hiturl>
            <image>http://storage.levelleap.com/nina/clients/msnp/tabicon/youtube.png</image>
            <name>YouTube</name>
            <tooltip>YouTube</tooltip>
            <siteid>0</siteid>
            <notificationid>0</notificationid>
        </tab>
        <tab>
            <type>page</type>
            <contenturl>http://msn.com/weather</contenturl>
            <hiturl>http://msn.com/weather</hiturl>
            <image>http://storage.levelleap.com/nina/clients/msnp/tabicon/msn-weather.png</image>
            <name>MSN Weather</name>
            <tooltip>MSN Weather</tooltip>
            <siteid>0</siteid>
            <notificationid>0</notificationid>
        </tab>
    </msntabdata>
    <msntabsettings>
        <oemdisplaylimit>1</oemdisplaylimit>
        <oemtotallimit>1</oemtotallimit>
    </msntabsettings>
</TabConfig>
</pre>
</pre>
[[Category:MSN]]
[[Category:Protocols/MSNP]]
[[Category:Work_In_Progress]]

Revision as of 13:24, 11 May 2022

MSNP Protocol
IntroductionTermsClients
Reference
Error ListCommandsRelying Party SuiteSpotlife
Services
XMPPHTTP GatewayTabsActivities
Documentation
Development ToolsMSNP Grid
PolygamyURLs used by MSN
Documents
Protocol Versions
Version 21
Version 18
Version 16
Version 15
Version 14
Version 13
Version 12
Version 11
Version 9
Version 8
Version 2
MSNC
IntroductionP2PObject DescriptorDisplay PicturesFile Transfer
Scenarios
Microsoft Messenger for Mac
MSNP on WebTV (MSNTV)

Tabs are embedded websites on the Messenger client, set by the server.


2009

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:

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

8.5 and prior

In 8.5 and prior's MsgrConfig, it gets TabConfig from the MsgrConfig itself.

<TabConfig>
    <msntabdata>
        <tab>
            <type>page</type>
            <contenturl>https://escargot.chat/forums/</contenturl>
            <hiturl>https://escargot.chat/forums/</hiturl>
            <image>http://storage.levelleap.com/nina/clients/msnp/tabicon/escargot.png</image>
            <name>Escargot Forums</name>
            <tooltip>Escargot Forums</tooltip>
            <siteid>0</siteid>
            <notificationid>0</notificationid>
        </tab>
        <tab>
            <type>page</type>
            <contenturl>http://m.facebook.com</contenturl>
            <hiturl>http://m.facebook.com</hiturl>
            <image>http://storage.levelleap.com/nina/clients/msnp/tabicon/facebook.png</image>
            <name>Facebook</name>
            <tooltip>Facebook</tooltip>
            <siteid>0</siteid>
            <notificationid>0</notificationid>
        </tab>
        <tab>
            <type>page</type>
            <contenturl>http://m.youtube.com</contenturl>
            <hiturl>http://m.youtube.com</hiturl>
            <image>http://storage.levelleap.com/nina/clients/msnp/tabicon/youtube.png</image>
            <name>YouTube</name>
            <tooltip>YouTube</tooltip>
            <siteid>0</siteid>
            <notificationid>0</notificationid>
        </tab>
        <tab>
            <type>page</type>
            <contenturl>http://msn.com/weather</contenturl>
            <hiturl>http://msn.com/weather</hiturl>
            <image>http://storage.levelleap.com/nina/clients/msnp/tabicon/msn-weather.png</image>
            <name>MSN Weather</name>
            <tooltip>MSN Weather</tooltip>
            <siteid>0</siteid>
            <notificationid>0</notificationid>
        </tab>
    </msntabdata>
    <msntabsettings>
        <oemdisplaylimit>1</oemdisplaylimit>
        <oemtotallimit>1</oemtotallimit>
    </msntabsettings>
</TabConfig>