Add events and logging for payments

modules/log/commerce_log.commerce_log_categories.yml

@@ -5,3 +5,7 @@ commerce_cart:
 commerce_order:
   label: Order
   entity_type: commerce_order
+
+commerce_payment:
+  label: Payment
+  entity_type: commerce_payment

modules/log/commerce_log.commerce_log_templates.yml

@@ -27,3 +27,20 @@ order_assigned:
   category: commerce_order
   label: 'Order assigned'
   template: '<p>The order was assigned to {{ user }}.</p>'
+
+payment_insert:
+  category: commerce_payment
+  label: 'Payment created'
+  template: '<p>Payment of {{ amount|commerce_price_format }} was created.</p>'
+payment_update:
+  category: commerce_payment
+  label: 'Payment updated'
+  template: '<p>Payment of {{ amount|commerce_price_format }} was updated.</p>'
+payment_delete:
+  category: commerce_payment
+  label: 'Payment deleted'
+  template: '<p>Payment of {{ amount|commerce_price_format }} was deleted.</p>'
+payment_refunded:
+  category: commerce_payment
+  label: 'Payment refunded'
+  template: '<p>Payment of {{ refunded_amount|commerce_price_format }} was refunded.</p>'

modules/log/commerce_log.module

@@ -5,6 +5,8 @@
  * Provides activity logs for Commerce entities.
  */
 
+use Drupal\commerce_log\PaymentListBuilder;
+
 /**
  * Implements hook_preprocess_commerce_order().
  */
@@ -20,3 +22,8 @@ function commerce_log_preprocess_commerce_order(&$variables) {
     '#title' => t('Order activity'),
   ];
 }
+
+function commerce_log_entity_type_alter(array &$entity_types) {
+  /** @var $entity_types \Drupal\Core\Entity\EntityTypeInterface[] */
+  $entity_types['commerce_payment']->setListBuilderClass(PaymentListBuilder::class);
+}

modules/log/config/install/views.view.commerce_activity.yml

@@ -288,7 +288,7 @@ display:
           entity_type: commerce_log
           entity_field: log_id
           plugin_id: standard
-      title: 'Order logs'
+      title: 'Activity log'
       header: {  }
       footer: {  }
       empty:
@@ -337,7 +337,7 @@ display:
             type: none
             fail: 'not found'
           validate_options: {  }
-          break_phrase: false
+          break_phrase: true
           not: false
           entity_type: commerce_log
           entity_field: source_entity_id

modules/log/src/CommerceLogServiceProvider.php

@@ -2,6 +2,7 @@
 
 namespace Drupal\commerce_log;
 
+use Drupal\commerce_log\EventSubscriber\PaymentEventSubscriber;
 use Drupal\Core\DependencyInjection\ContainerBuilder;
 use Drupal\Core\DependencyInjection\ServiceProviderBase;
 use Symfony\Component\DependencyInjection\Reference;
@@ -29,6 +30,11 @@ public function register(ContainerBuilder $container) {
         ->addTag('event_subscriber')
         ->addArgument(new Reference('entity_type.manager'));
     }
+    if (isset($modules['commerce_payment'])) {
+      $container->register('commerce_log.payment_subscriber', PaymentEventSubscriber::class)
+        ->addTag('event_subscriber')
+        ->addArgument(new Reference('entity_type.manager'));
+    }
   }
 
 }

modules/log/src/EventSubscriber/PaymentEventSubscriber.php

