필터 가이드

대체문구 추가 및 변경 #

1. 문자 및 알림톡 발송 시 대체문구 추가 및 변경 방법 #

   3rd Party 플러그인( 예 : 예약, 이러닝 등 )을 이용하는 경우, 문자 및 알림톡 발송 시 예약 날짜나 이러닝 강좌에 대한 안내등과 같이 대체문구 추가가 필요할 수 있습니다.
   엠샵 문자 알림톡 플러그인에서 제공하는 mssms_get_template_params 필터를 이용하면, 사이트별로 필요한 대체문구의 추가 및 변경이 가능합니다.
   /wp-content/themes/차일드 테마/functions.php 경로에 커스텀 코드를 추가합니다.
   (주의) 본 테마에 적용할 경우, 추후 테마 업데이트 시 작업한 내역이 삭제되므로 차일드 테마에 작업하는 것을 권장드립니다.
   본 테마에 작업하실 경우 테마 업데이트 전 반드시 커스텀 작업 내역을 백업 후 업데이트 해주시기 바랍니다.

   /**
    * @param array    $params
    * @param WC_Order $order
    *
    * @return mixed
    */
   function add_custom_template_params( $params, $order ) {
   	if ( is_a( $order, 'WC_Order' ) ) {
   		/** 원하는 대체 문구를 추가합니다. */
   		$params['예약일자'] = $order->get_meta( '_reserved_date' );
   	}
   
   	return $params;
   }
   
   add_filter( 'mssms_get_template_params', 'add_custom_template_params', 10, 2 );

2. 상품 수량 대체 문구 추가 #

   상품 총 수량에 대한 대체문구를 추가할 수 있습니다.
   /wp-content/themes/차일드 테마/functions.php 경로에 커스텀 코드를 추가합니다.
   (주의) 본 테마에 적용할 경우, 추후 테마 업데이트 시 작업한 내역이 삭제되므로 차일드 테마에 작업하는 것을 권장드립니다.
   본 테마에 작업하실 경우 테마 업데이트 전 반드시 커스텀 작업 내역을 백업 후 업데이트 해주시기 바랍니다.

   function add_quantity_template_params( $params, $order ) {
   
       $product_quantity = 0;
       
       $order_items = $order->get_items();
       foreach ( $order_items as $order_item ) {
           $product_quantity += $order_item->get_quantity();
       }
   
       if ( is_a( $order, 'WC_Order' ) ) {
           $params['상품수량'] = $product_quantity;
       }
   
       return $params;
   }
   
   add_filter( 'mssms_get_template_params', 'add_quantity_template_params', 10, 2 );

   문자 대체 문구 : {상품수량}
   알림톡 대체 문구 : #{상품수량}

3. 포인트 대체 문구 추가 #

   엠샵 포인트 플러그인을 이용하시는 경우, 적립 예정 포인트와 보유 포인트에 대한 대체문구를 추가할 수 있습니다.
   /wp-content/themes/차일드 테마/functions.php 경로에 커스텀 코드를 추가합니다.
   (주의) 본 테마에 적용할 경우, 추후 테마 업데이트 시 작업한 내역이 삭제되므로 차일드 테마에 작업하는 것을 권장드립니다.
   본 테마에 작업하실 경우 테마 업데이트 전 반드시 커스텀 작업 내역을 백업 후 업데이트 해주시기 바랍니다.

   function add_point_template_params( $params, $order ) {
       
       $user       = new MSPS_User( $order->get_user_id(), msps_get_meta( $order, 'wpml_language' ) );
       $earn_point = MSPS_Order::get_earn_point( $order );
   
       if ( is_a( $order, 'WC_Order' ) ) {
           $params['적립예정포인트'] = number_format( floatval( $earn_point ), wc_get_price_decimals() );
           $params['보유포인트'] = number_format( $user->get_point(), wc_get_price_decimals() );
       }
   
       return $params;
   }
   
   add_filter( 'mssms_get_template_params', 'add_point_template_params', 10, 2 );

   문자 대체 문구 : {적립예정포인트} {보유포인트}
   알림톡 대체 문구 : #{적립예정포인트} #{보유포인트}

커스텀 발송 #

/wp-content/themes/차일드 테마/functions.php 경로에 문자 발송 시에는 커스텀 문자 발송을 참고하여 커스텀 코드를 추가하고, 알림톡 발송 시에는 커스텀 알림톡 발송 커스텀 코드를 추가합니다.

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

1. 커스텀 문자 발송 #

   function custom_send_sms() {
       do_action( 'mshop_send_sms', '수신번호', null, '전송할 메시지 내용', 'LMS 문자 제목' );
   }

2. 커스텀 알림톡 발송 (주문 정보를 받아올 때) #

   function cunstom_send_alimtalk( $order_id ) {
       $order         = wc_get_order( $order_id );
       $template_code = '알림톡 템플릿 코드';
       $recipients    = array ( '수신번호' );
       $recipients    = array_filter( array_unique( $recipients ) );
   
       $template_params = MSSMS_Manager::get_template_params( $order );
       $template_params = array_merge( $template_params, array (
               '커스텀파라미터1' => '커스텀대체문구1',
               '커스텀파라미터2' => '커스텀대체문구2',
           )
       );
   
       do_action( 'mssms_send_alimtalk', $template_code, $recipients, $template_params );
   }

3. 커스텀 알림톡 발송 (주문 정보를 받아오지 않을 때) #

   function cunstom_send_alimtalk() {
       $template_code = '알림톡 템플릿 코드';
       $recipients    = array ( '수신번호' );
       $recipients    = array_filter( array_unique( $recipients ) );
   
       $template_params = array (
               '커스텀파라미터1' => '커스텀대체문구1',
               '커스텀파라미터2' => '커스텀대체문구2',
       );
   
       do_action( 'mssms_send_alimtalk', $template_code, $recipients, $template_params );
   }

갱신예정 금액 #

{정기결제권금액} 대체 문구는 기본적으로 정기결제권의 현재 금액을 발송합니다.

정기결제권의 금액 대신 실제 갱신될 금액을 발송하려면 /wp-content/themes/차일드 테마/functions.php 경로에 커스텀 코드를 추가합니다.

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

예를 들어 멤버쉽 정기결제 할인 기능을 이용하실 경우 해당 기능은 주문이 생성되면서 할인이 적용되는 방식으로 안내드리는 필터를 추가해 주셔야 실제 결제될 금액으로 발송됩니다.

add_filter( 'mssms_get_subscription_total_use_renewal_order', '__return_true' );

(참고) 해당 방식은 임시로 주문 대기 상태의 주문을 생성한 후, 해당 주문의 금액을 가져온 다음 임시로 생성한 주문을 삭제하는 방식입니다.