Jak napsat daňový plugin pro nopCommerce
Funkčnost nopCommerce se rozšiřuje pomocí pluginů. Existují různé typy pluginů, například „PickupInStore“ a „PayPal Standard“, které jsou již součástí distribuce nopCommerce. Na oficiálním webu nopCommerce můžete také vyhledávat různé pluginy a zjistit, zda už někdo nevytvořil plugin, který vyhovuje vašim potřebám. Pokud jste žádný nenašli, jste na správném místě, protože tento článek vás provede procesem vytvoření pluginu, konkrétně daňového pluginu, podle vašich potřeb.
Struktura pluginu, potřebné soubory a jejich umístění
Začněte vytvořením nového projektu typu „Class Library“ v řešení (solution). Doporučuje se umístit plugin do adresáře Plugins v kořenové složce zdrojového kódu, kde se již nacházejí ostatní pluginy a widgety.

Poznámka
Nezaměňujte tento adresář s adresářem, který existuje v adresáři
Presentation\Nop.Web. Adresář Plugins v adresáři Nop.Web obsahuje zkompilované soubory pluginů.Doporučený název projektu pluginu je
Nop.Plugin.{Group}.{Name}.{Group}je skupina vašeho pluginu (napříkladPaymentneboShipping).{Name}je název vašeho pluginu (napříkladFixedOrByCountryStateZip). Například daňový pluginFixedOrByCountryStateZipmá následující název:Nop.Plugin.Tax.FixedOrByCountryStateZip. Upozorňujeme však, že to není povinné. Pro plugin můžete zvolit libovolný název. NapříkladMyFirstTaxPlugin. Struktura adresáře Plugins v řešení vypadá následovně.
Po vytvoření projektu pluginu je třeba aktualizovat obsah souboru .csproj v libovolném dostupném textovém editoru. Nahraďte obsah následujícím:
<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <TargetFramework>netcoreapp2.2</TargetFramework> <Copyright>SOME_COPYRIGHT</Copyright> <Company>YOUR_COMPANY</Company> <Authors>SOME_AUTHORS</Authors> <PackageLicenseUrl>PACKAGE_LICENSE_URL</PackageLicenseUrl> <PackageProjectUrl>PACKAGE_PROJECT_URL</PackageProjectUrl> <RepositoryUrl>REPOSITORY_URL</RepositoryUrl> <RepositoryType>Git</RepositoryType> <OutputPath>..\..\Presentation\Nop.Web\Plugins\PLUGIN_OUTPUT_DIRECTORY</OutputPath> <OutDir>$(OutputPath)</OutDir> <!--Set this parameter to true to get the dlls copied from the NuGet cache to the output of your project. You need to set this parameter to true if your plugin has a nuget package to ensure that the dlls copied from the NuGet cache to the output of your project--> <CopyLocalLockFileAssemblies>true</CopyLocalLockFileAssemblies> </PropertyGroup> <ItemGroup> <ProjectReference Include="..\..\Presentation\Nop.Web.Framework\Nop.Web.Framework.csproj" /> <ClearPluginAssemblies Include="$(MSBuildProjectDirectory)\..\..\Build\ClearPluginAssemblies.sproj" /> </ItemGroup> <!-- This target execute after "Build" target --> <Target Name="NopTarget" AfterTargets="Build"> <!-- Delete unnecessary libraries from plugins path --> <MSBuild Projects="@(ClearPluginAssemblies)" Properties="PluginPath=$(MSBuildProjectDirectory)\ $ (OutDir)" Targets="NopClear" /> </Target> </Project>Poznámka
PLUGIN_OUTPUT_DIRECTORY je třeba nahradit názvem pluginu, například
Tax.FixedOrByCountryStateZip.Po aktualizaci souboru .csproj je třeba přidat soubor
plugin.json, který je pro plugin vyžadován. Tento soubor obsahuje metainformace popisující váš plugin. Stačí tento soubor zkopírovat z jakéhokoli jiného existujícího pluginu/widgetu a upravit jej podle svých potřeb. Informace o souboruplugin.jsonnajdete v části Soubor plugin.json.Posledním povinným krokem je vytvoření třídy, která implementuje
BasePlugin(jmenný prostorNop.Core.Plugins) a rozhraníITaxProvider(jmenný prostorNop.Services.Tax). ITaxProvider implementuje metoduGetTaxRate, která vrací typ CalculateTaxResult (obsahuje daňovou sazbu, případné chyby a stav úspěchu typuBoolean) na základě vlastní logiky, obvykle podle adresy zákazníka.
Zpracování požadavků. Controllery, modely a view
Nyní můžete plugin zobrazit v Administrace (Admin area) → Konfigurace (Configuration) → Lokální pluginy (Local Plugins).

