Я постараюсь ответить на ваш вопрос (ы).
Нет . Это неправильный способ добавления пользовательских атрибутов в форму адреса доставки. Вам не нужно редактировать new-customer-address.js. Действительно, этот файл JS перечисляет все предопределенные атрибуты адреса и соответствует соответствующему интерфейсу бэкэнда, \Magento\Quote\Api\Data\AddressInterfaceно Magento предоставляет возможность передавать любые пользовательские атрибуты бэкэнду без изменения компонентов бэкэнда / внешнего интерфейса .
Упомянутый JS-компонент обладает customAttributesсвойством. Ваши пользовательские атрибуты будут автоматически обрабатываться, если они $dataScopePrefixравны ' shippindAddress.custom_attributes'.
Если я правильно понял ваш вопрос, у вас есть данные, которые не являются частью адреса клиента, но вам также необходимо отправить их бэкэнду. Ответ на этот вопрос:
Это зависит . Например, вы можете выбрать следующий подход: добавить настраиваемую форму на страницу оформления заказа, которая включает все ваши дополнительные поля (like comment, invoice request etc) , добавить логику JS, которая будет обрабатывать эту форму на основе некоторых событий, и предоставить настраиваемую службу, которая будет получать данные из внешнего интерфейса и сохранять это где-то для будущего использования.
Вся официальная документация, связанная с оформлением заказа, находится по адресу http://devdocs.magento.com/guides/v2.1/howdoi/checkout/checkout_overview.html . Термин статический относится к формам, где все поля уже известны / предопределены (например, форма всегда будет иметь 2 текстовых поля с предопределенными метками) и не может изменяться в зависимости от некоторых настроек в бэкэнде.
Такие формы могут быть объявлены с использованием layout XML configuration. С другой стороны, термин «динамический» относится к формам , набор полей которых может изменяться (например: форма проверки может иметь больше / меньше полей на основе параметров конфигурации).
В этом случае единственный способ объявить такую форму - использовать LayoutProcessorплагин.
:) Magento старается охватить как можно больше вариантов использования, которые могут быть важны для продавцов во время использования / настройки Magento. Иногда это приводит к ситуации, когда некоторые простые варианты использования становятся более сложными.
Надеюсь это поможет.
================================================== =======================
ОК ... Давайте напишем код;)
- PHP-код, который вставляет дополнительное поле в LayoutProcessor
========
/**
* @author aakimov
*/
$customAttributeCode = 'custom_field';
$customField = [
'component' => 'Magento_Ui/js/form/element/abstract',
'config' => [
// customScope is used to group elements within a single form (e.g. they can be validated separately)
'customScope' => 'shippingAddress.custom_attributes',
'customEntry' => null,
'template' => 'ui/form/field',
'elementTmpl' => 'ui/form/element/input',
'tooltip' => [
'description' => 'Yes, this works. I tested it. Sacrificed my lunch break but verified this approach.',
],
],
'dataScope' => 'shippingAddress.custom_attributes' . '.' . $customAttributeCode,
'label' => 'Custom Attribute',
'provider' => 'checkoutProvider',
'sortOrder' => 0,
'validation' => [
'required-entry' => true
],
'options' => [],
'filterBy' => null,
'customEntry' => null,
'visible' => true,
];
$jsLayout['components']['checkout']['children']['steps']['children']['shipping-step']['children']['shippingAddress']['children']['shipping-address-fieldset']['children'][$customAttributeCode] = $customField;
return $jsLayout;
Как я уже упоминал, это добавит ваше поле к customAttributesсвойству объекта адреса JS. Это свойство было разработано, чтобы содержать пользовательские атрибуты адресов EAV и связано с \Magento\Quote\Model\Quote\Address\CustomAttributeListInterface::getAttributesметодом.
Приведенный выше код автоматически обрабатывает постоянство локального хранилища на веб-интерфейсе. Вы можете получить значение поля из локального хранилища, используя checkoutData.getShippingAddressFromData()(где checkoutDataесть Magento_Checkout/js/checkout-data).
- Добавьте mixin, чтобы изменить поведение «Magento_Checkout / js / action / set-shipping-information» (этот компонент отвечает за передачу данных между этапами доставки и оплаты)
========
2.1. Создайтеyour_module_name/view/frontend/requirejs-config.js
/**
* @author aakimov
*/
var config = {
config: {
mixins: {
'Magento_Checkout/js/action/set-shipping-information': {
'<your_module_name>/js/action/set-shipping-information-mixin': true
}
}
}
};
2.2. Создайте ваше имя_модуля / view / frontend / web / js / action / set-shipping-information-mixin.js
/**
* @author aakimov
*/
/*jshint browser:true jquery:true*/
/*global alert*/
define([
'jquery',
'mage/utils/wrapper',
'Magento_Checkout/js/model/quote'
], function ($, wrapper, quote) {
'use strict';
return function (setShippingInformationAction) {
return wrapper.wrap(setShippingInformationAction, function (originalAction) {
var shippingAddress = quote.shippingAddress();
if (shippingAddress['extension_attributes'] === undefined) {
shippingAddress['extension_attributes'] = {};
}
// you can extract value of extension attribute from any place (in this example I use customAttributes approach)
shippingAddress['extension_attributes']['custom_field'] = shippingAddress.customAttributes['custom_field'];
// pass execution to original action ('Magento_Checkout/js/action/set-shipping-information')
return originalAction();
});
};
});
- Создайте имя_модуля / etc / extension_attributes.xml
========
<?xml version="1.0"?>
<!--
/**
* @author aakimov
*/
-->
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:Api/etc/extension_attributes.xsd">
<extension_attributes for="Magento\Quote\Api\Data\AddressInterface">
<attribute code="custom_field" type="string" />
</extension_attributes>
</config>
Это добавит атрибут расширения к модели адреса на стороне сервера. Атрибуты расширения являются одной из точек расширения, которые предоставляет Magento. Для доступа к вашим данным на бэкэнде вы можете использовать:
// Magento will generate interface that includes your custom attribute
$value = $address->getExtensionAttributes()->getCustomField();
Надеюсь, это поможет и будет добавлено в официальную документацию.