Reply to thread

Message

<blockquote data-quote="celesta" data-source="post: 780238" data-attributes="member: 110975">Sorry I don't speak good english and I see how MP2 plugin work from few hours. So I think all I say isn't true but It can help some beginners.First of all:------------------------------------------------------------------------------------------ install vb.net 2010 Express- go to this website and click &quot;Download&quot; <a href="https://github.com/MediaPortal/MediaPortal-2" target="_blank">https://github.com/MediaPortal/MediaPortal-2</a>- Extract to a folder and launch .\Build\MSBUILD_Build_Report_Release_Client.bat- Your portable installation of MP2 is on .\Bin\MP2-Client\bin\x86\Release- To work, you must install &quot;dokan library&quot; <a href="http://dokan-dev.net/en/download/#dokan" target="_blank">Dokan » Download</a>&nbsp; &nbsp; (I can't install dokan because of antivirus problem, so I just copy the file dokan.dll in .\Bin\MP2-Client\bin\x86\Release to launch MP2-Client.exe ; not sure that all work but it launch)File structure of a basic plugin:------------------------------------------------------------------------------------------ All plugin are in .\Bin\MP2-Client\bin\x86\Release\Plugins folder, so create a folder named &quot;plugintest&quot;- plugintest must have these structure:plugintest\plugintest.dll &lt;-- this is the dll of the vb.net class you createplugintest\plugin.xml &lt;-- this is a plugin description file with reference to other files and the classplugintest\Language\strings_en.xml &lt;-- this is a language file, you can use in other files and in the class references to the language file to do multilingual plugin (not used in this how to)plugintest\Skin\default\screens\plugintest.xaml &lt;-- the graphic interface of the plugin writing in mpf (look like wpf application)plugintest\Skin\default\workflow\plugintest-actions.xml &lt;-- create link from a screen to another one (used here to say when i'm at home menu, display my plugin button and when user this on this do the state mentionned in the plugintest-states.xmlplugintest\Skin\default\workflow\plugintest-states.xml &lt;-- associate id with a graphic interfaceThe file plugintest\plugin.xml-----------------------------------------------------------------------------------------&lt;Plugin&nbsp; &nbsp; Name=&quot;My Plugin test&quot;&nbsp; &lt;-- A name for the plugin&nbsp; &nbsp; Author=&quot;My name&quot; &lt;-- A name for the author&nbsp; &nbsp; PluginId=&quot;FFFFFFFF-FFFF-FFFF-FFFF-000000000000&quot; &lt;-- A unique GUID to identify the plugin (use a GUID generator to have one)&nbsp; &nbsp; DescriptorVersion=&quot;1.0&quot;&nbsp; &nbsp; PluginVersion=&quot;0.1&quot;&gt; &lt;-- A version of your plugin&nbsp; &nbsp; &nbsp; &lt;Runtime&gt;&nbsp; &nbsp; &lt;Assembly FileName=&quot;plugintest.dll&quot;/&gt; &lt;-- a reference of the plugin dll&nbsp; &lt;/Runtime&gt;&nbsp; &nbsp; &lt;Register Location=&quot;/Models&quot;&gt;&nbsp; &nbsp; &lt;Model Id=&quot;FFFFFFFF-FFFF-FFFF-FFFF-111111111111&quot; ClassName=&quot;MediaPortal.plugin.plugintest.Plugin&quot;/&gt; &lt;-- A unique GUID to identify the class (use a GUID generator to have one) and the name of the class you create in vb.net with it's namespace&nbsp; &lt;/Register&gt;&nbsp; &nbsp; &lt;Register Location=&quot;/Resources/Skin&quot;&gt;&nbsp; &nbsp; &lt;Resource Id=&quot;test_Skin&quot; Directory=&quot;Skin&quot; Type=&quot;Skin&quot;/&gt; &lt;-- a reference of the Skin folder (id can be what you want)&nbsp; &lt;/Register&gt;&nbsp; &lt;Register Location=&quot;/Resources/Language&quot;&gt;&nbsp; &nbsp; &lt;Resource Id=&quot;test_Language&quot; Directory=&quot;Language&quot; Type=&quot;Language&quot;/&gt;&nbsp;&nbsp; &lt;-- a reference of the Language folder (id can be what you want)&nbsp; &lt;/Register&gt;&lt;/Plugin&gt;The file plugintest\Language\strings_en.xml-----------------------------------------------------------------------------------------Not used yet; this is the helloworld example:&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot; ?&gt;&lt;Language&gt;&nbsp; &lt;Section Name=&quot;Plugintest&quot;&gt;&nbsp; &nbsp; &lt;String Name=&quot;MenuEntry&quot; Text=&quot;Hello world&quot;/&gt;&nbsp; &nbsp; &lt;String Name=&quot;StateDisplayLabel&quot; Text=&quot;Hello world state&quot;/&gt;&nbsp; &nbsp; &lt;String Name=&quot;ButtonText&quot; Text=&quot;Press me&quot;/&gt;&nbsp; &nbsp; &lt;String Name=&quot;HelloWorldText&quot; Text=&quot;Hello World!&quot;/&gt;&nbsp; &nbsp; &lt;String Name=&quot;ButtonTextCommandExecuted&quot; Text=&quot;Congrats, you just triggered a Command!&quot;/&gt;&nbsp; &lt;/Section&gt;&lt;/Language&gt;The file plugintest\Skin\default\screens\plugintest.xaml-----------------------------------------------------------------------------------------Just a xaml graphic interface like this:&lt;Screen xmlns=&quot;www.team-mediaportal.com/2008/mpf/directx&quot; xmlns:x=&quot;http://schemas.microsoft.com/winfx/2006/xaml&quot;&gt;&nbsp; &lt;DockPanel&gt;&nbsp; &nbsp; &nbsp; &lt;Label Content=&quot;This is the sample screen of the HelloWorld plugin&quot; FontSize=&quot;40&quot; DockPanel.Dock=&quot;Top&quot; HorizontalAlignment=&quot;Center&quot;/&gt;&nbsp; &nbsp; &lt;StackPanel DockPanel.Dock=&quot;Center&quot; Orientation=&quot;Horizontal&quot; HorizontalAlignment=&quot;Center&quot; VerticalAlignment=&quot;Center&quot;&gt;&nbsp; &nbsp; &nbsp; &lt;Button Content=&quot;Press me&quot; Style=&quot;{ThemeResource ButtonWideStyle}&quot; Margin=&quot;10&quot;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; HorizontalAlignment=&quot;Right&quot; VerticalAlignment=&quot;Center&quot;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Command=&quot;{Command ChangeHelloWorldString}&quot;/&gt;&nbsp; &nbsp; &nbsp; &lt;Label Content=&quot;{Binding HelloString}&quot; Margin=&quot;10&quot;&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; HorizontalAlignment=&quot;Left&quot; VerticalAlignment=&quot;Center&quot;/&gt;&nbsp; &nbsp; &lt;/StackPanel&gt;&nbsp; &nbsp; &nbsp; &lt;/DockPanel&gt;&lt;/Screen&gt;The file plugintest\Skin\default\workflow\plugintest-actions.xml-----------------------------------------------------------------------------------------&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;&lt;Workflow DescriptorVersion=&quot;1.0&quot;&gt;&nbsp; &lt;MenuActions&gt;&nbsp; &nbsp; &lt;PushNavigationTransition Id=&quot;FFFFFFFF-FFFF-FFFF-FFFF-222222222222&quot; &lt;-- A unique GUID to identify the transition (use a GUID generator to have one)&nbsp; &nbsp; &nbsp; &nbsp; Name=&quot;Home-&gt;plugintest&quot;&nbsp; &lt;-- just a name to identify in the log file&nbsp; &nbsp; &nbsp; &nbsp; DisplayCategory=&quot;z-plugintest&quot; &lt;-- just a name to identify in the log file&nbsp; &nbsp; &nbsp; &nbsp; SortOrder=&quot;a&quot; &lt;-- used for sorting&nbsp; &nbsp; &nbsp; &nbsp; SourceState=&quot;7F702D9C-F2DD-42da-9ED8-0BA92F07787F&quot; &lt;-- This is the unique ID of the home of MP2&nbsp; &nbsp; &nbsp; &nbsp; TargetState=&quot;FFFFFFFF-FFFF-FFFF-FFFF-333333333333&quot; &lt;-- A unique GUID to identifie the state section in the plugintest-states.xml file (use a GUID generator to have one)&nbsp; &nbsp; &nbsp; &nbsp; DisplayTitle=&quot;SMC VIDEO&quot;/&gt; &lt;-- the displayed name in the home menu&nbsp; &lt;/MenuActions&gt;&lt;/Workflow&gt;The file plugintest\Skin\default\workflow\plugintest-states.xml-----------------------------------------------------------------------------------------&lt;?xml version=&quot;1.0&quot; encoding=&quot;utf-8&quot;?&gt;&lt;Workflow DescriptorVersion=&quot;1.0&quot;&gt;&nbsp; &lt;States&gt;&nbsp; &nbsp; &lt;WorkflowState Id=&quot;B150B150-B150-B150-B150-333333333333&quot;&nbsp; &lt;-- The unique GUID used in plugintest-actions.xml to identifie that to do with the action&nbsp; &nbsp; &nbsp; &nbsp; Name=&quot;plugintest&quot; MainScreen=&quot;plugintest&quot; &lt;-- this is the reference of the file plugintest.xaml (without the .xaml)&nbsp; &nbsp; &nbsp; &nbsp; DisplayLabel=&quot;plugintest&quot;/&gt; &lt;-- I don't know maybe the name of the screen ?&nbsp; &lt;/States&gt;&lt;/Workflow&gt;The file plugintest\plugintest.dll-----------------------------------------------------------------------------------------To have this file:- create a new VB.NET Class- Add reference with the files MediaPortal.Core.dll and MediaPortal.UI.dll- In advanced compiler option, choose .NET FRAMEWORK 3.5- Copy this in the code:Imports MediaPortal.Core.GeneralImports MediaPortal.UI.Presentation.ModelsImports MediaPortal.UI.Presentation.WorkflowNamespace MediaPortal.plugin.plugintest&nbsp; &nbsp; Public Class Plugin&nbsp; &nbsp; &nbsp; &nbsp; Implements IWorkflowModel&nbsp; &nbsp; &nbsp; &nbsp; Function CanEnterState(ByVal oldContext As NavigationContext, ByVal newContext As NavigationContext) As Boolean Implements IWorkflowModel.CanEnterState&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Return True&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; End Function&nbsp; &nbsp; &nbsp; &nbsp; Public Sub ChangeModelContext(ByVal oldContext As NavigationContext, ByVal newContext As NavigationContext, ByVal push As Boolean) Implements IWorkflowModel.ChangeModelContext&nbsp; &nbsp; &nbsp; &nbsp; End Sub&nbsp; &nbsp; &nbsp; &nbsp; Public Sub Deactivate(ByVal oldContext As NavigationContext, ByVal newContext As NavigationContext) Implements IWorkflowModel.Deactivate&nbsp; &nbsp; &nbsp; &nbsp; End Sub&nbsp; &nbsp; &nbsp; &nbsp; Public Sub EnterModelContext(ByVal oldContext As NavigationContext, ByVal newContext As NavigationContext) Implements IWorkflowModel.EnterModelContext&nbsp; &nbsp; &nbsp; &nbsp; End Sub&nbsp; &nbsp; &nbsp; &nbsp; Public Sub ExitModelContext(ByVal oldContext As NavigationContext, ByVal newContext As NavigationContext) Implements IWorkflowModel.ExitModelContext&nbsp; &nbsp; &nbsp; &nbsp; End Sub&nbsp; &nbsp; &nbsp; &nbsp; Public ReadOnly Property ModelId As System.Guid Implements IWorkflowModel.ModelId&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Get&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Return New Guid(&quot;B150B150-B150-B150-B150-000000000000&quot;)&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; End Get&nbsp; &nbsp; &nbsp; &nbsp; End Property&nbsp; &nbsp; &nbsp; &nbsp; Public Sub Reactivate(ByVal oldContext As NavigationContext, ByVal newContext As NavigationContext) Implements IWorkflowModel.Reactivate&nbsp; &nbsp; &nbsp; &nbsp; End Sub&nbsp; &nbsp; &nbsp; &nbsp; Public Sub UpdateMenuActions(ByVal context As NavigationContext, ByVal actions As System.Collections.Generic.IDictionary(Of System.Guid, WorkflowAction)) Implements IWorkflowModel.UpdateMenuActions&nbsp; &nbsp; &nbsp; &nbsp; End Sub&nbsp; &nbsp; &nbsp; &nbsp; Public Function UpdateScreen(ByVal context As NavigationContext, ByRef screen As String) As ScreenUpdateMode Implements IWorkflowModel.UpdateScreen&nbsp; &nbsp; &nbsp; &nbsp; &nbsp; &nbsp; Return ScreenUpdateMode.AutoWorkflowManager&nbsp; &nbsp; &nbsp; &nbsp; End Function&nbsp; &nbsp; End ClassEnd Namespace- Compile and you will have the dll</blockquote>