Když je plugin/widget nainstalován, uvidíte tlačítko Odinstalovat (Uninstall). Pro zlepšení výkonu je dobrým zvykem odinstalovat pluginy/widgety, které nejsou potřeba.

Když plugin/widget není nainstalován nebo byl odinstalován, zobrazí se tlačítka Instalovat (Install) a Smazat (Delete).
Poznámka
Smazáním se ze serveru odstraní fyzické soubory.
Jak jste ale jistě uhodli, náš plugin nic nedělá. Nemá ani uživatelské rozhraní pro svou konfiguraci. Vytvořme tedy stránku pro konfiguraci pluginu.
Nyní potřebujeme vytvořit controller, model, view a view komponentu.
- MVC controllery odpovídají za reakci na požadavky odeslané na web
ASP.NET MVC. Každý požadavek prohlížeče je namapován na konkrétní controller. - View obsahuje HTML značky a obsah, který se odesílá do prohlížeče. Při práci s aplikací
ASP.NET MVCje view ekvivalentem stránky. - View komponenta, která implementuje NopViewComponent a obsahuje logiku a kód pro vykreslení view.
- MVC model obsahuje veškerou logiku vaší aplikace, která není obsažena ve view ani v controlleru.
Pojďme tedy na to:
- Vytvořte model. Přidejte do nového pluginu složku
Modelsa poté přidejte novou třídu modelu, která vyhovuje vašim potřebám. - Vytvořte view. Přidejte do nového pluginu složku
Viewsa poté přidejte soubor.cshtmls názvemConfigure.cshtml. Nastavte vlastnost Build Action souboru view na Content a vlastnost Copy to Output Directory na Copy always. Upozorňujeme, že konfigurační stránka by měla používat layout _ConfigurePlugin.
@model Nop.Plugin.Tax.FixedOrByCountryStateZip.Models.ConfigurationModel
@{
Layout = "_ConfigurePlugin";
}
<div class="form-group">
<div class="col-md-12">
<div class="onoffswitch">
<input type="checkbox" name="onoffswitch" class="onoffswitch-checkbox" id="advanced-settings-mode" checked="@Model.CountryStateZipEnabled">
<label class="onoffswitch-label" for="advanced-settings-mode">
<span class="onoffswitch-inner"
data-locale-basic="@T("Plugins.Tax.FixedOrByCountryStateZip.Fixed")"
data-locale-advanced="@T("Plugins.Tax.FixedOrByCountryStateZip.TaxByCountryStateZip")"></span>
<span class="onoffswitch-switch"></span>
</label>
</div>
</div>
</div>
<script>
function checkAdvancedSettingsMode(advanced) {
if (advanced) {
$("body").addClass("advanced-settings-mode");
$("body").removeClass("basic-settings-mode");
} else {
$("body").removeClass("advanced-settings-mode");
$("body").addClass("basic-settings-mode");
}
}
checkAdvancedSettingsMode($("#advanced-settings-mode").is(':checked'));
$(document).ready(function() {
$("#advanced-settings-mode").click(function() {
checkAdvancedSettingsMode($(this).is(':checked'));
$.ajax({
cache: false,
url: "@Url.Action("SaveMode", "FixedOrByCountryStateZip")",
type: "POST",
data: {
value: $(this).is(':checked')
},
dataType: "json",
error: function (jqXHR, textStatus, errorThrown) {
$("#saveModeAlert").click();
}
});
ensureDataTablesRendered();
});
});
</script>
<nop-alert asp-alert-id="saveModeAlert" asp-alert-message="@T("Admin.Common.Alert.Save.Error")" />
@await Html.PartialAsync("~/Plugins/Tax.FixedOrByCountryStateZip/Views/_FixedRate.cshtml")
@await Html.PartialAsync("~/Plugins/Tax.FixedOrByCountryStateZip/Views/_CountryStateZip.cshtml", Model)
- Ujistěte se také, že máte v adresáři
Viewssoubor _ViewImports.cshtml. Stačí jej zkopírovat z jakéhokoli jiného existujícího pluginu nebo widgetu.

