Commerce::getDataFromElements() - Code Metrics - Inspection of "Merge branch 'release/1.1.18' into v1" - nystudio107/craft-instantanalytics - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — v1 ( 930b5e...ec5b39 )

by Andrew
created 2023-01-09 04:24 UTC
Commerce::getDataFromElements() A

↳ Parent: Commerce
Complexity

Conditions	5
Paths	3
Size

Total Lines	28
Code Lines	11
Duplication

Lines	0
Ratio	0 %
Importance

Changes	1
Bugs	1	Features	0
Metric	Value
eloc	11
c	1
b	1
f	0
dl	0
loc	28
rs	9.6111
cc	5
nc	3
nop	2
<?php
/**
 * Instant Analytics plugin for Craft CMS
 *
 * Instant Analytics brings full Google Analytics support to your Twig templates
 *
 * @link      https://nystudio107.com

 * @copyright Copyright (c) 2017 nystudio107

 */


namespace nystudio107\instantanalytics\services;

use Craft;
use craft\base\Component;
use craft\commerce\base\Purchasable;
filter:
    dependency_paths: ["lib/*"]
use craft\commerce\elements\Order;
filter:
    dependency_paths: ["lib/*"]
use craft\commerce\elements\Product;
filter:
    dependency_paths: ["lib/*"]
use craft\commerce\elements\Variant;
filter:
    dependency_paths: ["lib/*"]
use craft\commerce\models\LineItem;
filter:
    dependency_paths: ["lib/*"]
use craft\elements\db\CategoryQuery;
use craft\elements\db\MatrixBlockQuery;
use craft\elements\db\TagQuery;
use nystudio107\instantanalytics\helpers\IAnalytics;
use nystudio107\instantanalytics\InstantAnalytics;

/**
 * Commerce Service
 *
 * @author    nystudio107

 * @package   InstantAnalytics

 * @since     1.0.0

 */

class Commerce extends Component
{
    // Public Methods
    // =========================================================================

    /**
     * Send analytics information for the completed order
     *
     * @param Order $order the Product or Variant
     */

    public function orderComplete($order = null)
    {
        if ($order) {
            $analytics = InstantAnalytics::$plugin->ia->eventAnalytics(
                'Commerce',
                'Purchase',
                $order->reference,
                $order->totalPrice
            );

            if ($analytics) {
                $this->addCommerceOrderToAnalytics($analytics, $order);
                // Don't forget to set the product action, in this case to PURCHASE
                $analytics->setProductActionToPurchase();
                $analytics->sendEvent();

                Craft::info(Craft::t(

                    'instant-analytics',
                    'orderComplete for `Commerce` - `Purchase` - `{reference}` - `{price}`',
                    ['reference' => $order->reference, 'price' => $order->totalPrice]
                ), __METHOD__);
someFunctionCall(
    $firstArgument,
    $secondArgument,
    $thirdArgument
); // Closing parenthesis on a new line.
            }
        }
    }

    /**
     * Send analytics information for the item added to the cart
     *
     * @param Order $order the Product or Variant

     * @param LineItem $lineItem the line item that was added
     */

    public function addToCart(
        /** @noinspection PhpUnusedParameterInspection */

        $order = null, $lineItem = null
    )
    {

        if ($lineItem) {
            $title = $lineItem->purchasable->title ?? $lineItem->description;
            $quantity = $lineItem->qty;
            $analytics = InstantAnalytics::$plugin->ia->eventAnalytics('Commerce', 'Add to Cart', $title, $quantity);

            if ($analytics) {
                $title = $this->addProductDataFromLineItem($analytics, $lineItem);
                $analytics->setEventLabel($title);
                // Don't forget to set the product action, in this case to ADD
                $analytics->setProductActionToAdd();
                $analytics->sendEvent();

                Craft::info(Craft::t(

                    'instant-analytics',
                    'addToCart for `Commerce` - `Add to Cart` - `{title}` - `{quantity}`',
                    ['title' => $title, 'quantity' => $quantity]
                ), __METHOD__);
someFunctionCall(
    $firstArgument,
    $secondArgument,
    $thirdArgument
); // Closing parenthesis on a new line.
            }
        }
    }

    /**
     * Send analytics information for the item removed from the cart
     *
     * @param Order|null $order

     * @param LineItem|null $lineItem

     */