@@ -0,0 +1,103 @@
+<?php
+
+namespace Drupal\commerce_log\EventSubscriber;
+
+use Drupal\commerce_payment\Entity\PaymentInterface;
+use Drupal\commerce_payment\Event\PaymentEvent;
+use Drupal\commerce_payment\Event\PaymentEvents;
+use Drupal\Core\Entity\EntityTypeManagerInterface;
+use Drupal\state_machine\Event\WorkflowTransitionEvent;
+use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+
+class PaymentEventSubscriber implements EventSubscriberInterface {
+
+  /**
+   * The log storage.
+   *
+   * @var \Drupal\commerce_log\LogStorageInterface
+   */
+  protected $logStorage;
+
+  /**
+   * Constructs a new PaymentEventSubscriber object.
+   *
+   * @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
+   *   The entity type manager.
+   *
+   * @throws \Drupal\Component\Plugin\Exception\InvalidPluginDefinitionException
+   */
+  public function __construct(EntityTypeManagerInterface $entity_type_manager) {
+    $this->logStorage = $entity_type_manager->getStorage('commerce_log');
+  }
+
+  /**
+   * {@inheritdoc}
+   */
+  public static function getSubscribedEvents() {
+    $events = [
+      PaymentEvents::PAYMENT_INSERT => ['onPaymentInsert', -100],
+      PaymentEvents::PAYMENT_UPDATE => ['onPaymentUpdate', -100],
+      PaymentEvents::PAYMENT_DELETE => ['onPaymentDelete', -100],
+    ];
+    return $events;
+  }
+
+  /**
+   * Creates a log when a payment is inserted.
+   *
+   * @param \Drupal\commerce_payment\Event\PaymentEvent $event
+   *   The payment event.
+   *
+   * @throws \Drupal\Core\Entity\EntityStorageException
+   */
+  public function onPaymentInsert(PaymentEvent $event) {
+    $this->logPayment($event->getPayment(), 'payment_insert');
+  }
+
+  /**
+   * Creates a log when a payment is updated.
+   *
+   * @param \Drupal\commerce_payment\Event\PaymentEvent $event
+   *   The payment event.
+   *
+   * @throws \Drupal\Core\Entity\EntityStorageException
+   */
+  public function onPaymentUpdate(PaymentEvent $event) {
+    $payment = $event->getPayment();
+    $this->logPayment($payment, 'payment_update');
+    if ($refunded = $payment->getRefundedAmount()) {
+      $this->logStorage->generate($payment, 'refund', [
+        'refunded_amount' => $refunded,
+      ])->save();
+    }
+  }
+
+  /**
+   * Creates a log when a payment is deleted.
+   *
+   * @param \Drupal\commerce_payment\Event\PaymentEvent $event
+   *   The payment event.
+   *
+   * @throws \Drupal\Core\Entity\EntityStorageException
+   */
+  public function onPaymentDelete(PaymentEvent $event) {
+    $this->logPayment($event->getPayment(), 'payment_delete');
+  }
+
+  /**
+   * Creates a log when a payment is changed.
+   *
+   * @param \Drupal\commerce_payment\Entity\PaymentInterface $payment
+   *   The payment.
+   * @param string $templateId
+   *   The log template ID.
+   *
+   * @throws \Drupal\Core\Entity\EntityStorageException
+   */
+  protected function logPayment(PaymentInterface $payment, $templateId) {
+    $this->logStorage->generate($payment, $templateId, [
+      'amount' => $payment->getAmount(),
+    ])->save();
+  }
+
+}

modules/log/src/PaymentListBuilder.php

@@ -0,0 +1,34 @@
+<?php
+
+namespace Drupal\commerce_log;
+
+use Drupal\commerce_payment\PaymentListBuilder as BasePaymentListBuilder;
+
+/**
+ * Overrides the list builder for payments.
+ */
+class PaymentListBuilder extends BasePaymentListBuilder {
+
+  /**
+   * {@inheritdoc}
+   */
+  public function render() {
+    $build = parent::render();
+    $entityIds = [];
+    foreach ($this->load() as $entity) {
+      $entityIds[] = $entity->id();
+    }
+    $build['log']['title'] = [
+      '#markup' => '<h3>' . $this->t('Payment activity') . '</h3>',
+    ];
+    $build['log']['activity'] = [
+      '#type' => 'view',
+      '#name' => 'commerce_activity',
+      '#display_id' => 'default',
+      '#arguments' => [implode('+', $entityIds), 'commerce_payment'],
+      '#embed' => FALSE,
+    ];
+    return $build;
+  }
+
+}

modules/payment/src/Entity/Payment.php