- Vytvořte controller. Přidejte do nového pluginu složku
Controllersa poté přidejte novou třídu controlleru. Osvědčeným postupem je pojmenovávat controllery pluginů Controller.cs. NapříkladFixedOrByCountryStateZipController. Pojmenovávat controllery tímto způsobem samozřejmě není povinné (jde pouze o doporučení). Poté vytvořte příslušnou akční metodu pro konfigurační stránku (v administraci). Pojmenujme jiConfigure. Připravte třídu modelu a předejte ji následujícímu view pomocí fyzické cesty k view: ~/Plugins//Views/Configure.cshtml.
public IActionResult Configure()
{
if (!_permissionService.Authorize(StandardPermissionProvider.ManageTaxSettings))
return AccessDeniedView();
var taxCategories = _taxCategoryService.GetAllTaxCategories();
if (!taxCategories.Any())
return Content("No tax categories can be loaded");
var model = new ConfigurationModel { CountryStateZipEnabled = _countryStateZipSettings.CountryStateZipEnabled };
//stores
model.AvailableStores.Add(new SelectListItem { Text = "*", Value = "0" });
var stores = _storeService.GetAllStores();
foreach (var s in stores)
model.AvailableStores.Add(new SelectListItem { Text = s.Name, Value = s.Id.ToString() });
//tax categories
foreach (var tc in taxCategories)
model.AvailableTaxCategories.Add(new SelectListItem { Text = tc.Name, Value = tc.Id.ToString() });
//countries
var countries = _countryService.GetAllCountries(showHidden: true);
foreach (var c in countries)
model.AvailableCountries.Add(new SelectListItem { Text = c.Name, Value = c.Id.ToString() });
//states
model.AvailableStates.Add(new SelectListItem { Text = "*", Value = "0" });
var defaultCountry = countries.FirstOrDefault();
if (defaultCountry != null)
{
var states = _stateProvinceService.GetStateProvincesByCountryId(defaultCountry.Id);
foreach (var s in states)
model.AvailableStates.Add(new SelectListItem { Text = s.Name, Value = s.Id.ToString() });
}
return View("~/Plugins/Tax.FixedOrByCountryStateZip/Views/Configure.cshtml", model);
}
- Pro svou akční metodu použijte následující atributy:
[AuthorizeAdmin] //confirms access to the admin panel
[Area(AreaNames.Admin)] //specifies the area containing a controller or action
[AdminAntiForgery] //Helps prevent malicious scripts from submitting forged page requests.
Otevřete například plugin FixedOrByCountryStateZip a podívejte se na jeho implementaci FixedOrByCountryStateZipController.
Poté byste pro každý plugin, který má konfigurační stránku, měli určit konfigurační URL. Základní třída BasePlugin má metodu GetConfigurationPageUrl, která vrací konfigurační URL:
public override string GetConfigurationPageUrl()
{
return $"{_webHelper.GetStoreLocation()}Admin/{CONTROLLER_NAME}/{ACTION_NAME}";
}
Kde je název vašeho controlleru a je název akce (obvykle Configure).
Pro přiřazení různých daňových sazeb podle adresy zákazníka je potřeba nová tabulka, která uchovává všechna data související s daní. Za tímto účelem se přidá složka Domain, do které přidáme třídu rozšiřující třídu BaseEntity. V tomto případě TaxRate.cs