    public function removeFromCart(
        /** @noinspection PhpUnusedParameterInspection */

        $order = null, $lineItem = null
    )
    {

        if ($lineItem) {
            $title = $lineItem->purchasable->title ?? $lineItem->description;
            $quantity = $lineItem->qty;
            $analytics = InstantAnalytics::$plugin->ia->eventAnalytics(
                'Commerce',
                'Remove from Cart',
                $title,
                $quantity
            );

            if ($analytics) {
                $title = $this->addProductDataFromLineItem($analytics, $lineItem);
                $analytics->setEventLabel($title);
                // Don't forget to set the product action, in this case to ADD
                $analytics->setProductActionToRemove();
                $analytics->sendEvent();

                Craft::info(Craft::t(

                    'instant-analytics',
                    'removeFromCart for `Commerce` - `Remove to Cart` - `{title}` - `{quantity}`',
                    ['title' => $title, 'quantity' => $quantity]
                ), __METHOD__);
someFunctionCall(
    $firstArgument,
    $secondArgument,
    $thirdArgument
); // Closing parenthesis on a new line.
            }
        }
    }


    /**
     * Add a Craft Commerce OrderModel to an Analytics object
     *
     * @param IAnalytics $analytics the Analytics object
     * @param Order $order the Product or Variant

     */

    public function addCommerceOrderToAnalytics($analytics = null, $order = null)
    {
        if ($order && $analytics) {
            // First, include the transaction data
            $analytics->setTransactionId($order->reference)
                ->setCurrencyCode($order->paymentCurrency)
                ->setRevenue($order->totalPrice)
                ->setTax($order->getTotalTax())
                ->setShipping($order->getTotalShippingCost());

            // Coupon code?
            if ($order->couponCode) {
                $analytics->setCouponCode($order->couponCode);
            }

            // Add each line item in the transaction
            // Two cases - variant and non variant products
            $index = 1;

            foreach ($order->lineItems as $key => $lineItem) {
                $this->addProductDataFromLineItem($analytics, $lineItem, $index, '');
                $index++;
            }
        }
    }

    /**
     * Add a Craft Commerce LineItem to an Analytics object
     *
     * @param IAnalytics|null $analytics

     * @param LineItem|null $lineItem

     * @param int $index

     * @param string $listName

     *
     * @return string the title of the product
     * @throws \yii\base\InvalidConfigException
     */
    public function addProductDataFromLineItem($analytics = null, $lineItem = null, $index = 0, $listName = ''): string
    {
        $result = '';
        if ($lineItem && $analytics) {
            $product = null;
            $purchasable = $lineItem->purchasable;
            //This is the same for both variant and non variant products
            $productData = [
                'name' => $purchasable->title ?? $lineItem->description,
                'sku' => $purchasable->sku ?? $lineItem->sku,
                'price' => $lineItem->salePrice,
                'quantity' => $lineItem->qty,
            ];
            // Handle this purchasable being a Variant
            if (is_a($purchasable, Variant::class)) {
                /** @var Variant $purchasable */

                $product = $purchasable->getProduct();
                $variant = $purchasable;
                // Product with variants
                $productData['name'] = $product->title;
                $productData['variant'] = $variant->title;
                $productData['category'] = $product->getType();
            }
            // Handle this purchasable being a Product
            if (is_a($purchasable, Product::class)) {
                /** @var Product $purchasable */

                $product = $purchasable;
                $productData['name'] = $product->title;
                $productData['variant'] = $product->title;
                $productData['category'] = $product->getType();
            }
            // Handle product lists
            if ($index) {
                $productData['position'] = $index;
            }
            if ($listName) {
                $productData['list'] = $listName;
            }
            // Add in any custom categories/brands that might be set
            if (InstantAnalytics::$settings && $product) {
                if (isset(InstantAnalytics::$settings['productCategoryField'])
                    && !empty(InstantAnalytics::$settings['productCategoryField'])) {

                    $productData['category'] = $this->pullDataFromField(
                        $product,
                        InstantAnalytics::$settings['productCategoryField']
                    );
                }
                if (isset(InstantAnalytics::$settings['productBrandField'])
                    && !empty(InstantAnalytics::$settings['productBrandField'])) {

                    $productData['brand'] = $this->pullDataFromField(
                        $product,
                        InstantAnalytics::$settings['productBrandField']
                    );
                }
            }
            $result = $productData['name'];
            //Add each product to the hit to be sent
            $analytics->addProduct($productData);
        }

        return $result;
    }

