class FlatRate in Commerce Shipping 8.2
Provides the FlatRate shipping method.
Plugin annotation
@CommerceShippingMethod(
id = "flat_rate",
label = @Translation("Flat rate"),
)
Hierarchy
- class \Drupal\Component\Plugin\PluginBase implements DerivativeInspectionInterface, PluginInspectionInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
- class \Drupal\commerce_shipping\Plugin\Commerce\ShippingMethod\ShippingMethodBase implements ShippingMethodInterface, ContainerFactoryPluginInterface
- class \Drupal\commerce_shipping\Plugin\Commerce\ShippingMethod\FlatRate
- class \Drupal\commerce_shipping\Plugin\Commerce\ShippingMethod\ShippingMethodBase implements ShippingMethodInterface, ContainerFactoryPluginInterface
- class \Drupal\Core\Plugin\PluginBase uses DependencySerializationTrait, MessengerTrait, StringTranslationTrait
Expanded class hierarchy of FlatRate
1 file declares its use of FlatRate
- DynamicRate.php in tests/
modules/ commerce_shipping_test/ src/ Plugin/ Commerce/ ShippingMethod/ DynamicRate.php
File
- src/
Plugin/ Commerce/ ShippingMethod/ FlatRate.php, line 21
Namespace
Drupal\commerce_shipping\Plugin\Commerce\ShippingMethodView source
class FlatRate extends ShippingMethodBase {
/**
* Constructs a new FlatRate object.
*
* @param array $configuration
* A configuration array containing information about the plugin instance.
* @param string $plugin_id
* The plugin_id for the plugin instance.
* @param mixed $plugin_definition
* The plugin implementation definition.
* @param \Drupal\commerce_shipping\PackageTypeManagerInterface $package_type_manager
* The package type manager.
* @param \Drupal\state_machine\WorkflowManagerInterface $workflow_manager
* The workflow manager.
*/
public function __construct(array $configuration, $plugin_id, $plugin_definition, PackageTypeManagerInterface $package_type_manager, WorkflowManagerInterface $workflow_manager) {
parent::__construct($configuration, $plugin_id, $plugin_definition, $package_type_manager, $workflow_manager);
$this->services['default'] = new ShippingService('default', $this->configuration['rate_label']);
}
/**
* {@inheritdoc}
*/
public function defaultConfiguration() {
return [
'rate_label' => '',
'rate_description' => '',
'rate_amount' => NULL,
'services' => [
'default',
],
] + parent::defaultConfiguration();
}
/**
* {@inheritdoc}
*/
public function buildConfigurationForm(array $form, FormStateInterface $form_state) {
$form = parent::buildConfigurationForm($form, $form_state);
$amount = $this->configuration['rate_amount'];
// A bug in the plugin_select form element causes $amount to be incomplete.
if (isset($amount) && !isset($amount['number'], $amount['currency_code'])) {
$amount = NULL;
}
$form['rate_label'] = [
'#type' => 'textfield',
'#title' => t('Rate label'),
'#description' => t('Shown to customers when selecting the rate.'),
'#default_value' => $this->configuration['rate_label'],
'#required' => TRUE,
];
$form['rate_description'] = [
'#type' => 'textfield',
'#title' => t('Rate description'),
'#description' => t('Provides additional details about the rate to the customer.'),
'#default_value' => $this->configuration['rate_description'],
];
$form['rate_amount'] = [
'#type' => 'commerce_price',
'#title' => t('Rate amount'),
'#default_value' => $amount,
'#required' => TRUE,
];
return $form;
}
/**
* {@inheritdoc}
*/
public function submitConfigurationForm(array &$form, FormStateInterface $form_state) {
parent::submitConfigurationForm($form, $form_state);
if (!$form_state
->getErrors()) {
$values = $form_state
->getValue($form['#parents']);
$this->configuration['rate_label'] = $values['rate_label'];
$this->configuration['rate_description'] = $values['rate_description'];
$this->configuration['rate_amount'] = $values['rate_amount'];
}
}
/**
* {@inheritdoc}
*/
public function calculateRates(ShipmentInterface $shipment) {
$rates = [];
$rates[] = new ShippingRate([
'shipping_method_id' => $this->parentEntity
->id(),
'service' => $this->services['default'],
'amount' => Price::fromArray($this->configuration['rate_amount']),
'description' => $this->configuration['rate_description'],
]);
return $rates;
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
DependencySerializationTrait:: |
protected | property | An array of entity type IDs keyed by the property name of their storages. | |
DependencySerializationTrait:: |
protected | property | An array of service IDs keyed by property name used for serialization. | |
DependencySerializationTrait:: |
public | function | 1 | |
DependencySerializationTrait:: |
public | function | 2 | |
FlatRate:: |
public | function |
Form constructor. Overrides ShippingMethodBase:: |
1 |
FlatRate:: |
public | function |
Calculates rates for the given shipment. Overrides ShippingMethodInterface:: |
2 |
FlatRate:: |
public | function |
Gets default configuration for this plugin. Overrides ShippingMethodBase:: |
|
FlatRate:: |
public | function |
Form submission handler. Overrides ShippingMethodBase:: |
|
FlatRate:: |
public | function |
Constructs a new FlatRate object. Overrides ShippingMethodBase:: |
|
MessengerTrait:: |
protected | property | The messenger. | 29 |
MessengerTrait:: |
public | function | Gets the messenger. | 29 |
MessengerTrait:: |
public | function | Sets the messenger. | |
PluginBase:: |
protected | property | Configuration information passed into the plugin. | 1 |
PluginBase:: |
protected | property | The plugin implementation definition. | 1 |
PluginBase:: |
protected | property | The plugin_id. | |
PluginBase:: |
constant | A string which is used to separate base plugin IDs from the derivative ID. | ||
PluginBase:: |
public | function |
Gets the base_plugin_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the derivative_id of the plugin instance. Overrides DerivativeInspectionInterface:: |
|
PluginBase:: |
public | function |
Gets the definition of the plugin implementation. Overrides PluginInspectionInterface:: |
3 |
PluginBase:: |
public | function |
Gets the plugin_id of the plugin instance. Overrides PluginInspectionInterface:: |
|
PluginBase:: |
public | function | Determines if the plugin is configurable. | |
ShippingMethodBase:: |
protected | property | The package type manager. | |
ShippingMethodBase:: |
protected | property | The parent config entity. | |
ShippingMethodBase:: |
protected | property | The shipping services. | |
ShippingMethodBase:: |
protected | property | The workflow manager. | |
ShippingMethodBase:: |
public | function |
Calculates dependencies for the configured plugin. Overrides DependentPluginInterface:: |
|
ShippingMethodBase:: |
public static | function |
Creates an instance of the plugin. Overrides ContainerFactoryPluginInterface:: |
|
ShippingMethodBase:: |
public | function |
Gets this plugin's configuration. Overrides ConfigurableInterface:: |
|
ShippingMethodBase:: |
public | function |
Gets the default package type. Overrides ShippingMethodInterface:: |
|
ShippingMethodBase:: |
public | function |
Gets the shipping method label. Overrides ShippingMethodInterface:: |
|
ShippingMethodBase:: |
public | function |
Gets the shipping services. Overrides ShippingMethodInterface:: |
|
ShippingMethodBase:: |
public | function |
Gets the shipment workflow ID. Overrides ShippingMethodInterface:: |
|
ShippingMethodBase:: |
public | function |
Selects the given shipping rate for the given shipment. Overrides ShippingMethodInterface:: |
|
ShippingMethodBase:: |
public | function |
Sets the configuration for this plugin instance. Overrides ConfigurableInterface:: |
|
ShippingMethodBase:: |
public | function |
Sets the parent entity. Overrides ParentEntityAwareInterface:: |
|
ShippingMethodBase:: |
public | function |
Form validation handler. Overrides PluginFormInterface:: |
|
StringTranslationTrait:: |
protected | property | The string translation service. | 1 |
StringTranslationTrait:: |
protected | function | Formats a string containing a count of items. | |
StringTranslationTrait:: |
protected | function | Returns the number of plurals supported by a given language. | |
StringTranslationTrait:: |
protected | function | Gets the string translation service. | |
StringTranslationTrait:: |
public | function | Sets the string translation service to use. | 2 |
StringTranslationTrait:: |
protected | function | Translates a string to the current language or to a given language. |