Add a selectable delivery slot field

This adds an order meta field to the admin field registry, then adds it to the payload when that field is enabled.

add_filter( 'psfw_print_field_registry', function ( $registry ) {
    $registry['delivery'] = [
        'label'  => __( 'Delivery', 'my-plugin' ),
        'fields' => [
            'delivery_slot' => __( 'Delivery Slot', 'my-plugin' ),
        ],
    ];

    return $registry;
} );

add_filter( 'psfw_print_payload', function ( $payload, $order, $context ) {
    if ( empty( $context['enabled_fields'] ) || ! in_array( 'delivery_slot', $context['enabled_fields'], true ) ) {
        return $payload;
    }

    $slot = $order->get_meta( '_delivery_slot' );
    if ( '' === $slot ) {
        return $payload;
    }

    $payload['delivery_slot'] = $slot;
    $payload['_sections'][] = [
        'key'    => 'delivery',
        'label'  => __( 'Delivery', 'my-plugin' ),
        'fields' => [
            [
                'key'   => 'delivery_slot',
                'label' => __( 'Delivery Slot', 'my-plugin' ),
                'value' => $slot,
            ],
        ],
    ];

    return $payload;
}, 10, 3 );

Add a receipt heading and thanks message to prints

This prepends a receipt-style section to the Android print payload. It is useful when the printed order list is included with a packed order or customer collection bag.

add_filter( 'psfw_print_payload', function ( $payload, $order, $context ) {
    if ( empty( $payload['_sections'] ) || ! is_array( $payload['_sections'] ) ) {
        $payload['_sections'] = [];
    }

    array_unshift( $payload['_sections'], [
        'key'    => 'receipt',
        'label'  => __( 'Receipt', 'my-plugin' ),
        'fields' => [
            [
                'key'   => 'receipt_message',
                'label' => __( 'Message', 'my-plugin' ),
                'value' => __( 'Received with thanks.', 'my-plugin' ),
            ],
            [
                'key'   => 'payment_status',
                'label' => __( 'Payment', 'my-plugin' ),
                'value' => $order->is_paid() ? __( 'Paid', 'my-plugin' ) : __( 'Payment pending', 'my-plugin' ),
            ],
        ],
    ] );

    return $payload;
}, 10, 3 );

Limit the feed to collection orders

add_filter( 'psfw_order_feed_query_args', function ( $args, $context ) {
    $args['meta_query'][] = [
        'key'   => '_order_type',
        'value' => 'collection',
    ];

    return $args;
}, 10, 2 );

Notify another system when staff complete an order

add_action( 'psfw_after_order_status_update', function ( $order_id, $old_status, $new_status, $user_id ) {
    if ( 'completed' !== $new_status ) {
        return;
    }

    // Send a webhook, write an audit log, or notify a fulfilment system.
}, 10, 4 );

Restrict Stock Control to managers

This keeps the order feed available to Packing Station staff, but limits the stock screen to users who can manage WooCommerce.

add_filter( 'psfw_user_can_access', function ( $allowed, $user_id, $area ) {
    if ( 'stock_control' !== $area ) {
        return $allowed;
    }

    return user_can( $user_id, 'manage_woocommerce' );
}, 10, 3 );

Block completion for unpaid orders

This prevents staff from marking an order complete from Packing Station if WooCommerce still considers the order unpaid.

add_filter( 'psfw_order_status_update_allowed', function ( $allowed, $order, $new_status, $user_id ) {
    if ( 'completed' !== $new_status ) {
        return $allowed;
    }

    if ( $order->needs_payment() ) {
        return false;
    }

    return $allowed;
}, 10, 4 );

Add a large-order flag to the feed and print payload

This adds a simple operational flag when an order contains ten or more total items.

add_filter( 'psfw_order_feed_order_data', function ( $payload, $order, $context ) {
    $item_count = 0;

    foreach ( $order->get_items() as $item ) {
        $item_count += (int) $item->get_quantity();
    }

    if ( $item_count >= 10 ) {
        $payload['large_order'] = true;
        $payload['_sections'][] = [
            'key'    => 'operations',
            'label'  => __( 'Operations', 'my-plugin' ),
            'fields' => [
                [
                    'key'   => 'large_order',
                    'label' => __( 'Large Order', 'my-plugin' ),
                    'value' => __( 'Check packing capacity', 'my-plugin' ),
                ],
            ],
        ];
    }

    return $payload;
}, 10, 3 );

Log stock changes made from Stock Control

This writes a WooCommerce log entry whenever staff change product stock status from the Packing Station screen.

add_action( 'psfw_after_stock_status_update', function ( $product_id, $new_status, $user_id, $old_status ) {
    if ( $new_status === $old_status ) {
        return;
    }

    wc_get_logger()->info(
        sprintf(
            'Packing Station stock change: product %d changed from %s to %s by user %d.',
            $product_id,
            $old_status,
            $new_status,
            $user_id
        ),
        [ 'source' => 'packing-station' ]
    );
}, 10, 4 );

Use a shorter date format on order cards

This changes the compact date shown in card-style order data without changing the full date value.

add_filter( 'psfw_order_card_datetime_format', function ( $format ) {
    return 'd M, H:i';
} );

Add a small front-end config value

This exposes a custom station label through PSCFG.stationName for site-specific JavaScript or App-aware customisations.

add_filter( 'psfw_companion_app_config', function ( $config, $context ) {
    if ( ! empty( $context['is_order_feed'] ) ) {
        $config['stationName'] = 'Kitchen pass';
    }

    return $config;
}, 10, 2 );