    /**
     * Add a product impression from a Craft Commerce Product or Variant
     *
     * @param IAnalytics $analytics the Analytics object

     * @param Product|Variant $productVariant the Product or Variant
     * @param int $index Where the product appears in the

     *                                        list

     * @param string $listName

     * @param int $listIndex

     *
     * @throws \yii\base\InvalidConfigException
     */

    public function addCommerceProductImpression(
        $analytics = null,
        $productVariant = null,
        $index = 0,
        $listName = 'default',
        $listIndex = 1
    )
    {

        if ($productVariant && $analytics) {
            $productData = $this->getProductDataFromProduct($productVariant);

            /**
             * As per: https://github.com/theiconic/php-ga-measurement-protocol/issues/26
             */
            if ($listName && $listIndex) {
                $analytics->setProductImpressionListName($listName, $listIndex);
            }

            if ($index) {
                $productData['position'] = $index;
            }

            //Add the product to the hit to be sent
            $analytics->addProductImpression($productData, $listIndex);

            Craft::info(Craft::t(

                'instant-analytics',
                'addCommerceProductImpression for `{sku}` - `{name}` - `{name}` - `{index}`',
                ['sku' => $productData['sku'], 'name' => $productData['name'], 'index' => $index]
            ), __METHOD__);
someFunctionCall(
    $firstArgument,
    $secondArgument,
    $thirdArgument
); // Closing parenthesis on a new line.
        }
    }

    /**
     * Add a product detail view from a Craft Commerce Product or Variant
     *
     * @param IAnalytics $analytics the Analytics object

     * @param Product|Variant $productVariant the Product or Variant
     *
     * @throws \yii\base\InvalidConfigException
     */

    public function addCommerceProductDetailView($analytics = null, $productVariant = null)
    {
        if ($productVariant && $analytics) {
            $productData = $this->getProductDataFromProduct($productVariant);

            // Don't forget to set the product action, in this case to DETAIL
            $analytics->setProductActionToDetail();

            //Add the product to the hit to be sent
            $analytics->addProduct($productData);

            Craft::info(Craft::t(

                'instant-analytics',
                'addCommerceProductDetailView for `{sku}` - `{name}`',
                ['sku' => $productData['sku'], 'name' => $productData['name']]
            ), __METHOD__);
someFunctionCall(
    $firstArgument,
    $secondArgument,
    $thirdArgument
); // Closing parenthesis on a new line.
        }
    }

    /**
     * Add a checkout step and option to an Analytics object
     *
     * @param IAnalytics $analytics the Analytics object
     * @param Order $order the Product or Variant

     * @param int $step the checkout step

     * @param string $option the checkout option

     */

    public function addCommerceCheckoutStep($analytics = null, $order = null, $step = 1, $option = '')
    {
        if ($order && $analytics) {
            // Add each line item in the transaction
            // Two cases - variant and non variant products
            $index = 1;

            foreach ($order->lineItems as $key => $lineItem) {
                $this->addProductDataFromLineItem($analytics, $lineItem, $index, '');
                $index++;
            }

            $analytics->setCheckoutStep($step);

            if ($option) {
                $analytics->setCheckoutStepOption($option);
            }

            // Don't forget to set the product action, in this case to CHECKOUT
            $analytics->setProductActionToCheckout();

            Craft::info(Craft::t(

                'instant-analytics',
                'addCommerceCheckoutStep step: `{step}` with option: `{option}`',
                ['step' => $step, 'option' => $option]
            ), __METHOD__);
someFunctionCall(
    $firstArgument,
    $secondArgument,
    $thirdArgument
); // Closing parenthesis on a new line.
        }
    }