[QUOTE="celesta, post: 780238, member: 110975"] [COLOR="Red"]Sorry I don't speak good english and I see how MP2 plugin work from few hours. So I think all I say isn't true but It can help some beginners.[/COLOR] First of all: ----------------------------------------------------------------------------------------- - install vb.net 2010 Express - go to this website and click "Download" [url]https://github.com/MediaPortal/MediaPortal-2[/url] - Extract to a folder and launch .\Build\MSBUILD_Build_Report_Release_Client.bat - Your portable installation of MP2 is on .\Bin\MP2-Client\bin\x86\Release - To work, you must install "dokan library" [url=http://dokan-dev.net/en/download/#dokan]Dokan » Download[/url] (I can't install dokan because of antivirus problem, so I just copy the file dokan.dll in .\Bin\MP2-Client\bin\x86\Release to launch MP2-Client.exe ; not sure that all work but it launch) File structure of a basic plugin: ----------------------------------------------------------------------------------------- - All plugin are in .\Bin\MP2-Client\bin\x86\Release\Plugins folder, so create a folder named "plugintest" - plugintest must have these structure: plugintest\plugintest.dll [COLOR="SeaGreen"]<-- this is the dll of the vb.net class you create[/COLOR] plugintest\plugin.xml [COLOR="SeaGreen"]<-- this is a plugin description file with reference to other files and the class[/COLOR] plugintest\Language\strings_en.xml [COLOR="SeaGreen"]<-- this is a language file, you can use in other files and in the class references to the language file to do multilingual plugin (not used in this how to)[/COLOR] plugintest\Skin\default\screens\plugintest.xaml [COLOR="SeaGreen"]<-- the graphic interface of the plugin writing in mpf (look like wpf application)[/COLOR] plugintest\Skin\default\workflow\plugintest-actions.xml [COLOR="SeaGreen"]<-- create link from a screen to another one (used here to say when i'm at home menu, display my plugin button and when user this on this do the state mentionned in the plugintest-states.xml[/COLOR] plugintest\Skin\default\workflow\plugintest-states.xml [COLOR="SeaGreen"]<-- associate id with a graphic interface[/COLOR] The file plugintest\plugin.xml ----------------------------------------------------------------------------------------- <Plugin Name="My Plugin test" [COLOR="SeaGreen"]<-- A name for the plugin[/COLOR] Author="My name" [COLOR="SeaGreen"]<-- A name for the author[/COLOR] PluginId="FFFFFFFF-FFFF-FFFF-FFFF-000000000000" [COLOR="SeaGreen"]<-- A unique GUID to identify the plugin (use a GUID generator to have one)[/COLOR] DescriptorVersion="1.0" PluginVersion="0.1"> [COLOR="SeaGreen"]<-- A version of your plugin[/COLOR] <Runtime> <Assembly FileName="plugintest.dll"/>[COLOR="SeaGreen"] <-- a reference of the plugin dll[/COLOR] </Runtime> <Register Location="/Models"> <Model Id="FFFFFFFF-FFFF-FFFF-FFFF-111111111111" ClassName="MediaPortal.plugin.plugintest.Plugin"/>[COLOR="SeaGreen"] <-- A unique GUID to identify the class (use a GUID generator to have one) and the name of the class you create in vb.net with it's namespace[/COLOR] </Register> <Register Location="/Resources/Skin"> <Resource Id="test_Skin" Directory="Skin" Type="Skin"/> [COLOR="SeaGreen"]<-- a reference of the Skin folder (id can be what you want)[/COLOR] </Register> <Register Location="/Resources/Language"> <Resource Id="test_Language" Directory="Language" Type="Language"/> [COLOR="SeaGreen"]<-- a reference of the Language folder (id can be what you want)[/COLOR] </Register> </Plugin> The file plugintest\Language\strings_en.xml ----------------------------------------------------------------------------------------- Not used yet; this is the helloworld example: <?xml version="1.0" encoding="utf-8" ?> <Language> <Section Name="Plugintest"> <String Name="MenuEntry" Text="Hello world"/> <String Name="StateDisplayLabel" Text="Hello world state"/> <String Name="ButtonText" Text="Press me"/> <String Name="HelloWorldText" Text="Hello World!"/> <String Name="ButtonTextCommandExecuted" Text="Congrats, you just triggered a Command!"/> </Section> </Language> The file plugintest\Skin\default\screens\plugintest.xaml ----------------------------------------------------------------------------------------- Just a xaml graphic interface like this: <Screen xmlns="www.team-mediaportal.com/2008/mpf/directx" xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"> <DockPanel> <Label Content="This is the sample screen of the HelloWorld plugin" FontSize="40" DockPanel.Dock="Top" HorizontalAlignment="Center"/> <StackPanel DockPanel.Dock="Center" Orientation="Horizontal" HorizontalAlignment="Center" VerticalAlignment="Center"> <Button Content="Press me" Style="{ThemeResource ButtonWideStyle}" Margin="10" HorizontalAlignment="Right" VerticalAlignment="Center" Command="{Command ChangeHelloWorldString}"/> <Label Content="{Binding HelloString}" Margin="10" HorizontalAlignment="Left" VerticalAlignment="Center"/> </StackPanel> </DockPanel> </Screen> The file plugintest\Skin\default\workflow\plugintest-actions.xml ----------------------------------------------------------------------------------------- <?xml version="1.0" encoding="utf-8"?> <Workflow DescriptorVersion="1.0"> <MenuActions> <PushNavigationTransition Id="FFFFFFFF-FFFF-FFFF-FFFF-222222222222" [COLOR="SeaGreen"]<-- A unique GUID to identify the transition (use a GUID generator to have one)[/COLOR] Name="Home->plugintest" [COLOR="SeaGreen"]<-- just a name to identify in the log file[/COLOR] DisplayCategory="z-plugintest" [COLOR="SeaGreen"]<-- just a name to identify in the log file[/COLOR] SortOrder="a" [COLOR="SeaGreen"]<-- used for sorting[/COLOR] SourceState="7F702D9C-F2DD-42da-9ED8-0BA92F07787F" [COLOR="SeaGreen"]<-- This is the unique ID of the home of MP2[/COLOR] TargetState="FFFFFFFF-FFFF-FFFF-FFFF-333333333333" [COLOR="SeaGreen"]<-- A unique GUID to identifie the state section in the plugintest-states.xml file (use a GUID generator to have one)[/COLOR] DisplayTitle="SMC VIDEO"/> [COLOR="SeaGreen"]<-- the displayed name in the home menu[/COLOR] </MenuActions> </Workflow> The file plugintest\Skin\default\workflow\plugintest-states.xml ----------------------------------------------------------------------------------------- <?xml version="1.0" encoding="utf-8"?> <Workflow DescriptorVersion="1.0"> <States> <WorkflowState Id="B150B150-B150-B150-B150-333333333333" [COLOR="SeaGreen"]<-- The unique GUID used in plugintest-actions.xml to identifie that to do with the action[/COLOR] Name="plugintest" MainScreen="plugintest" [COLOR="SeaGreen"]<-- this is the reference of the file plugintest.xaml (without the .xaml)[/COLOR] DisplayLabel="plugintest"/> [COLOR="SeaGreen"]<-- I don't know maybe the name of the screen ?[/COLOR] </States> </Workflow> The file plugintest\plugintest.dll ----------------------------------------------------------------------------------------- To have this file: - create a new VB.NET Class - Add reference with the files MediaPortal.Core.dll and MediaPortal.UI.dll - In advanced compiler option, choose .NET FRAMEWORK 3.5 - Copy this in the code: Imports MediaPortal.Core.General Imports MediaPortal.UI.Presentation.Models Imports MediaPortal.UI.Presentation.Workflow Namespace MediaPortal.plugin.plugintest Public Class Plugin Implements IWorkflowModel Function CanEnterState(ByVal oldContext As NavigationContext, ByVal newContext As NavigationContext) As Boolean Implements IWorkflowModel.CanEnterState Return True End Function Public Sub ChangeModelContext(ByVal oldContext As NavigationContext, ByVal newContext As NavigationContext, ByVal push As Boolean) Implements IWorkflowModel.ChangeModelContext End Sub Public Sub Deactivate(ByVal oldContext As NavigationContext, ByVal newContext As NavigationContext) Implements IWorkflowModel.Deactivate End Sub Public Sub EnterModelContext(ByVal oldContext As NavigationContext, ByVal newContext As NavigationContext) Implements IWorkflowModel.EnterModelContext End Sub Public Sub ExitModelContext(ByVal oldContext As NavigationContext, ByVal newContext As NavigationContext) Implements IWorkflowModel.ExitModelContext End Sub Public ReadOnly Property ModelId As System.Guid Implements IWorkflowModel.ModelId Get Return New Guid("B150B150-B150-B150-B150-000000000000") End Get End Property Public Sub Reactivate(ByVal oldContext As NavigationContext, ByVal newContext As NavigationContext) Implements IWorkflowModel.Reactivate End Sub Public Sub UpdateMenuActions(ByVal context As NavigationContext, ByVal actions As System.Collections.Generic.IDictionary(Of System.Guid, WorkflowAction)) Implements IWorkflowModel.UpdateMenuActions End Sub Public Function UpdateScreen(ByVal context As NavigationContext, ByRef screen As String) As ScreenUpdateMode Implements IWorkflowModel.UpdateScreen Return ScreenUpdateMode.AutoWorkflowManager End Function End Class End Namespace - Compile and you will have the dll [/QUOTE]

Verification