Site Tools


Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Next revision
Previous revision
Next revision Both sides next revision
developer:zooplugin [2020/08/14]
127.0.0.1 external edit
developer:zooplugin [2020/11/30]
sandy [Zoo plug-in samples]
Line 1: Line 1:
-====== Creating Plug-ins for Zoo ======+====== Creating Plugins for Zoo ======
 > **Developer:** //[[developer:zoo|Zoo 5]]// > **Developer:** //[[developer:zoo|Zoo 5]]//
-> **Summary:** //Discusses how to create plug-ins for Zoo 5//+> **Summary:** //Discusses how to create plugins for Zoo 5//
  
-Zoo 5 lets third party plug-in developers add licensing support for their products to the Zoo.+Zoo 5 lets third-party plugin developers add licensing support for their products to the Zoo.
  
-When a customer attempts to add a product license to the Zoo, the product's plug-in is called to validate the user's request. Upon validation, the plug-in will return the product's licensing information back to the Zoo. In turn, the Zoo will serialize, maintain, and distribute this license.+When a customer attempts to add a product license to the Zoo, its plugin is called to validate the user's request. Upon validation, the plugin will return the product's licensing information back to the Zoo. In turn, the Zoo will serialize, maintain, and distribute this license.
  
 ===== Requirements ===== ===== Requirements =====
-Zoo plug-ins are .NET Framework 4.0 assemblies. To create a plug-in for Zoo 5, you need one of the following development tools:+Zoo plugins are .NET Framework 4.0 assemblies. To create a plugin for Zoo 5, you need one of the following development tools:
  
   - Microsoft Visual C# 2010.   - Microsoft Visual C# 2010.
   - Microsoft Visual Basic .NET 2010.   - Microsoft Visual Basic .NET 2010.
  
-Also, all plug-ins that use the Zoo license system must be signed with an Authenticode certificate issued by McNeel Plug-in Security. These certificates are freebut must be requested by each developer. Developers must agree to the //Terms of Use// before a certificate is issued. For more information on plug-in signing, see **[[developer:digital-signatures/create-request|Digitally Signing Plug-ins]]**.+All plug-ins that use the Zoo license system must be signed with an Authenticode certificate issued by McNeel Plugin Security. These certificates are free but must be requested by each developer. Developers must agree to the //Terms of Use// before a certificate is issued.
  
-===== Writing a Zoo plug-in ===== +===== Writing a Zoo plugin ===== 
-The general steps required to create a Zoo plug-in are: +The general steps required to create a Zoo plugin are: 
  
   - Make sure you have **[[http://download.rhino3d.com/Zoo/5.0/release/download/|Zoo]]** installed.   - Make sure you have **[[http://download.rhino3d.com/Zoo/5.0/release/download/|Zoo]]** installed.
Line 23: Line 23:
   - Add a reference to **ZooPlugin.dll**, which is found in the Zoo installation folder. Make sure to set the reference's **Copy Local** property to **False**.   - Add a reference to **ZooPlugin.dll**, which is found in the Zoo installation folder. Make sure to set the reference's **Copy Local** property to **False**.
   - Create a new public class that inherits from the **IZooPlugin** interface.   - Create a new public class that inherits from the **IZooPlugin** interface.
-  - Implement the interface members. //(For detailed information about the interface members, see the sample Zoo plug-ins listed below.)// +  - Implement the interface members. //(For detailed information about the interface members, see the sample Zoo plugins listed below.)// 
-  - Build your plug-in+  - Build your plugin
-  - [[developer:digital-signatures/create-request|Digitally sign your plug-in.]]+  - Digitally sign your plugin.
  
-===== Installing a Zoo plug-in ===== +===== Installing a Zoo plugin ===== 
-Once you have built your Zoo plug-in, you can install it and test it:+Once you have built your Zoo plugin, you can install it and test it:
   - Run **ZooAdmin.exe** and make sure the Zoo licensing service has stopped.   - Run **ZooAdmin.exe** and make sure the Zoo licensing service has stopped.
-  - Copy your plug-in assembly (.DLL) and any dependent support libraries to the Zoo'plug-in folder (i.e. C:\Program Files\Zoo 5.0\Plugins).+  - Copy your plugin assembly (.DLL) and any dependent support libraries to the Zoo'plugin folder (i.e. C:\Program Files\Zoo 5.0\Plugins).
   - Restart the Zoo license service.   - Restart the Zoo license service.
   - When the service has restarted, click the **Add License** button. Your product should be one of the available products for which to add a license.   - When the service has restarted, click the **Add License** button. Your product should be one of the available products for which to add a license.
Line 36: Line 36:
 {{:developer:zoopluginaddlicense.png|}} {{:developer:zoopluginaddlicense.png|}}
  
-===== Zoo plug-in samples ===== +===== Zoo plugin samples ===== 
-[[https://github.com/mcneel/Zoo5|Sample Zoo plug-in projects on GitHub]]+[[https://github.com/mcneel/Zoo5|Sample Zoo plugin projects on GitHub]]
  
 \\ \\