Skin Designers Guide

The purpose of this document is to help you understand how Trailers interacts with the MediaPortal's skin engine. In this document you're going to find a general overview of how the plug-in is structured, the components that you, as a skinner should be interested in, and a list of available properties that you can use.

If you want to see whats NEW in a particular version, search for the version throughout this page e.g. To see what has changed in v1.0.1, perform a search on term 1.0.1.

Translations

You can make use any of the plugins string translations to create button menus, headings, labels etc. Syntax for translations are just simple skin properties in the form #Trailers.Translation.$(string).Label e.g.

Property	English
#Trailers.Translation.Trailers.Label	Trailers
#Trailers.Translation.Trailer.Label	Trailer
#Trailers.Translation.Settings.Label	Settings

There is a wide selection of translated strings to choose from, here is a complete list. Use the Field value in the skin property to get the translation you require.

Trailers Button

The Trailers plugin allows the skinner to add a trailers button to various media plugins such as MovingPictures Details View, My Films Details and My Videos VideoInfo. When the user clicks on the button, the trailers plugin will search for trailers from various providers including local and online trailers (depending on user settings).

Control Type	Control ID	Description
Button	11899	Trailers Button
Button	11900	Trailers Button (can be used if need to show two trailer buttons in the same window) (v1.0.5)

Note: You can use the Trailers translations to add a label to the button.

Example

<control>
  <description>Trailers</description>
  <type>button</type>
  <id>11899</id>
  <label>#Trailers.Translation.Trailers.Label...</label>
  <onup>51</onup>
  <ondown>51</ondown>
  <onright>51</onright>
  <onleft>51</onleft>
  <posX>20</posX>
  <posY>642</posY>
  <visible>plugin.isenabled(Trailers)</visible>
</control>

Settings

The settings for Trailers can be configured from MediaPortal Configuration -> Plugins section, alternatively most of the settings can also be configured from with-in the GUI (accept for for advanced features such as adding directories and updating search patterns).

You can either access GUI settings via the MPEI Extensions plugin by selecting 'Trailers' and then clicking on the 'Settings' button, alternatively a skinner can create a button anywhere in their skin which directly links to this window:

Example

<control>
  <description>MPEICONFIGURE:b4293f64_9e83_4f1f_b2e3_8bdea2a37425</description>
  <type>button</type>
  <id>9999</id>
  <label>#Trailers.Translation.Settings.Label</label>
  <ondown>2</ondown>
  <visible>string.equals(#mpei.b4293f64_9e83_4f1f_b2e3_8bdea2a37425.isinstalled, true)</visible>
</control>

Note: The GUID 'b4293f64_9e83_4f1f_b2e3_8bdea2a37425' refers to a unique ID of the plugin.