@@ -26,6 +26,7 @@
  *   bundle_plugin_type = "commerce_payment_type",
  *   handlers = {
  *     "access" = "Drupal\commerce_payment\PaymentAccessControlHandler",
+ *     "event" = "Drupal\commerce_payment\Event\PaymentEvent",
  *     "list_builder" = "Drupal\commerce_payment\PaymentListBuilder",
  *     "storage" = "Drupal\commerce_payment\PaymentStorage",
  *     "form" = {

modules/payment/src/Event/PaymentEvent.php

@@ -0,0 +1,43 @@
+<?php
+
+namespace Drupal\commerce_payment\Event;
+
+use Drupal\commerce_payment\Entity\PaymentInterface;
+use Drupal\commerce_price\Price;
+use Symfony\Component\EventDispatcher\Event;
+
+/**
+ * Defines the payment event.
+ *
+ * @see \Drupal\commerce_payment\Event\PaymentEvents
+ */
+class PaymentEvent extends Event {
+
+  /**
+   * The payment.
+   *
+   * @var \Drupal\commerce_payment\Entity\PaymentInterface
+   */
+  protected $payment;
+
+  /**
+   * Constructs a new PaymentEvent.
+   *
+   * @param \Drupal\commerce_payment\Entity\PaymentInterface $payment
+   *   The payment.
+   */
+  public function __construct(PaymentInterface $payment) {
+    $this->payment = $payment;
+  }
+
+  /**
+   * Gets the payment.
+   *
+   * @return \Drupal\commerce_payment\Entity\PaymentInterface
+   *   The payment.
+   */
+  public function getPayment() {
+    return $this->payment;
+  }
+
+}

modules/payment/src/Event/PaymentEvents.php

@@ -10,7 +10,74 @@ final class PaymentEvents {
    * @Event
    *
    * @see \Drupal\commerce_payment\Event\FilterPaymentGatewaysEvent
+   *
+   * @var string
    */
   const FILTER_PAYMENT_GATEWAYS = 'commerce_payment.filter_payment_gateways';
 
+
+  /**
+   * Name of the event fired after loading a payment.
+   *
+   * @Event
+   *
+   * @see \Drupal\commerce_payment\Event\PaymentEvent
+   *
+   * @var string
+   */
+  const PAYMENT_LOAD = 'commerce_payment.commerce_payment.load';
+
+  /**
+   * Name of the event fired before saving a payment.
+   *
+   * @Event
+   *
+   * @see \Drupal\commerce_payment\Event\PaymentEvent
+   *
+   * @var string
+   */
+  const PAYMENT_PRESAVE = 'commerce_payment.commerce_payment.presave';
+
+  /**
+   * Name of the event fired after saving a new payment.
+   *
+   * @Event
+   *
+   * @see \Drupal\commerce_payment\Event\PaymentEvent
+   */
+  const PAYMENT_INSERT = 'commerce_payment.commerce_payment.insert';
+
+  /**
+   * Name of the event fired after saving an existing payment.
+   *
+   * @Event
+   *
+   * @see \Drupal\commerce_payment\Event\PaymentEvent
+   *
+   * @var string
+   */
+  const PAYMENT_UPDATE = 'commerce_payment.commerce_payment.update';
+
+  /**
+   * Name of the event fired before deleting a payment.
+   *
+   * @Event
+   *
+   * @see \Drupal\commerce_payment\Event\PaymentEvent
+   *
+   * @var string
+   */
+  const PAYMENT_PREDELETE = 'commerce_payment.commerce_payment.predelete';
+
+  /**
+   * Name of the event fired after deleting a payment.
+   *
+   * @Event
+   *
+   * @see \Drupal\commerce_payment\Event\PaymentEvent
+   *
+   * @var string
+   */
+  const PAYMENT_DELETE = 'commerce_payment.commerce_payment.delete';
+
 }

modules/payment/tests/modules/payment_events_test/payment_events_test.info.yml

@@ -0,0 +1,4 @@
+name: 'Payment events test'
+type: module
+package: Testing
+core: 8.x

modules/payment/tests/modules/payment_events_test/payment_events_test.services.yml

@@ -0,0 +1,6 @@
+services:
+  payment_events_test.event_subscriber:
+    class: Drupal\payment_events_test\EventSubscriber
+    arguments: ['@state']
+    tags:
+      - { name: event_subscriber }