{"type":"doc","content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Files and directories:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Description.txt ","type":"text"},{"text":"(Mandatory)","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Plugin.cs ","type":"text"},{"text":"(Mandatory)","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"RouteProvider.cs","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DependencyRegistrar.cs","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"web.config ","type":"text"},{"text":"(Mandatory)","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/Content","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/Controllers","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/Localization","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/Models","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/Providers","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/Settings","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/Validators","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"/Views","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Description.txt","type":"text"}]},{"type":"paragraph","content":[{"text":"The file ","type":"text"},{"text":"Description.txt","type":"text","marks":[{"type":"em"}]},{"text":" is the configuration area of a plugin and contains all the metadata SmartStore.NET needs to handle the plugin. In this file, you can configure basic values such as ","type":"text"},{"text":"FriendlyName","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"text":"Author","type":"text","marks":[{"type":"em"}]},{"text":" or the ","type":"text"},{"text":"Version ","type":"text","marks":[{"type":"em"}]},{"text":"of the plugin.","type":"text"}]},{"type":"codeBlock","content":[{"text":" FriendlyName: MyPlugin\nSystemName: MyCompany.MyPlugin\nGroup: Analytics\nVersion: 1.00\nMinAppVersion: 2.1.1\nAuthor: My Company\nDisplayOrder: 1\nFileName: MyCompany.MyPlugin.dll\nResourceRootKey: Plugins.MyCompany.MyPlugin\n","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Configuration values","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FriendlyName","type":"text","marks":[{"type":"strong"}]},{"text":": is the name of the plugin that will be displayed if the plugin hasn't yet been installed, hence the resource for the friendly name can't be displayed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"SystemName","type":"text","marks":[{"type":"strong"}]},{"text":": Unique name to identify the plugin within the system","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Group","type":"text","marks":[{"type":"strong"}]},{"text":": Name of the group in which the plugin should be displayed. Available group names are","type":"text"},{"text":" Admin, Marketing, Payment, Shipping, Tax, Analytics, CMS, Media, SEO, Data, Globalization, Api, Mobile, Social, Security, Developer, Sales, Design,","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"Misc","type":"text","marks":[{"type":"em"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Version","type":"text","marks":[{"type":"strong"}]},{"text":": Version of the plugin","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"MinAppVersion","type":"text","marks":[{"type":"strong"}]},{"text":": Minimum SmartStore.NET version in which the plugin can be executed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Author","type":"text","marks":[{"type":"strong"}]},{"text":": Author name","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DisplayOrder","type":"text","marks":[{"type":"strong"}]},{"text":": Order in which the plugin should be displayed","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"FileName","type":"text","marks":[{"type":"strong"}]},{"text":": Name of the dll. The convention for this name is Companyname.Pluginname (e.g. SmartStore.PayPal). The name you've defined here should also be defined in the project settings of your plugin ","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"Plugin Project","type":"text","marks":[{"type":"em"},{"type":"strong"}]},{"text":" > Properties > Application > Assemblyname","type":"text","marks":[{"type":"strong"}]},{"text":", and it should be the standardnamespace ","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"Plugin Project","type":"text","marks":[{"type":"em"},{"type":"strong"}]},{"text":" > Properties > Application > Standardnamespace","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ResourceRootKey","type":"text","marks":[{"type":"strong"}]},{"text":": Default resource key","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Url","type":"text","marks":[{"type":"strong"}]},{"text":": The URL where the plugin can be obtained. If you're providing the plugin in the ","type":"text"},{"text":"SmartStore Community Marketplace","type":"text","marks":[{"type":"link","attrs":{"href":"http://community.smartstore.com/index.php?/files/"}}]},{"text":", you should place the Marketplace detail view of your plugin here. This way, the users of your plugin can visit it directly form the plugin management area of the backend of SmartStore.NET, and can stay updated or write comments regarding the plugin in the marketplace.","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Build Output Path ","type":"text"}]},{"type":"paragraph","content":[{"text":"Plugins in the SmartStore.NET solution don't reside within the application scope of the web application. The plugin projects are located in ","type":"text"},{"text":"SmartStoreNET\\src\\Plugins","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":".","type":"text","marks":[{"type":"strong"}]},{"text":" Therefore, they have to be built into the following directory:","type":"text"}]},{"type":"paragraph","content":[{"text":"..\\..\\Presentation\\SmartStore.Web\\Plugins\\MyCompany.MyPlugin\\","type":"text"}]},{"type":"paragraph","content":[{"text":"You must specify this directory in ","type":"text"},{"text":" ","type":"text","marks":[{"type":"strong"}]},{"text":"Plugin Project","type":"text","marks":[{"type":"em"},{"type":"strong"}]},{"text":" > Properties > Build > Output > Outputpath","type":"text","marks":[{"type":"strong"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Plugin.cs","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#003366"}}]},{"text":"Your Plugin class in Plugin.cs","type":"text","marks":[{"type":"code"},{"type":"textColor","attrs":{"color":"#003366"}}]},{"text":" should implement ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#003366"}}]},{"text":"BasePlugin","type":"text","marks":[{"type":"code"},{"type":"textColor","attrs":{"color":"#003366"}}]},{"text":" , so it has to implement methods for ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#003366"}}]},{"text":"Install","type":"text","marks":[{"type":"code"},{"type":"textColor","attrs":{"color":"#003366"}}]},{"text":" and ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#003366"}}]},{"text":"Uninstall","type":"text","marks":[{"type":"code"},{"type":"textColor","attrs":{"color":"#003366"}}]},{"text":" where you have to perform all actions that have to be executed when your plugin gets installed or the action that need to be rolled back during uninstall. ","type":"text","marks":[{"type":"textColor","attrs":{"color":"#003366"}}]},{"text":"Typical actions are the initial creation of your plugin settings and the import of language resources.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Plugin settings","type":"text"}]},{"type":"paragraph","content":[{"text":"Your Plugin settings have to be derived from the ","type":"text"},{"text":"ISettings","type":"text","marks":[{"type":"code"}]},{"text":" class so that they can be saved and retrieved from the setting service of SmartStore.NET. Your setting class should contain all the values that the shop admin needs to configure your plugin. You can choose to provide either global settings for all configured stores in a multi-store environment or settings that can be set individually for a store. Therefore, you must implement the store scope configuration view.","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"@Html.Action(\"StoreScopeConfiguration\", \"Setting\", new { area = \"Admin\" })","type":"text"}]},{"type":"paragraph","content":[{"text":"This will render the following control to your configuration view.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":845,"id":"2e10c230-7b28-42b7-9c1a-e337f90a19b9","collection":"contentId-1929379906","type":"file","height":169}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"If you implement a configuration option where users have to enter a simple string, you can simply use ","type":"text"},{"text":"SettingEditorFor","type":"text","marks":[{"type":"em"}]},{"text":" in your configuration view.","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"@Html.SettingEditorFor(model => model.MyStringValue)","type":"text"}]},{"type":"paragraph","content":[{"text":"For other controls, you need to place the ","type":"text"},{"text":"SettingOverrideCheckbox","type":"text","marks":[{"type":"em"}]},{"text":" right before the control you're implementing.","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Multistore Setting for Boolean Value","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"@Html.SettingOverrideCheckbox(model => model.MyBoolValue)\n@Html.CheckBoxFor(model => model.MyBoolValue)","type":"text"}]},{"type":"paragraph","content":[{"text":"or ","type":"text"}]},{"type":"heading","attrs":{"level":5},"content":[{"text":"Multistore Setting for Combobox","type":"text","marks":[{"type":"strong"}]}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"@Html.SettingOverrideCheckbox(model => model.MultipleValues)\n@Html.DropDownListFor(model => model.MultipleValues, Model.AvailableValues)","type":"text"}]},{"type":"paragraph","content":[{"text":"This will render your controls as they appear in the following screen, so that users can define if they want to override the settings for a certain store.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"align-start"},"content":[{"type":"media","attrs":{"width":845,"id":"7b5e8e39-4e31-4539-b479-dccd521e5775","collection":"contentId-1929379906","type":"file","height":169}}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"In the POST-ActionResult of the configuration view that will be launched when a user clicks the ","type":"text"},{"text":"Save","type":"text","marks":[{"type":"strong"}]},{"text":" button, shop-dependent settings should be stored as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"csharp"},"content":[{"text":" [HttpPost, AdminAuthorize, ChildActionOnly]\n public ActionResult Configure(ConfigurationModel model, FormCollection form)\n {\n if (!ModelState.IsValid)\n return Configure();\n\t\t\tModelState.Clear();\n \n\t\t\t// get current setting\n var storeScope = this.GetActiveStoreScopeConfiguration(_storeService, _workContext);\n var myPluginSettings = _settingService.LoadSetting(storeScope);\n\t\t\t\n\t\t\t// update settings with new values of the configuration model\n myPluginSettings.MyStringValue = model.MyStringValue;\n myPluginSettings.MyBoolValue = model.MyBoolValue;\n myPluginSettings.MultipleValues = model.MultipleValues;\n \n\t\t\t// update settings\n var storeDependingSettingHelper = new StoreDependingSettingHelper(ViewData);\n storeDependingSettingHelper.UpdateSettings(myPluginSettings, form, storeScope, _settingService);\n\n _settingService.ClearCache();\n return Configure();\n }","type":"text"}]},{"type":"paragraph","content":[{"text":"Getting the shop-dependent settings in GET-ActionResult of the configuration view would appear as follows:","type":"text"}]},{"type":"codeBlock","attrs":{"language":"csharp"},"content":[{"text":" [AdminAuthorize, ChildActionOnly]\n public ActionResult Configure()\n {\n var storeScope = this.GetActiveStoreScopeConfiguration(_storeService, _workContext);\n var myPluginSettings = _settingService.LoadSetting(storeScope);\n\n var model = new ConfigurationModel();\n var storeDependingSettingHelper = new StoreDependingSettingHelper(ViewData);\n storeDependingSettingHelper.GetOverrideKeys(myPluginSettings, model, storeScope, _settingService);\n\n model.MyStringValue = myPluginSettings.MyStringValue;\n model.MyBoolValue = myPluginSettings.MyBoolValue;\n model.MultipleValues = myPluginSettings.MultipleValues;\n\n // setting up the model to display available values for the combobox\n model.AvailableValues = new List();\n model.AvailableValues.Add(new SelectListItem { Text = \"Option1\", Value = \"1\" });\n model.AvailableValues.Add(new SelectListItem { Text = \"Option2\", Value = \"2\" });\n model.AvailableValues.Add(new SelectListItem { Text = \"Option3\", Value = \"3\" });\n \n return View(model);\n }","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Resources","type":"text"}]},{"type":"paragraph","content":[{"text":"Resources should be stored in the ","type":"text"},{"text":"\\Localization","type":"text","marks":[{"type":"code"}]},{"text":" directory as xml files with the convention ","type":"text"},{"text":"resources.{lang}.xml","type":"text","marks":[{"type":"code"}]},{"text":", where {lang} represents the ISO culture code for the desired language, e.g. ","type":"text"},{"text":"en-US","type":"text","marks":[{"type":"code"}]},{"text":". You can add as many languages as you want.","type":"text"}]},{"type":"paragraph","content":[{"text":"Import the resources during the installation of the plugin with the following code","type":"text"}]},{"type":"codeBlock","attrs":{"language":"csharp"},"content":[{"text":"_localizationService.ImportPluginResourcesFromXml(this.PluginDescriptor);","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"and delete them during uninstall with","type":"text"}]},{"type":"codeBlock","attrs":{"language":"csharp"},"content":[{"text":"_localizationService.DeleteLocaleStringResources(PluginDescriptor.ResourceRootKey);","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"You can add the required resources either as direct child nodes of the ","type":"text"},{"text":"Language ","type":"text","marks":[{"type":"em"}]},{"text":"node or as child nodes of another ","type":"text"},{"text":"LocalResource","type":"text","marks":[{"type":"em"}]},{"text":" node. For a ","type":"text"},{"text":"LocalResource","type":"text","marks":[{"type":"em"}]},{"text":" node, you can specify the attributes ","type":"text"},{"text":"Name","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"AppenRootKey","type":"text","marks":[{"type":"strong"}]},{"text":", which is ","type":"text"},{"text":"true","type":"text","marks":[{"type":"em"}]},{"text":" by default. The ","type":"text"},{"text":"Name","type":"text","marks":[{"type":"strong"}]},{"text":" attribute defines a unique key of the resource with which you can obtain the resource in your views. The ","type":"text"},{"text":"AppendRootKey","type":"text","marks":[{"type":"strong"}]},{"text":" defines whether the ","type":"text"},{"text":"ResourceRootKey","type":"text","marks":[{"type":"strong"}]},{"text":", which you have defined in the ","type":"text"},{"text":"desciption.txt","type":"text","marks":[{"type":"em"}]},{"text":" of your plugin, should be prepended to the ","type":"text"},{"text":"Name","type":"text","marks":[{"type":"strong"}]},{"text":". If your resources are child nodes of another ","type":"text"},{"text":"LocaleResource","type":"text","marks":[{"type":"em"}]},{"text":" node, the name will be appended to the name of the parent resource name.","type":"text"}]},{"type":"paragraph","content":[{"text":"The content of your xml file looks like this. ","type":"text"}]},{"type":"codeBlock","attrs":{"language":"xml"},"content":[{"text":"\n \n \n \n Your settings were successfully saved.\n \n\t\t...","type":"text"}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"The setting above can be obtained with the key ","type":"text"},{"text":"Plugins.Payments.MyPlugin.ConfigSaveNote. ","type":"text","marks":[{"type":"code"}]},{"text":"In a view, you can display the resource with @T(\"","type":"text"},{"text":"Plugins.Payments.MyPlugin.ConfigSaveNote","type":"text"},{"text":"\").","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Providers","type":"text"}]},{"type":"paragraph","content":[{"text":"Providers should be implemented if there is more than one plugin with the same base. Payment methods are a good example of this. Often, you need to implement nearly the same functionality for every payment plugin twice, because there are other parameters required for different methods of the same payment gateway.","type":"text"}]},{"type":"paragraph","content":[{"text":"Your provider should implement one of the following base classes or interfaces depending on the functionality of your plugin.","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"PaymentMethodBase","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"IShippingRateComputationMethod","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"ITaxProvider","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"IExternalAuthenticationMethod","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"DiscountRequirementRuleBase","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"IWidget","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"If your plugin needs to be configured, it has to inherit the setup from ","type":"text"},{"text":"IConfigurable","type":"text","marks":[{"type":"code"}]},{"text":" and implement the method ","type":"text"},{"text":"GetConfigurationRoute","type":"text","marks":[{"type":"code"}]},{"text":", where you specify the configuration route for the plugin.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"heading","attrs":{"level":3},"content":[{"text":"Tip","type":"text"}]},{"type":"paragraph","content":[{"text":"If you don't need providers you can implement the interfaces above also within your plugin.","type":"text"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Content","type":"text"}]},{"type":"paragraph","content":[{"text":"Within the ","type":"text"},{"text":"/Content","type":"text","marks":[{"type":"code"}]},{"text":" directory, you should place any content you need within your plugin (e.g. css-files, javascript-files, images).","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/Content/icon.png","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"icon.png","type":"text","marks":[{"type":"em"}]},{"text":" will be shown within the admin area, where the plugins are being configured by the shop administrator.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"/Views","type":"text"}]},{"type":"paragraph","content":[{"text":"In the Views directory, you place all the views you need for your plugin. (e.g. the configuration view or the view that will be rendered in the public shop)","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Packaging","type":"text"}]},{"type":"paragraph","content":[{"text":"To package a plugin so that it can be installed by SmartStore.NET, open the ","type":"text"},{"text":"SmartStore Packager","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"src\\Tools\\SmartStore.Packager\\bin\\Debug\\SmartStore.Packager.exe","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"The root path is your ","type":"text"},{"text":"SmartStore.Web","type":"text","marks":[{"type":"code"}]},{"text":" project which contains your plugin. After entering this path, you can read the extensions that are included within. Then, you just need to choose your plugin and an output path and click on ","type":"text"},{"text":"Create package","type":"text","marks":[{"type":"code"}]}]}],"version":1}

Browser not supported