    /**
     * Extract product data from a Craft Commerce Product or Variant
     *
     * @param Product|Variant $productVariant the Product or Variant
     *
     * @return array the product data
     * @throws \yii\base\InvalidConfigException
     */
    public function getProductDataFromProduct($productVariant = null): array
    {
        $result = [];

        // Extract the variant if it's a Product or Purchasable
        if ($productVariant && \is_object($productVariant)) {
            if (is_a($productVariant, Product::class)
                || is_a($productVariant, Purchasable::class)
            ) {
                $productType = property_exists($productVariant, 'typeId')
                    ? InstantAnalytics::$commercePlugin->getProductTypes()->getProductTypeById($productVariant->typeId)
                    ? InstantAnalytics::$commercePlugin->/** @scrutinizer ignore-call */ getProductTypes()->getProductTypeById($productVariant->typeId)
                    : null;

                if ($productType && $productType->hasVariants) {
                    $productVariants = $productVariant->getVariants();
                    $productVariant = reset($productVariants);
                    $product = $productVariant->getProduct();

                    if ($product) {
                        $category = $product->getType()['name'];
                        $name = $product->title;
                        $variant = $productVariant->title;
                    } else {
                        $category = $productVariant->getType()['name'];
                        $name = $productVariant->title;
                        $variant = '';
                    }
                } else {
                    if (!empty($productVariant->defaultVariantId)) {
                        /** @var Variant $productVariant */

                        $productVariant = InstantAnalytics::$commercePlugin->getVariants()->getVariantById(
                            $productVariant->defaultVariantId
                        );
                        $category = $productVariant->getProduct()->getType()['name'];
                        $name = $productVariant->title;
                        $variant = '';
                    } else {
                        if (isset($productVariant->product)) {
                            $category = $productVariant->product->getType()['name'];
                            $name = $productVariant->product->title;
                        } else {
                            $category = $productVariant->getType()['name'];
                            $name = $productVariant->title;
                        }
                        $variant = $productVariant->title;
                    }
                }
            }

            $productData = [
                'sku' => $productVariant->sku,
                'name' => $name,

                'price' => number_format($productVariant->price, 2, '.', ''),
                'category' => $category,

            ];

            if ($variant) {

                $productData['variant'] = $variant;
            }

            $isVariant = is_a($productVariant, Variant::class);

            if (InstantAnalytics::$settings) {
                if (isset(InstantAnalytics::$settings['productCategoryField'])
                    && !empty(InstantAnalytics::$settings['productCategoryField'])) {

                    $productData['category'] = $this->pullDataFromField(
                        $productVariant,
                        InstantAnalytics::$settings['productCategoryField']
                    );
                    if (empty($productData['category']) && $isVariant) {
                        $productData['category'] = $this->pullDataFromField(
                            $productVariant->product,
                            InstantAnalytics::$settings['productCategoryField']
                        );
                    }
                }
                if (isset(InstantAnalytics::$settings['productBrandField'])
                    && !empty(InstantAnalytics::$settings['productBrandField'])) {

                    $productData['brand'] = $this->pullDataFromField(
                        $productVariant,
                        InstantAnalytics::$settings['productBrandField'],
                        true
                    );

                    if (empty($productData['brand']) && $isVariant) {
                        $productData['brand'] = $this->pullDataFromField(
                            $productVariant,
                            InstantAnalytics::$settings['productBrandField'],
                            true
                        );
                    }
                }
            }

            $result = $productData;
        }

        return $result;
    }

    /**

     * @param Product|Variant|null $productVariant

     * @param string $fieldHandle

     * @param bool $isBrand

     *
     * @return string
     */
    protected function pullDataFromField($productVariant, $fieldHandle, $isBrand = false): string
    {
        $result = '';
        if ($productVariant && $fieldHandle) {
            $srcField = $productVariant[$fieldHandle] ?? $productVariant->product[$fieldHandle] ?? null;
            // Handle eager loaded elements
            if (is_array($srcField)) {
                return $this->getDataFromElements($isBrand, $srcField);
            }
            // If the source field isn't an object, return nothing
            if (!is_object($srcField)) {
                return $result;
            }
            switch (\get_class($srcField)) {
                case MatrixBlockQuery::class:

                    break;
                case TagQuery::class:

                    break;
                case CategoryQuery::class:

                    $result = $this->getDataFromElements($isBrand, $srcField->all());
                    break;


                default:

                    $result = strip_tags($srcField);
                    $result = strip_tags(/** @scrutinizer ignore-type */ $srcField);
                    break;
            }
        }

        return $result;
    }

    /**

     * @param bool $isBrand

     * @param array $elements

     * @return string

     */
    protected function getDataFromElements(bool $isBrand, array $elements): string
    {
        $cats = [];

        if ($isBrand) {
            // Because we can only have one brand, we'll get
            // the very last category. This means if our
            // brand is a sub-category, we'll get the child
            // not the parent.
            foreach ($elements as $cat) {
                $cats = [$cat->title];
            }
        } else {
            // For every category, show its ancestors
            // delimited by a slash.
            foreach ($elements as $cat) {
                $name = $cat->title;

                while ($cat = $cat->parent) {
                    $name = $cat->title . '/' . $name;
                }

                $cats[] = $name;
            }
        }

        // Join separate categories with a pipe.
        return implode('|', $cats);
    }
}

nystudio107 / craft-instantanalytics

Push — v1 ( 930b5e...ec5b39 )

Commerce::getDataFromElements() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like