Přidá se také další složka Data, která obsahuje mapovací třídu (třídy) a třídu (třídy) Object Context. Mapovací třída implementuje NopEntityTypeConfiguration<T> (jmenný prostor Nop.Data.Mapping). Zde je přepsána metoda configure.
public override void Configure(EntityTypeBuilder<TaxRate> builder)
{
builder.ToTable(nameof(TaxRate));
builder.HasKey(rate => rate.Id);
builder.Property(rate => rate.Percentage).HasColumnType("decimal(18, 4)");
}
Třída Object Context implementuje třídu DbContext (jmenný prostor Microsoft.EntityFrameworkCore) a rozhraní IDbContext (jmenný prostor Nop.Data). Toto rozhraní IDbContext obsahuje metody související s vytvářením a mazáním tabulek a dalšími vlastními akcemi, jako je provedení nezpracovaného SQL dotazu podle modelu, který byl dříve přidán do složky Domain.
public class CountryStateZipObjectContext : DbContext, IDbContext
{
#region Ctor
public CountryStateZipObjectContext(DbContextOptions<CountryStateZipObjectContext> options) : base(options)
{
}
#endregion
#region Utilities
/// <summary>
/// Further configuration the model
/// </summary>
/// <param name="modelBuilder">Model muilder</param>
protected override void OnModelCreating(ModelBuilder modelBuilder)
{
modelBuilder.ApplyConfiguration(new TaxRateMap());
base.OnModelCreating(modelBuilder);
}
#endregion
#region Methods
/// <summary>
/// Creates a DbSet that can be used to query and save instances of entity
/// </summary>
/// <typeparam name="TEntity">Entity type</typeparam>
/// <returns>A set for the given entity type</returns>
public new virtual DbSet<TEntity> Set<TEntity>() where TEntity : BaseEntity
{
return base.Set<TEntity>();
}
/// <summary>
/// Generate a script to create all tables for the current model
/// </summary>
/// <returns>A SQL script</returns>
public virtual string GenerateCreateScript()
{
return Database.GenerateCreateScript();
}
/// <summary>
/// Creates a LINQ query for the query type based on a raw SQL query
/// </summary>
/// <typeparam name="TQuery">Query type</typeparam>
/// <param name="sql">The raw SQL query</param>
/// <param name="parameters">The values to be assigned to parameters</param>
/// <returns>An IQueryable representing the raw SQL query</returns>
public virtual IQueryable<TQuery> QueryFromSql<TQuery>(string sql, params object[] parameters) where TQuery : class
{
throw new NotImplementedException();
}
/// <summary>
/// Creates a LINQ query for the entity based on a raw SQL query
/// </summary>
/// <typeparam name="TEntity">Entity type</typeparam>
/// <param name="sql">The raw SQL query</param>
/// <param name="parameters">The values to be assigned to parameters</param>
/// <returns>An IQueryable representing the raw SQL query</returns>
public virtual IQueryable<TEntity> EntityFromSql<TEntity>(string sql, params object[] parameters) where TEntity : BaseEntity
{
throw new NotImplementedException();
}
/// <summary>
/// Executes the given SQL against the database
/// </summary>
/// <param name="sql">The SQL to execute</param>
/// <param name="doNotEnsureTransaction">true - the transaction creation is not ensured; false - the transaction creation is ensured.</param>
/// <param name="timeout">The timeout to use for command. Note that the command timeout is distinct from the connection timeout, which is commonly set on the database connection string</param>
/// <param name="parameters">Parameters to use with the SQL</param>
/// <returns>The number of rows affected</returns>
public virtual int ExecuteSqlCommand(RawSqlString sql, bool doNotEnsureTransaction = false, int? timeout = null, params object[] parameters)
{
using (var transaction = Database.BeginTransaction())
{
var result = Database.ExecuteSqlCommand(sql, parameters);
transaction.Commit();
return result;
}
}
/// <summary>
/// Detach an entity from the context
/// </summary>
/// <typeparam name="TEntity">Entity type</typeparam>
/// <param name="entity">Entity</param>
public virtual void Detach<TEntity>(TEntity entity) where TEntity : BaseEntity
{
throw new NotImplementedException();
}
/// <summary>
/// Install object context
/// </summary>
public void Install()
{
//create tables
this.ExecuteSqlScript(GenerateCreateScript());
}
/// <summary>
/// Uninstall object context
/// </summary>
public void Uninstall()
{
//drop the table
this.DropPluginTable(nameof(TaxRate));
}
#endregion
}
Pro operace CRUD s daňovými sazbami se vytvářejí služby. V tomto případě se vytvoří rozhraní ICountryStateZipService a třída CountryStateZipService. Obsahují metody jako InsertTaxRate, UpdateTaxRate, DeleteTaxRate, GetAllTaxRates a GetTaxRateById. Názvy těchto metod jsou samovysvětlující a budou je využívat controllery. Další metody lze zavést/přidat podle požadavků.
ICountryStateZipService.cs
public partial interface ICountryStateZipService
{
/// <summary>
/// Deletes a tax rate
/// </summary>
/// <param name="taxRate">Tax rate</param>
void DeleteTaxRate(TaxRate taxRate);
/// <summary>
/// Gets all tax rates
/// </summary>
/// <returns>Tax rates</returns>
IPagedList<TaxRate> GetAllTaxRates(int pageIndex = 0, int pageSize = int.MaxValue);
/// <summary>
/// Gets a tax rate
/// </summary>
/// <param name="taxRateId">Tax rate identifier</param>
/// <returns>Tax rate</returns>
TaxRate GetTaxRateById(int taxRateId);
/// <summary>
/// Inserts a tax rate
/// </summary>
/// <param name="taxRate">Tax rate</param>
void InsertTaxRate(TaxRate taxRate);
/// <summary>
/// Updates the tax rate
/// </summary>
/// <param name="taxRate">Tax rate</param>
void UpdateTaxRate(TaxRate taxRate);
}
CountryStateZipService.cs
public partial class CountryStateZipService : ICountryStateZipService
{
#region Fields
private readonly IEventPublisher _eventPublisher;
private readonly IRepository<TaxRate> _taxRateRepository;
private readonly ICacheManager _cacheManager;
#endregion
#region Ctor
/// <summary>
/// Ctor
/// </summary>
/// <param name="eventPublisher">Event publisher</param>
/// <param name="cacheManager">Cache manager</param>
/// <param name="taxRateRepository">Tax rate repository</param>
public CountryStateZipService(IEventPublisher eventPublisher,
ICacheManager cacheManager,
IRepository<TaxRate> taxRateRepository)
{
_eventPublisher = eventPublisher;
_cacheManager = cacheManager;
_taxRateRepository = taxRateRepository;
}
#endregion
#region Methods
/// <summary>
/// Deletes a tax rate
/// </summary>
/// <param name="taxRate">Tax rate</param>
public virtual void DeleteTaxRate(TaxRate taxRate)
{
if (taxRate == null)
throw new ArgumentNullException(nameof(taxRate));
_taxRateRepository.Delete(taxRate);
//event notification
_eventPublisher.EntityDeleted(taxRate);
}
/// <summary>
/// Gets all tax rates
/// </summary>
/// <returns>Tax rates</returns>
public virtual IPagedList<TaxRate> GetAllTaxRates(int pageIndex = 0, int pageSize = int.MaxValue)
{
var key = string.Format(ModelCacheEventConsumer.TAXRATE_ALL_KEY, pageIndex, pageSize);
return _cacheManager.Get(key, () =>
{
var query = from tr in _taxRateRepository.Table
orderby tr.StoreId, tr.CountryId, tr.StateProvinceId, tr.Zip, tr.TaxCategoryId
select tr;
var records = new PagedList<TaxRate>(query, pageIndex, pageSize);
return records;
});
}
/// <summary>
/// Gets a tax rate
/// </summary>
/// <param name="taxRateId">Tax rate identifier</param>
/// <returns>Tax rate</returns>
public virtual TaxRate GetTaxRateById(int taxRateId)
{
if (taxRateId == 0)
return null;
return _taxRateRepository.GetById(taxRateId);
}
/// <summary>
/// Inserts a tax rate
/// </summary>
/// <param name="taxRate">Tax rate</param>
public virtual void InsertTaxRate(TaxRate taxRate)
{
if (taxRate == null)
throw new ArgumentNullException(nameof(taxRate));
_taxRateRepository.Insert(taxRate);
//event notification
_eventPublisher.EntityInserted(taxRate);
}
/// <summary>
/// Updates the tax rate
/// </summary>
/// <param name="taxRate">Tax rate</param>
public virtual void UpdateTaxRate(TaxRate taxRate)
{
if (taxRate == null)
throw new ArgumentNullException(nameof(taxRate));
_taxRateRepository.Update(taxRate);
//event notification
_eventPublisher.EntityUpdated(taxRate);
}
#endregion
}
Poslední věcí, kterou potřebujeme, je registrace služeb a konfigurace DB kontextu pluginu při spuštění aplikace. Za tímto účelem se přidá složka Infrastructure, která obsahuje třídy DependencyRegister a PluginDbStartup.
Třída DependencyRegister implementuje rozhraní IDependencyRegister (jmenný prostor Nop.Core.Infrastructure.DependencyManagement), které má metodu Register.
public class DependencyRegistrar : IDependencyRegistrar
{
/// <summary>
/// Register services and interfaces
/// </summary>
/// <param name="builder">Container builder</param>
/// <param name="typeFinder">Type finder</param>
/// <param name="config">Config</param>
public virtual void Register(ContainerBuilder builder, ITypeFinder typeFinder, NopConfig config)
{
builder.RegisterType<FixedOrByCountryStateZipTaxProvider>().As<ITaxProvider>().InstancePerLifetimeScope();
builder.RegisterType<CountryStateZipService>().As<ICountryStateZipService>().InstancePerLifetimeScope();
//data context
builder.RegisterPluginDataContext<CountryStateZipObjectContext>("nop_object_context_tax_country_state_zip");
//override required repository with our custom context
builder.RegisterType<EfRepository<TaxRate>>().As<IRepository<TaxRate>>()
.WithParameter(ResolvedParameter.ForNamed<IDbContext>("nop_object_context_tax_country_state_zip"))
.InstancePerLifetimeScope();
}
/// <summary>
/// Order of this dependency registrar implementation
/// </summary>
public int Order => 1;
}
Podobně třída PluginDbStartup implementuje rozhraní INopStartup (jmenný prostor Nop.Core.Infrastructure), které má metody ConfigureServices a Configure. V tomto příkladu se object context přidává v metodě ConfigureServices.
public class PluginDbStartup : INopStartup
{
/// <summary>
/// Add and configure any of the middleware
/// </summary>
/// <param name="services">Collection of service descriptors</param>
/// <param name="configuration">Configuration of the application</param>
public void ConfigureServices(IServiceCollection services, IConfiguration configuration)
{
//add object context
services.AddDbContext<CountryStateZipObjectContext>(optionsBuilder =>
{
optionsBuilder.UseSqlServerWithLazyLoading(services);
});
}
/// <summary>
/// Configure the using of added middleware
/// </summary>
/// <param name="application">Builder for configuring an application's request pipeline</param>
public void Configure(IApplicationBuilder application)
{
}
/// <summary>
/// Gets order of this startup configuration implementation
/// </summary>
public int Order => 11;
}
Struktura projektu daňového pluginu

