HEX
Server: nginx/1.27.1
System: Linux in-3 5.15.0-161-generic #171-Ubuntu SMP Sat Oct 11 08:17:01 UTC 2025 x86_64
User: ivenus-clone (3297)
PHP: 7.4.33
Disabled: exec,passthru,shell_exec,system,proc_open,popen,parse_ini_file,show_source
Upload Files
File: /storage/v4513/tepnot/public_html/wp-content/plugins/dokan-pro/includes/Shipping/Helper.php
<?php

namespace WeDevs\DokanPro\Shipping;

/**
 * Class ShippingHelper
 *
 * @since 3.11.4
 */
class Helper {

    /**
     * Checks if the "Mark as Received" feature is enabled for customers.
     *
     * This method verifies whether the shipment tracking and "Mark as Received"
     * features are enabled in the admin settings.
     *
     * @since 3.11.4
     *
     * @return bool True if both shipment tracking and "Mark as Received" features are enabled, false otherwise.
     */
    public static function is_mark_as_received_allowed_for_customers(): bool {
        // Retrieve the shipment tracking and mark as received settings.
        $allow_shipment_tracking = dokan_get_option( 'enabled', 'dokan_shipping_status_setting', 'off' );
        $allow_mark_as_received  = dokan_get_option( 'allow_mark_received', 'dokan_shipping_status_setting', 'off' );

        // Return true if both settings are enabled, otherwise return false.
        return ( $allow_shipment_tracking === 'on' && $allow_mark_as_received === 'on' );
    }

    /**
     * Check shipment complete availability for orders.
     *
     * @since 3.11.4
     *
     * @param \WC_Order $order
     *
     * @return bool
     */
    public static function is_order_fully_shipped( $order ): bool {
        // Check $order is an instance of wc order.
        if ( ! $order instanceof \WC_Order ) {
            return false;
        }

        // Check mark received allow for customers.
        if ( ! self::is_mark_as_received_allowed_for_customers() ) {
            return false;
        }

        // Check the order is fully shipped to customer.
        $is_order_shipped = dokan_pro()->shipment->is_order_shipped( $order );
        if ( ! $is_order_shipped ) {
            return $is_order_shipped;
        }

        $order_id      = $order->get_id();
        $is_available  = true;
        $shipment_info = dokan_pro()->shipment->get_shipping_tracking_info( $order_id );

        // Retrieve the marked received order meta.
        $order_marked_as_received = (array) $order->get_meta( '_dokan_order_marked_received' );

        foreach ( $shipment_info as $shipment ) {
            if ( $shipment->shipping_status === 'ss_cancelled' ) {
                continue;
            }

            if ( ! in_array( (int) $shipment->id, $order_marked_as_received, true ) ) {
                $is_available = false;
                break;
            }
        }

        return $is_available;
    }

    /**
     * Check the order receiving complete from customer.
     *
     * @since 3.11.4
     *
     * @param int $order_id
     * @param int $shipment_id
     *
     * @return bool
     */
    public static function is_order_marked_as_received( $order_id, $shipment_id ) {
        if ( ! $order_id || ! $shipment_id ) {
            return false;
        }

        // Check mark received allow for customers.
        if ( ! self::is_mark_as_received_allowed_for_customers() ) {
            return false;
        }

        $order = dokan()->order->get( $order_id ); // Collect order instance via id.

        // Retrieve the marked received order meta.
        $order_marked_as_received = (array) $order->get_meta( '_dokan_order_marked_received' );

        return in_array( (int) $shipment_id, $order_marked_as_received, true );
    }
}