훅을 이용하여 원하는 상황에 맞게 커스텀하여 이용할 수 있습니다.

커스텀 코드를 /wp-content/themes/차일드 테마/functions.php 에 추가하여 이용해 주시기 바랍니다.

(주의) 본 테마에 적용할 경우, 추후 테마 업데이트 시 작업한 내역이 삭제되므로 차일드 테마에 작업하는 것을 권장드립니다.
본 테마에 작업하실 경우 테마 업데이트 전 반드시 커스텀 작업 내역을 백업 후 업데이트 해주시기 바랍니다.

mnp_custom_order_data #

  1. 설명 #

    네이버페이 주문 등록 시 커스텀 정보를 추가할 수 있습니다.
    추가된 커스텀 정보는 네이버페이 주문 완료 후 주문 생성시 주문 메타로 자동 저장됩니다.
    주문 메타에 저장될때 키값은 ‘_’ + 키값으로 저장됩니다. 예를 들어, 커스텀 정보의 키값이 “param1″인 경우, 주문 메타에 저장될때의 키값은 “_param1″으로 저장됩니다.

  2. 사용 방법 #

    add_filter( 'mnp_custom_order_data', 'my_mnp_custom_order_data' );
  3. 예제 #

    add_filter( 'mnp_custom_order_data', 'my_mnp_custom_order_data' );
    
    /**
     * @param array $order_data
     *
     * @return mixed
     */
    function my_mnp_custom_order_data( $order_data ) {
        $order_data['param1'] = 'value1';
    
        return $order_data;
    }

mnp_before_create_npay_order, mnp_after_create_npay_order #

  1. 설명 #

    고객이 네이버페이로 결제시 결제내역이 가맹점에 콜백으로 전달됩니다.
    콜백을 수신한 후 네이버페이 결제건에 대한 우커머스 주문을 생성할때 호출됩니다.

  2. 사용 방법 #

    add_action( 'mnp_before_create_npay_order', 'my_mnp_before_create_npay_order');
    add_action( 'mnp_after_create_npay_order', 'my_mnp_after_create_npay_order', 10, 2);
  3. 예제 #

    add_action( 'mnp_before_create_npay_order', 'my_mnp_before_create_npay_order' );
    
    /**
     * @param array $npay_orders
     */
    function my_mnp_before_create_npay_order( $npay_orders ) {
        /** Do something.... */
    }
    
    add_action( 'mnp_after_create_npay_order', 'my_mnp_after_create_npay_order', 10, 2 );
    
    /**
     * @param WC_Order $order
     * @param array $npay_orders
     */
    function my_mnp_after_create_npay_order( $order, $npay_orders ) {
        if ( $order && ! empty( $npay_orders ) ) {
            $params     = array();
            $npay_order = $npay_orders[0];
            if ( property_exists( $npay_order->ProductOrder, 'MerchantCustomCode2' ) ) {
    
                parse_str( $npay_order->ProductOrder->MerchantCustomCode2, $params );
         
                /** $params 배열에 mnp_custom_order_data 필터로 추가한 값들이 저장됩니다. */
            }
        }
    }

mnp_before_refresh_npay_order, mnp_after_refresh_npay_order #

  1. 설명 #

    우커머스 주문 상세 화면에서 “주문정보 새로고침” 버튼 클릭 시, 네이버페이의 최신 주문 정보를 기반으로 우커머스 주문을 갱신합니다.
    주문 정보를 갱신할 때 호출됩니다.

  2. 사용 방법 #

    add_action( 'mnp_before_refresh_npay_order', 'my_mnp_before_refresh_npay_order');
    add_action( 'mnp_after_refresh_npay_order', 'my_mnp_after_refresh_npay_order', 10, 2);
  3. 예제 #

    add_action( 'mnp_before_refresh_npay_order', 'my_mnp_before_refresh_npay_order' );
    
    /**
     * @param WC_Order $order
     */
    function my_mnp_before_create_npay_order( $order ) {
        /** Do something.... */
    }
    
    add_action( 'mnp_after_refresh_npay_order', 'my_mnp_after_refresh_npay_order', 10, 2 );
    
    /**
     * @param WC_Order $order
     * @param array $npay_orders
     */
    function my_mnp_after_create_npay_order( $order, $npay_orders ) {
    if ( $order && ! empty( $npay_orders ) ) {
            $params     = array();
            $npay_order = $npay_orders[0];
            if ( property_exists( $npay_order->ProductOrder, 'MerchantCustomCode2' ) ) {
    
                parse_str( $npay_order->ProductOrder->MerchantCustomCode2, $params );
         
                /** $params 배열에 mnp_custom_order_data 필터로 추가한 값들이 저장됩니다. */
            }
        }
    }

mnp_before_checkout_cart, mnp_after_checkout_cart #

  1. 설명 #

    장바구니 화면에서 네이버페이 구매 버튼 클릭 시 호출됩니다.
    장바구니 아이템에 대한 검증 및 추가 처리가 필요한 경우 이용할 수 있습니다.

  2. 사용 방법 #

    add_action( 'mnp_before_checkout_cart', 'my_mnp_before_checkout_cart');
    add_action( 'mnp_after_checkout_cart', 'my_mnp_after_checkout_cart');
  3. 예제 #

    add_action( 'mnp_before_checkout_cart', 'my_mnp_before_checkout_cart' );
    
    function my_mnp_before_checkout_cart() {
        $cart_items = WC()->cart->get_cart();
        /** Do something.... */
    }
    
    add_action( 'mnp_after_checkout_cart', 'my_mnp_after_checkout_cart' );
    
    function my_mnp_after_checkout_cart() {
        $cart_items = WC()->cart->get_cart();
        /** Do something.... */
    }

mnp_order_status_for_processing #

  1. 설명 #

    네이버페이에서 결제 후 주문 상태를 변경할 수 있습니다.

  2. 사용 방법 #

    add_filter( 'mnp_order_status_for_processing', 'change_mnp_order_status_for_processing', 10, 2 );
  3. 예제 #

    function change_mnp_order_status_for_processing( $order_status, $order ) {
        // 변경할 주문상태를 지정합니다.
        return 'order-received';
    }
    
    add_filter( 'mnp_order_status_for_processing', 'change_mnp_order_status_for_processing', 10, 2 );