interface CheckoutPaneInterface in Commerce Core 8.2

Defines the interface for checkout panes.

Checkout panes are configurable forms embedded into the checkout flow form.

Hierarchy

interface \Drupal\Component\Plugin\ConfigurableInterface; interface \Drupal\Component\Plugin\DependentPluginInterface; interface \Drupal\Core\Plugin\PluginFormInterface; interface \Drupal\Component\Plugin\PluginInspectionInterface; interface \Drupal\Component\Plugin\DerivativeInspectionInterface
- interface \Drupal\commerce_checkout\Plugin\Commerce\CheckoutPane\CheckoutPaneInterface

Expanded class hierarchy of CheckoutPaneInterface

All classes that implement CheckoutPaneInterface

1 file declares its use of CheckoutPaneInterface

CheckoutFlowWithPanesBase.php in modules/checkout/src/Plugin/Commerce/CheckoutFlow/CheckoutFlowWithPanesBase.php

File

modules/checkout/src/Plugin/Commerce/CheckoutPane/CheckoutPaneInterface.php, line 18

Namespace

Drupal\commerce_checkout\Plugin\Commerce\CheckoutPane

View source

interface CheckoutPaneInterface extends ConfigurableInterface, DependentPluginInterface, PluginFormInterface, PluginInspectionInterface, DerivativeInspectionInterface {

  /**
   * Sets the current order.
   *
   * Used to keep the pane order in sync with the checkout flow order.
   *
   * @param \Drupal\commerce_order\Entity\OrderInterface $order
   *   The order.
   *
   * @return $this
   */
  public function setOrder(OrderInterface $order);

  /**
   * Gets the pane ID.
   *
   * @return string
   *   The pane ID.
   */
  public function getId();

  /**
   * Gets the pane label.
   *
   * This label is admin-facing.
   *
   * @return string
   *   The pane label.
   */
  public function getLabel();

  /**
   * Gets the pane display label.
   *
   * This label is customer-facing.
   * Shown as the title of the pane form if the wrapper_element is 'fieldset'.
   *
   * @return string
   *   The pane display label.
   */
  public function getDisplayLabel();

  /**
   * Gets the pane wrapper element.
   *
   * Used when rendering the pane's form.
   * E.g: 'container', 'fieldset'. Defaults to 'container'.
   *
   * @return string
   *   The pane wrapper element.
   */
  public function getWrapperElement();

  /**
   * Gets the pane step ID.
   *
   * @return string
   *   The pane step ID.
   */
  public function getStepId();

  /**
   * Sets the pane step ID.
   *
   * @param string $step_id
   *   The pane step ID.
   *
   * @return $this
   */
  public function setStepId($step_id);

  /**
   * Gets the pane weight.
   *
   * @return string
   *   The pane weight.
   */
  public function getWeight();

  /**
   * Sets the pane weight.
   *
   * @param int $weight
   *   The pane weight.
   *
   * @return $this
   */
  public function setWeight($weight);

  /**
   * Builds a summary of the pane configuration.
   *
   * Complements the methods provided by PluginFormInterface, allowing
   * the checkout flow form to provide a summary of pane configuration.
   *
   * @return string
   *   An HTML summary of the pane configuration.
   */
  public function buildConfigurationSummary();

  /**
   * Determines whether the pane is visible.
   *
   * @return bool
   *   TRUE if the pane is visible, FALSE otherwise.
   */
  public function isVisible();

  /**
   * Builds a summary of the pane values.
   *
   * Important:
   * The review pane shows summaries for both visible and non-visible panes.
   * To skip showing a summary for a non-visible pane, check isVisible()
   * and return an empty array.
   *
   * @return array
   *   A render array containing the summary of the pane values.
   */
  public function buildPaneSummary();

  /**
   * Builds the pane form.
   *
   * @param array $pane_form
   *   The pane form, containing the following basic properties:
   *   - #parents: Identifies the position of the pane form in the overall
   *     parent form, and identifies the location where the field values are
   *     placed within $form_state->getValues().
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The form state of the parent form.
   * @param array $complete_form
   *   The complete form structure.
   */
  public function buildPaneForm(array $pane_form, FormStateInterface $form_state, array &$complete_form);

  /**
   * Validates the pane form.
   *
   * @param array $pane_form
   *   The pane form.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The form state of the parent form.
   * @param array $complete_form
   *   The complete form structure.
   */
  public function validatePaneForm(array &$pane_form, FormStateInterface $form_state, array &$complete_form);

  /**
   * Handles the submission of an pane form.
   *
   * @param array $pane_form
   *   The pane form.
   * @param \Drupal\Core\Form\FormStateInterface $form_state
   *   The form state of the parent form.
   * @param array $complete_form
   *   The complete form structure.
   */
  public function submitPaneForm(array &$pane_form, FormStateInterface $form_state, array &$complete_form);

}

Members

Name	Modifiers	Type	Description	Overrides
CheckoutPaneInterface::buildConfigurationSummary	public	function	Builds a summary of the pane configuration.	1
CheckoutPaneInterface::buildPaneForm	public	function	Builds the pane form.	11
CheckoutPaneInterface::buildPaneSummary	public	function	Builds a summary of the pane values.	1
CheckoutPaneInterface::getDisplayLabel	public	function	Gets the pane display label.	1
CheckoutPaneInterface::getId	public	function	Gets the pane ID.	1
CheckoutPaneInterface::getLabel	public	function	Gets the pane label.	1
CheckoutPaneInterface::getStepId	public	function	Gets the pane step ID.	1
CheckoutPaneInterface::getWeight	public	function	Gets the pane weight.	1
CheckoutPaneInterface::getWrapperElement	public	function	Gets the pane wrapper element.	1
CheckoutPaneInterface::isVisible	public	function	Determines whether the pane is visible.	1
CheckoutPaneInterface::setOrder	public	function	Sets the current order.	1
CheckoutPaneInterface::setStepId	public	function	Sets the pane step ID.	1
CheckoutPaneInterface::setWeight	public	function	Sets the pane weight.	1
CheckoutPaneInterface::submitPaneForm	public	function	Handles the submission of an pane form.	1
CheckoutPaneInterface::validatePaneForm	public	function	Validates the pane form.	1
ConfigurableInterface::defaultConfiguration	public	function	Gets default configuration for this plugin.	11
ConfigurableInterface::getConfiguration	public	function	Gets this plugin's configuration.	12
ConfigurableInterface::setConfiguration	public	function	Sets the configuration for this plugin instance.	12
DependentPluginInterface::calculateDependencies	public	function	Calculates dependencies for the configured plugin.	19
DerivativeInspectionInterface::getBaseId	public	function	Gets the base_plugin_id of the plugin instance.	1
DerivativeInspectionInterface::getDerivativeId	public	function	Gets the derivative_id of the plugin instance.	1
PluginFormInterface::buildConfigurationForm	public	function	Form constructor.	36
PluginFormInterface::submitConfigurationForm	public	function	Form submission handler.	32
PluginFormInterface::validateConfigurationForm	public	function	Form validation handler.	18
PluginInspectionInterface::getPluginDefinition	public	function	Gets the definition of the plugin implementation.	4
PluginInspectionInterface::getPluginId	public	function	Gets the plugin_id of the plugin instance.	2

You are here

interface CheckoutPaneInterface in Commerce Core 8.2

Hierarchy

File

Namespace

Members

API Navigation