README

Message\Mothership\Commerce Cogule 为 Mothership 提供基本的商业功能。这构成了 ECommerce 和 EPOS 建筑块的组成部分。

安装

使用 Composer 安装此包。包名为 message/cog-mothership-commerce。

您需要在 composer.json 中的 repositories 键中添加 Message 的私有包服务器。

{
	"repositories": [
		{
			"type": "composer",
			"url" : "http://packages.message.co.uk"
		}
	],
	"require": {
		"message/cog-mothership-commerce": "~4.1"
	}
}

##产品 A 产品对象代表一个特定的产品。它们提供诸如类别和品牌以及价格等属性。单位允许对产品进行变体，例如“尺寸”和“颜色”。因此，在向用户显示价格时通常更希望使用单位而不是产品。

如果单位上没有提供价格，则默认为产品价格。

##产品\类型每个产品都有一个与其关联的类型。类型的主要用途是允许不同产品需要不同的信息。例如，MusicProductType 需要提供艺术家。类型还允许将“显示名称”设置为不同的格式。

用于在管理面板中使用的类型在 IoC 中设置为服务 product.types。只有在服务容器中注册的类型才能在创建产品时使用。

##产品\价格产品定价对象是一组价格（浮点数），映射到货币和区域。产品和单位对象都有一个定价对象，它们在调用 getPrice()、getNetPrice() 等时使用。该对象负责根据货币和区域获取正确的价格以显示。

##产品\税通过 TaxResolverInterface 实例将产品税加载到产品上。使用这些税率和一个 TaxStrategyInterface 实例计算净价和含税价。

###TaxResolver TaxResolverInterface 是一个接口，用于一个将获取一个令牌和一个 Address 并返回包含该令牌/地址组合所有适用税率 TaxCollection 的类的接口。默认情况下，使用 TaxResolver。它查看 tax.yml 文件以解析税。

###TaxStrategy 虽然可以实现接口以提供更多税策略，但实际使用中只有两种税策略将被使用。这些是含税和不含税。这些在商业模块中提供。

产品\库存

通用

Product\Stock 负责处理库存变化。每次库存变化都以库存调整（Product\Stock\Movement\Adjustment\Adjustment）的形式记录。在同一操作（创建新订单/在单个请求中调整库存水平）中创建的库存调整被库存移动（Product\Stock\Movement\Movement）所包围，以提供原因、作者等信息。

库存管理器

库存管理器 Product\Stock\StockManager 负责创建和保存新的库存变动（和调整）。请阅读 Product\Stock 的详细说明文档以获取更多信息！

变动迭代器

此外，还有一个库存变动的迭代器，允许您遍历库存历史记录并获取在任何变动之前或之后的库存水平。请阅读 Product\Stock 的详细说明文档以获取更多信息！

产品页面映射器

商业包包含两个产品页面映射器的实现：SimpleMapper 和 OptionCriteriaMapper。默认情况下，SimpleMapper 被别名到 product.page_mapper。

配置

要使映射器能够正确地将产品与页面关联起来，您必须设置产品页面的 product_content.field_name 和 product_content.group_name 的有效值。此外，您还应设置有效的页面类型。您可以使用以下方式更改这些设置：

$services->extend('product.page_mapper', function($mapper, $c) {
	$mapper->setValidFieldNames('product');

	// Passing an array to either method will match against all values
	$mapper->setValidGroupNames(['product', 'showcase']);

	// Passing false to the group name will exclude pages within any group
	$mapper->setValidGroupNames(false);

	// Passing null or an empty array to the group name will match pages with
	// any or no group
	$mapper->setValidGroupNames([]);

	$mapper->setValidPageTypes(['product', 'strap']);

	return $mapper;
});

这些默认值为

字段名称：'product'
组名称：null
页面类型：'product'

简单映射器

简单映射器仅将基本产品映射到页面。

用法

// Find a page from a product
$page = $services['product.page_mapper']->getPageForProduct($product);

// Find a product from a page
$product = $services['product.page_mapper']->getProductForPage($page);

选项条件映射器

选项条件映射器还可以应用特定产品选项的过滤器，例如 ['colour' => 'red']。您可以传递任意数量的选项：['colour' => 'red', 'size' => 'medium']。

要启用选项条件映射器，您必须在您的服务中将别名映射到页面映射器

$services['product.page_mapper'] = $services->raw('product.page_mapper.option_criteria');

用法

除了前面的方法之外，您还可以调用

// Find all pages from a product
$pages = $services['product.page_mapper']->getPagesForProduct($product, ['colour' => 'red']);

// Find a page from a unit
$page = $services['product.page_mapper']->getPageForProductUnit($unit);

// Find units from a page
$units = $services['product.page_mapper']->getProductUnitsForPage($page);

自定义映射器

在编写自定义映射器时，您应该扩展 AbstractMapper 以确保兼容性。

过滤器

您可以传递过滤器回调函数，这些回调函数在从数据库检索结果后应用。从回调函数返回 false 将从结果中删除对象。

用法

$services->extend('product.page_mapper', function($mapper, $c) {
	$mapper->addFilter(function($obj) {
		if ($obj instanceof Page) {
			return (false !== stristr($obj->title, "foo"));
		}
	});

	return $mapper;
});

许可

本程序是自由软件：您可以重新分发它并/或修改它，前提是您必须根据自由软件基金会发布的 GNU 通用公共许可证的条款，许可证版本 3 或（根据您的选择）任何后续版本。

本程序分发的目的是希望它有用，但没有任何保证；甚至没有关于其可销售性或适用于特定目的的暗示性保证。有关详细信息，请参阅 GNU 通用公共许可证。

您应已收到一份 GNU 通用公共许可证副本。如果没有，请参阅 https://gnu.ac.cn/licenses/。

mothership-ec / cog-mothership-commerce

维护者

详细信息