Zpracování metod "Install" a "Uninstall"
Tento krok je volitelný. Některé pluginy mohou během instalace vyžadovat dodatečnou logiku. Plugin může například vložit nové lokalizační prostředky nebo přidat potřebné tabulky či hodnoty nastavení. Otevřete tedy svou implementaci BasePlugin a přepište následující metody:
Install. Tato metoda se zavolá během instalace pluginu. Zde můžete inicializovat jakákoli nastavení, vložit nové lokalizační prostředky nebo vytvořit nové databázové tabulky (pokud je to potřeba).
public override void Install()
{
//database objects
_objectContext.Install();
//settings
_settingService.SaveSetting(new FixedOrByCountryStateZipTaxSettings());
//locales
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fixed", "Fixed rate");
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.TaxByCountryStateZip", "By Country");
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.TaxCategoryName", "Tax category");
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Rate", "Rate");
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Store", "Store");
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Store.Hint", "If an asterisk is selected, then this shipping rate will apply to all stores.");
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Country", "Country");
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Country.Hint", "The country.");
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.StateProvince", "State / province");
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.StateProvince.Hint", "If an asterisk is selected, then this tax rate will apply to all customers from the given country, regardless of the state.");
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Zip", "Zip");
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Zip.Hint", "Zip / postal code. If zip is empty, then this tax rate will apply to all customers from the given country or state, regardless of the zip code.");
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.TaxCategory", "Tax category");
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.TaxCategory.Hint", "The tax category.");
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Percentage", "Percentage");
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Percentage.Hint", "The tax rate.");
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.AddRecord", "Add tax rate");
_localizationService.AddOrUpdatePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.AddRecordTitle", "New tax rate");
base.Install();
}
Uninstall. Tato metoda se zavolá během odinstalace pluginu. Můžete odstranit nastavení, lokalizační prostředky nebo databázové tabulky, které plugin inicializoval během instalace.
public override void Uninstall()
{
//settings
_settingService.DeleteSetting<FixedOrByCountryStateZipTaxSettings>();
//fixed rates
var fixedRates = _taxCategoryService.GetAllTaxCategories()
.Select(taxCategory => _settingService.GetSetting(string.Format(FixedOrByCountryStateZipDefaults.FixedRateSettingsKey, taxCategory.Id)))
.Where(setting => setting != null).ToList();
_settingService.DeleteSettings(fixedRates);
//database objects
_objectContext.Uninstall();
//locales
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fixed");
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.TaxByCountryStateZip");
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.TaxCategoryName");
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Rate");
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Store");
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Store.Hint");
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Country");
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Country.Hint");
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.StateProvince");
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.StateProvince.Hint");
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Zip");
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Zip.Hint");
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.TaxCategory");
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.TaxCategory.Hint");
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Percentage");
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.Fields.Percentage.Hint");
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.AddRecord");
_localizationService.DeletePluginLocaleResource("Plugins.Tax.FixedOrByCountryStateZip.AddRecordTitle");
base.Uninstall();
}
Důležité
Pokud některou z těchto metod přepíšete, nezakrývejte její základní implementaci – base.Install() a base.Uninstall().