워드프레스 개발자에게 필요한 WooCommerce 코드 조각

기반 쇼핑몰을 구축한다면 워드프레스WooCommerce는 훌륭한 기본 틀을 제공하지만, 진정한 제어는 스마트 스니펫에서 나옵니다. 작은 코드 조각들을 활용하면 무거운 플러그인 없이도 쇼핑 페이지, 결제 페이지, 심지어 제품 동작의 세부적인 부분까지 원하는 대로 설정할 수 있습니다. PHP 파일에 스니펫을 직접 추가하거나, 자식 테마하거나, 보다 안전하고 시각적인 워크플로우를 위해 코드 스니펫 플러그인을 설치할 수도 있습니다. 많은 개발자들이 Code Snippets 또는 Code Snippets Pro를 선호하는데, 테마 파일을 건드리지 않고도 규칙을 활성화, 비활성화, 내보낼 수 있기 때문입니다. 이를 통해 소스 코드를 깔끔하게 유지하고 새로운 프로젝트에서 자동으로 가져오기도 간편해집니다.

스니펫을 사용하면 상점 페이지 제목 변경, WooCommerce 탐색 경로, 결제 필드 수정 등 일반적인 작업을 간편하게 처리할 수 있습니다. 사용자 정의 필드를 , 장바구니 버튼 텍스트를 변경하거나, 최소 주문 금액을 설정할 수도 있습니다. WooCommerce 설정을 세밀하게 조정하고, WooCommerce 지원을 , 제품 갤러리 확대/축소, 라이트박스, 슬라이더 기능을 몇 분 만에 활성화할 수 있습니다.

또한, 사용자 지정 통화를 추가하거나, 제품 탭 이름을 '자세히 보기'로 변경하거나, 위젯에서 제품 카테고리를 숨길 수도 있습니다. 간단한 함수를 붙여넣든, 점점 늘어나는 사용자 지정 코드 라이브러리를 유지 관리하든, 이러한 실용적인 코드 조각들은 불필요한 기능 없이 깔끔한 기능을 제공하며, 제대로 테스트하면 대부분의 빌드에서 문제없이 작동합니다.

WooCommerce 코드 조각을 안전하게 사용하는 방법

에 사용자 정의 스니펫을 추가하면 WooCommerce WordPress 사이트의 작동 방식이 완전히 바뀔 수 있습니다. 하지만 functions.php 파일에 잘못된 코드를 붙여넣거나 PHP 함수에서 실수를 하면 사이트 전체가 제대로 작동하지 않을 수 있습니다. 따라서 사용자 정의 코드를 다룰 때는 안전 수칙을 준수하는 것이 중요합니다.

차일드 테마 또는 스니펫 플러그인을 사용하세요

• 테마 업데이트 후에도 코드가 그대로 유지되도록 사용자 정의 코드를 자식 테마의 functions.php 파일 안에 넣어주세요.
• 테마 파일을 직접 편집하고 싶지 않다면 코드 스니펫 플러그인 또는 코드 스니펫 프로를 설치하세요.
• 이러한 도구를 사용하면 테마 파일을 건드리지 않고도 코드 조각을 생성, 관리 및 내보낼 수 있습니다.
• 플러그인에는 자동 가져오기 옵션도 포함되어 있어 여러 웹사이트에서 사용자 지정 코드 조각을 더 쉽게 재사용할 수 있습니다.

실제 서비스 출시 전 테스트

• 운영 중인 사이트에 코드를 직접 붙여넣지 마세요.
• 항상 스테이징 환경.
• 이 단계를 통해 WooCommerce 설정, 결제 필드 또는 기타 테마 파일과의 충돌이 발생하지 않도록 합니다.

사용자 지정 코드에 대한 문서를 작성하세요

• 추가하세요 명확하게 설명하는 주석을 각 함수 위에 해당 함수의 기능을
• 예: 결제 페이지, 상점 페이지, WooCommerce 제품 카테고리 또는 계정 결제 필드에 영향을 미치는지 여부.
• 적절한 레이블링을 하면 나중에 소스 코드를 더 쉽게 이해할 수 있습니다.

백업 및 버전 관리를 유지하세요

• 외부에서 코드 조각을 저장하세요 Git 이나 다른 버전 관리 도구를
• 코드 스니펫 플러그인을 사용한다면 내보내기 기능을 활용하세요.
• 백업을 해두면 업데이트 후 문제가 발생할 경우 신속하게 이전 버전으로 되돌릴 수 있습니다.

코드 스니펫은 제대로 활용하면 강력한 도구 모음이 됩니다. 스니펫을 사용하면 WooCommerce를 맞춤 설정할 , 모든 것을 깔끔하고 안정적으로 유지할 수 있습니다.

테마 및 UX 설정 필수 요소: WooCommerce 코드 스니펫

고급 코드 조각을 살펴보기 전에 WooCommerce 지원을 설정하고 테마를 정리하여 더욱 원활한 쇼핑 경험을 제공하는 것이 좋습니다. 많은 개발자들이 이러한 기본 사항을 간과하지만, 이를 통해 쇼핑몰의 외관과 사용자 경험을 크게 개선할 수 있습니다.

테마에 WooCommerce 지원을 선언하세요

기본적으로 모든 WordPress 테마에 WooCommerce 완벽 지원 기능이 포함되어 있는 것은 아닙니다. 제품 갤러리와 레이아웃이 올바르게 표시되도록 하려면 WooCommerce를 수동으로 추가해야 합니다. 이 작업은 자식 테마의 functions.php 파일 사용하여 사용자 정의 코드 조각 플러그인을.

function mytheme_add_woocommerce_support() { add_theme_support( 'woocommerce' ); add_theme_support( 'wc-product-gallery-zoom' ); add_theme_support( 'wc-product-gallery-lightbox' ); add_theme_support( 'wc-product-gallery-slider' ); } add_action( 'after_setup_theme', 'mytheme_add_woocommerce_support' );

이 코드 조각은 핵심 WooCommerce 지원 기능과 함께 wc product gallery zoom, wc product gallery lightbox, wc product gallery slider 기능을. 이러한 기능들을 통해 단일 상품 페이지에서 상품을 더 편리하게 탐색할 수 있습니다.

WooCommerce 탐색 경로 제거

탐색 경로는 유용하지만 때로는 디자인을 복잡하게 만들 수 있습니다. 테마에 이미 탐색 경로가 포함되어 있거나 더 깔끔한 헤더를 선호하는 경우 다음 코드 조각을 사용하여 WooCommerce 탐색 경로를 제거할 수 있습니다

add_action( 'init', 'remove_wc_breadcrumbs' ); function remove_wc_breadcrumbs() { remove_action( 'woocommerce_before_main_content', 'woocommerce_breadcrumb', 20, 0 ); }

에 의존하므로 이 기능을 주의해서 사용하세요 SEO 가치를 위해 브레드크럼 . 다른 내비게이션 스타일로 교체하는 경우 브레드크럼을 제거하면 디자인이 더 단순해질 수 있습니다.

상점 페이지 제목을 변경하세요

기본 쇼핑 페이지 제목은 대개 "쇼핑하기"로만 표시됩니다. 브랜드 이미지나 시즌별 캠페인에 맞춰 제목을 사용자 지정 텍스트로 변경할 수 있습니다.

add_filter( 'woocommerce_page_title', 'shop_page_title' ); function shop_page_title( $title ) { if ( is_shop() ) { return "컬렉션"; } return $title; }

변경할 수 있습니다 쇼핑 페이지 제목을 상품 카테고리, 캠페인 또는 브랜드 슬로건에 맞춰

검색 결과 향상을 위한 카탈로그 최적화

기본 설정이 완료되면 다음 단계는 WooCommerce 카탈로그를 세부적으로 조정하는 것입니다. 이러한 코드 조각을 사용하면 WordPress 사이트에서 제품과 카테고리가 표시되는 방식을 제어하여 고객이 복잡하거나 혼란스럽지 않게 원하는 제품을 더 쉽게 찾을 수 있도록 할 수 있습니다.

기본 카탈로그 정렬 방식을 변경하세요

WooCommerce는 기본적으로 상품을 알파벳순 또는 메뉴 순서대로 정렬합니다. 최신 상품을 먼저 표시하거나 가격순으로 정렬하도록 설정을 변경할 수 있습니다. 이 작은 변경만으로도 신규 상품이나 가성비 좋은 상품을 더욱 눈에 띄게 보여줄 수 있습니다.

add_filter( 'woocommerce_default_catalog_orderby', 'custom_default_catalog_orderby' ); function custom_default_catalog_orderby() { return 'date'; // 옵션: 'date', 'price', 'title' }

이렇게 하면 쇼핑객들이 쇼핑 페이지 상단에서 최신 제품을 바로 볼 수 있습니다.

페이지당 제품 개수를 조정하세요

페이지당 상품 수가 너무 많으면 쇼핑객에게 부담을 줄 수 있고, 너무 적으면 끝없는 클릭으로 짜증을 유발할 수 있습니다. 상품 수를 조절하는 방법은 다음과 같습니다

add_filter( 'loop_shop_per_page', 'new_loop_shop_per_page', 20 ); function new_loop_shop_per_page( $cols ) { $cols = 12; // 필요에 따라 이 숫자를 조정하세요. return $cols; }

이 값을 조정하면 사이트 속도 와 사용자 경험 간의 균형을 맞출 수 있습니다.

아카이브에서 카테고리 또는 제품 숨기기

특정 상품 카테고리가 쇼핑 페이지에 표시되지 않도록 하고 싶을 때가 있습니다. 계절 상품, 도매 전용 상품 또는 테스트 카테고리는 간단한 코드 조각을 사용하여 제외할 수 있습니다.

add_action( 'pre_get_posts', 'remove_categories_shop' ); function remove_categories_shop( $q ) { if ( ! $q->is_main_query() || ! $q->is_post_type_archive() ) return; if ( ! is_admin() && is_shop() ) { $q->set( 'tax_query', array(array( 'taxonomy' => 'product_cat', 'field' => 'slug', 'terms' => array( 'wholesale', 'seasonal' ), 'operator' => 'NOT IN' ))); } }

이렇게 하면 고객에게 보여주고 싶은 제품만 표시하여 카탈로그를 깔끔하게 유지할 수 있습니다.

제품 카테고리 위젯에서 특정 카테고리를 제외합니다

사용하는 경우 WooCommerce 제품 카테고리 모든 제품이 표시되지. 다음과 같이 특정 카테고리를 제외할 수 있습니다.

add_filter( 'woocommerce_product_categories_widget_args', 'woo_product_cat_widget_args' ); function woo_product_cat_widget_args( $cat_args ) { $cat_args['exclude'] = array( 25 ); // 25를 해당 카테고리 ID로 대체하세요. return $cat_args; }

이 코드 조각을 사용하면 제품 검색을 더욱 효과적으로 제어하고 고객의 관심을 가장 수익성이 높은 카테고리로 유도할 수 있습니다.

제품 페이지 개선으로 전환율 향상: WooCommerce 코드 스니펫

단일 상품 페이지는 구매자가 구매 여부를 결정하는 곳입니다. 몇 가지 WooCommerce 코드 조각을 활용하면 레이아웃을 간소화하고 혼란을 줄이며 가장 중요한 세부 정보를 강조할 수 있습니다.

제품 탭 이름 변경 또는 삭제

WooCommerce의 "설명"이나 "추가 정보"와 같은 제품 탭은 스토어의 분위기와 항상 잘 어울리지 않을 수 있습니다. 이러한 탭의 이름을 바꾸거나 불필요한 탭을 완전히 삭제할 수 있습니다.

add_filter( 'woocommerce_product_tabs', 'woo_rename_tab', 98 ); function woo_rename_tab( $tabs ) { $tabs['description']['title'] = '자세한 정보'; return $tabs; }

삭제할 수도 있습니다 추가 정보 탭이 불필요하다고 생각되면

add_filter( 'woocommerce_product_tabs', 'remove_product_tabs', 98 ); function remove_product_tabs( $tabs ) { unset( $tabs['additional_information'] ); return $tabs; }

"품절"이라는 문구를 더 친절한 문구로 바꾸세요

기본 "품절" 표시는 고객을 멀어지게 할 수 있습니다. "판매 완료" 또는 "출시 예정"과 같은 부드러운 접근 방식을 사용하면 관심을 유지할 수 있습니다.

add_filter( 'woocommerce_get_availability', 'availability_filter_func' ); function availability_filter_func( $availability ) { $availability['availability'] = str_ireplace( '재고 없음', '판매 완료', $availability['availability'] ); return $availability; }

이 작은 변화만으로도 추가 플러그인 없이 고객 경험을 개선할 수 있습니다.

"장바구니에 담기" 대신 "이미 장바구니에 담았습니다"를 표시합니다

쇼핑객이 이미 상품을 장바구니에 담았을 경우, 동일한 " 장바구니에 담기 " 버튼이 표시되면 혼란스러울 수 있습니다. 이 코드 조각은 해당 버튼을 "이미 장바구니에 담았습니다"로 대체합니다.

add_filter( 'woocommerce_product_single_add_to_cart_text', 'woo_custom_cart_button_text' ); function woo_custom_cart_button_text() { global $woocommerce; foreach( $woocommerce->cart->get_cart() as $cart_item ) { if( get_the_ID() == $cart_item['product_id'] ) { return __( '이미 장바구니에 있습니다', 'woocommerce' ); } } return __( '장바구니에 추가', 'woocommerce' ); }

이를 통해 명확한 피드백을 제공하고 쇼핑 과정을 더욱 원활하게 만들 수 있습니다.

가변 상품 가격 책정을 간소화하세요

WooCommerce에서는 일반적으로 가변 상품의 가격을 $100~$200와 같은 범위로 표시합니다. 하지만 "최저가"와 함께 최소 가격만 표시하려면 다음 코드 조각을 사용하세요

add_filter( 'woocommerce_variable_price_html', 'variation_price_format_min', 9999, 2 ); function variation_price_format_min( $price, $product ) { $prices = $product->get_variation_prices( true ); $min_price = current( $prices['price'] ); return sprintf( __( 'From %1$s', 'woocommerce' ), wc_price( $min_price ) ); }

이렇게 하면 기대치가 더 명확해지고 클릭 수를 늘릴 수 있습니다.

장바구니 및 결제 과정 개선으로 불편함을 줄이는 WooCommerce 코드 스니펫

장바구니와 결제 과정에서 작은 개선만으로도 전환율을 빠르게 높일 수 있습니다. 이러한 코드 조각은 단계를 간소화하고, 양식을 깔끔하게 정리하며, 쇼핑객이 집중할 수 있도록 도와줍니다.

장바구니 담기 후 결제 페이지로 리디렉션

단일 제품 판매 유입 경로 또는 속도가 중요한 플래시 세일에 사용하세요. 자식 테마의 functions.php 파일이나 스니펫 플러그인에 추가하면 됩니다.

add_filter( 'woocommerce_add_to_cart_redirect', 'seahawk_redirect_to_checkout' ); function seahawk_redirect_to_checkout( $url ) { return wc_get_checkout_url(); }

결제 시 이메일을 맨 앞에 입력하세요

복구 절차 및 지원을 위해 이메일 주소를 조기에 수집하십시오. 이메일 주소가 적을수록 우선순위가 높습니다.

add_filter( 'woocommerce_checkout_fields', 'seahawk_email_first' ); function seahawk_email_first( $fields ) { if ( isset( $fields['billing']['billing_email'] ) ) { $fields['billing']['billing_email']['priority'] = 4; } return $fields; }

시장 상황에 따라 휴대전화를 선택 사항 또는 필수 사항으로 설정하세요

각 지역의 규정 준수 및 지원 요구 사항을 충족하십시오.

add_filter( 'woocommerce_billing_fields', 'seahawk_phone_requirement' ); function seahawk_phone_requirement( $address_fields ) { // 마켓플레이스에서 전화번호가 필수인 경우 true로 설정 $address_fields['billing_phone']['required'] = false; return $address_fields; }

결제 필드 재정렬 또는 정리

양식은 간결하고 논리적으로 작성하세요. 예시: 이름과 성을 위쪽으로 옮기세요.

add_filter( 'woocommerce_checkout_fields', 'seahawk_reorder_fields' ); function seahawk_reorder_fields( $fields ) { if ( isset( $fields['billing']['billing_first_name'] ) ) { $fields['billing']['billing_first_name']['priority'] = 6; } if ( isset( $fields['billing']['billing_last_name']['priority'] = 8; } return $fields; }

약관 위에 사용자 지정 체크박스 추가

동의 또는 추가 확인 용도로 사용하세요. 유효성 검사 기능이 포함되어 있습니다.

add_action( 'woocommerce_checkout_before_terms_and_conditions', 'seahawk_checkout_checkboxes' ); function seahawk_checkout_checkboxes() { ?><p class="form-row custom-checkboxes"> <label class="woocommerce-form__label checkbox"><input type="checkbox" class="woocommerce-form__input input-checkbox" name="seahawk_consent_one"><span>주문 업데이트를 이메일로 받는 데 동의합니다</span> <span class="required">.</span></label> <label class="woocommerce-form__label checkbox"><input type="checkbox" class="woocommerce-form__input input-checkbox" name="seahawk_consent_two"><span>배송 주소가 정확한지 확인합니다</span> <span class="required">.</span></label></p>

제한 주문서 문자

업무 처리팀이 읽을 수 있도록 메모를 보기 쉽게 작성하세요.

add_filter( 'woocommerce_checkout_fields', 'seahawk_limit_order_notes' ); function seahawk_limit_order_notes( $fields ) { if ( isset( $fields['order']['order_comments'] ) ) { $fields['order']['order_comments']['maxlength'] = 180; $fields['order']['order_comments']['placeholder'] = __( '간단한 배송 메모를 추가하세요. 최대 180자입니다.' ); } return $fields; }

국가별 배송 안내를 표시합니다

특정 국가가 선택되었을 때 동적인 메시지를 표시합니다.

add_action( 'woocommerce_before_checkout_billing_form', 'seahawk_country_notice_container' ); function seahawk_country_notice_container() { echo '<div class="shipping-notice woocommerce-info" style="display:none"> 주문 처리 후 배송까지 영업일 기준 5~10일이 소요될 수 있습니다.</div> '; } add_action( 'woocommerce_after_checkout_form', 'seahawk_country_notice_script' ); function seahawk_country_notice_script() { ?><script> document.addEventListener('DOMContentLoaded', function() { var selectEl = document.querySelector('select#billing_country'); var noticeEl = document.querySelector('.shipping-notice'); var targetCountry = 'FR'; if (!selectEl || !noticeEl) return; function toggleNotice() { if (selectEl.value === targetCountry) { noticeEl.style.display = 'block'; } else { noticeEl.style.display = 'none'; } } toggleNotice(); selectEl.addEventListener('change', toggleNotice); }); </script>

결제 페이지에서 자동 포커스 필드 변경

더 빠른 입력을 위해 이메일 입력란부터 먼저 입력하세요.

`add_filter( 'woocommerce_checkout_fields', 'seahawk_change_autofocus' );` `function seahawk_change_autofocus( $fields ) { if ( isset( $fields['billing']['billing_first_name'] ) ) { $fields['billing']['billing_first_name']['autofocus'] = false; } if ( isset( $fields['billing']['billing_email'] ) ) { $fields['billing']['billing_email']['autofocus'] = true; } return $fields; }`

주문하기 버튼 근처에 유용한 안내 문구를 추가하세요

개인 정보 보호 메모 또는 배송 알림에 사용하세요.

add_action( 'woocommerce_review_order_after_submit', 'seahawk_message_below_checkout_button' ); function seahawk_message_below_checkout_button() { echo '<p> <small>이 주문을 진행함으로써 귀하는 제공된 정보가 정확함을 확인합니다.</small></p> '; }

예외적인 상황을 리디렉션하고 더 일찍 유효성을 검사합니다

결제 전에 신호를 깨끗하게 유지하세요. 예시 ⟶ 계정 생성 필드를 필수로 설정하세요.

`add_filter( 'woocommerce_checkout_fields', 'seahawk_require_account_fields' );` 함수 `seahawk_require_account_fields( $fields ) { if ( isset( $fields['account']['account_username'] ) ) { $fields['account']['account_username']['required'] = true; } if ( isset( $fields['account']['account_password'] ) ) { $fields['account']['account_password']['required'] = true; } if ( isset( $fields['account']['account_password-2'] ) ) { $fields['account']['account_password-2']['required'] = true; } return $fields; }`

스마트한 배송 로직: WooCommerce 코드 스니펫

스마트 배송 규칙을 활용하면 선택의 폭이 넓어지고 비용을 예측할 수 있습니다. 이러한 간단한 규칙은 현지 픽업과 같은 유용한 옵션을 숨기지 않으면서도 결정을 간소화합니다.

무료 배송이 가능한 경우 유료 결제 수단을 숨기세요

무료 배송이 적용되는 경우에만 표시하고, 무료 배송이 불가능한 경우에는 배송비를 표시하세요.

add_filter( 'woocommerce_package_rates', 'seahawk_only_free_shipping_when_available', 10, 2 ); function seahawk_only_free_shipping_when_available( $rates, $package ) { $new_rates = array(); foreach ( $rates as $rate_id => $rate ) { if ( 'free_shipping' === $rate->method_id ) { $new_rates[ $rate_id ] = $rate; break; } } if ( ! empty( $new_rates ) ) { // 현지 픽업이 있는 경우 유지 foreach ( $rates as $rate_id => $rate ) { if ( 'local_pickup' === $rate->method_id ) { $new_rates[ $rate_id ] = $rate; break; } } return $new_rates; } return $rates; }

이것이 도움이 되는 이유

• 무료 배송 조건 충족 시 발생하는 결정 피로감을 줄여줍니다.
• 유지합니다 매장 픽업 서비스를 선호하는 고객을 위해
• 가격에 민감한 주문의 장바구니 포기율을 줄입니다.

간단한 무료 배송 기준 메시지를 추가하세요

소계 계산 방식을 사용하는 경우, 쇼핑객들이 얼마 남았는지 알 수 있도록 친절한 안내를 표시하세요.

add_action( 'woocommerce_before_cart', 'seahawk_free_shipping_threshold_notice' ); add_action( 'woocommerce_before_checkout_form', 'seahawk_free_shipping_threshold_notice' ); function seahawk_free_shipping_threshold_notice() { $threshold = 75; // 무료 배송 기준 금액 설정 $subtotal = WC()->cart ? WC()->cart->get_displayed_subtotal() : 0; if ( $subtotal && $subtotal < $threshold ) { $remaining = wc_price( $threshold - $subtotal ); wc_print_notice( '무료 배송을 받으려면 ' . $remaining . '만큼 더 구매하세요.', '알림' ); } }

팁

• 메시지의 정확성을 유지하려면 이 임계값을 WooCommerce 설정과 일치시키세요.
• 쿠폰과 세금을 적용하여 계산 결과가 정책을 정확하게 반영하는지 확인하십시오.

가격 및 통화 제어: WooCommerce 코드 조각

깔끔한 가격 책정은 신뢰를 구축합니다. 이 코드 조각은 지역 통화 지원을 추가하고 스토어 전체에서 가격이 보기 좋게 표시되도록 도와줍니다.

사용자 지정 통화 및 기호 추가

지역 브랜드나 테스트 스토어에 유용합니다. 자식 테마의 functions.php 파일이나 스니펫 플러그인에 추가하세요.

// 사용자 지정 통화 코드 등록 add_filter( 'woocommerce_currencies', 'seahawk_add_currency' ); function seahawk_add_currency( $currencies ) { $currencies['ABC'] = __( '샘플 통화', 'woocommerce' ); // ABC를 이름으로 바꾸세요. return $currencies; } // 사용자 지정 통화에 기호 추가 add_filter( 'woocommerce_currency_symbol', 'seahawk_add_currency_symbol', 10, 2 ); function seahawk_add_currency_symbol( $symbol, $currency ) { if ( 'ABC' === $currency ) { $symbol = '¤'; // 기호로 바꾸세요. } return $symbol; }

어디에 사용하나요?

• WooCommerce 설정 ⟶ 일반 ⟶ 통화 옵션.
• 코드를 추가한 후 새 통화를 선택하세요.

불필요한 가격 0을 제거하세요

깔끔한 가격 표시 방식은 가독성을 향상시킵니다.

add_filter( 'woocommerce_price_trim_zeros', '__return_true' );

이 제품의 기능은 무엇인가요?

• 19.00 대신 19가 표시됩니다.
• 필요한 경우에만 소수점을 유지합니다.

선택 사항 ⟶ 지역별 가격 형식 제어

특정 시장에 따라 천 단위 구분 기호와 소수점 구분 기호를 변경하세요.

add_filter( 'wc_price_args', 'seahawk_price_args_by_locale' ); function seahawk_price_args_by_locale( $args ) { // EU 스타일 예시 if ( is_user_logged_in() && function_exists( 'get_user_locale' ) && 'fr_FR' === get_user_locale() ) { $args['decimal_separator'] = ','; $args['thousand_separator'] = ' '; } return $args; }

결제, 이메일 및 주문 처리: WooCommerce 코드 스니펫

몇 가지 유용한 스니펫을 활용하여 소통과 관리를 강화하세요. 이러한 스니펫은 팀원들이 주요 업데이트를 확인하고, 이메일에 주문 데이터를 추가하고, 점검 중에는 결제를 일시 중지하고, 위험한 주문을 차단하는 데 도움이 됩니다.

주문 완료 알림을 받을 이메일 수신자를 추가하세요

주문이 완료되면 지원팀이나 회계팀에 알려주세요.

add_filter( 'woocommerce_email_recipient_customer_completed_order', 'seahawk_extra_completed_order_recipient', 10, 2 ); function seahawk_extra_completed_order_recipient( $recipient, $order ) { $extra = 'ops@example.com'; // 실제 주소로 교체하세요 if ( $recipient && strpos( $recipient, $extra ) === false ) { $recipient .= ', ' . $extra; } return $recipient; }

팁

• 숨은 참조(BCC)를 추가하려면 woocommerce_email_headers를 연동하여 BCC 헤더를 추가하세요.

주문 내역 이메일을 사용자 지정 주문 메타 정보로 추가하기

고객 이메일에 추적 코드 또는 저장된 사용자 지정 필드를 표시합니다.

// 1) 데모 목적으로 사용자 지정 주문 메타 필드를 저장합니다. add_action( 'woocommerce_checkout_update_order_meta', 'seahawk_save_tracking_meta' ); function seahawk_save_tracking_meta( $order_id ) { // 실제 추적 값을 저장하는 로직으로 대체하세요. if ( ! metadata_exists( 'post', $order_id, '_tracking_code' ) ) { update_post_meta( $order_id, '_tracking_code', 'ABC123' ); } } // 2) 해당 메타 정보를 이메일에 삽입합니다. add_filter( 'woocommerce_email_order_meta_fields', 'seahawk_add_tracking_to_emails', 10, 3 ); function seahawk_add_tracking_to_emails( $fields, $sent_to_admin, $order ) { $tracking = $order->get_meta( '_tracking_code' ); if ( $tracking ) { $fields['tracking_code'] = array( 'label' => __( 'Tracking Code', 'woocommerce' ), 'value' => esc_html( $tracking ), ); } return $fields; }

보이는 곳

• 고객 주문 처리
• 고객님께서 주문을 완료하셨습니다
• 관리자 새 주문

주문 건이 있는 경우 결제를 거부합니다

사기 방지 또는 특정 워크플로에 유용합니다. 일치하는 고객 이메일 주소에 미결제 주문이 있는 경우 결제를 차단합니다.

add_action( 'woocommerce_after_checkout_validation', 'seahawk_block_when_pending_orders', 10, 2 ); function seahawk_block_when_pending_orders( $data, $errors ) { if ( is_user_logged_in() ) { $customer_id = get_current_user_id(); $args = array( 'type' => 'shop_order', 'status' => array( 'wc-pending' ), 'limit' => 1, 'customer_id' => $customer_id, 'return' => 'ids', ); $pending = wc_get_orders( $args ); if ( ! empty( $pending ) ) { $errors->add( 'seahawk_pending_block', __( '주문이 보류 중입니다. 새 주문을 하기 전에 결제를 완료하거나 취소해 주세요.' ) ); } return; } // 게스트 체크아웃 ⟶ 청구 이메일 일치 $email = isset( $data['billing_email'] ) ? sanitize_email( $data['billing_email'] ) : ''; if ( $email ) { $args = array( 'type' => 'shop_order', 'status' => array( 'wc-pending' ), 'limit' => 1, 'billing_email' => $email, 'return' => 'ids', ); $pending = wc_get_orders( $args ); if ( ! empty( $pending ) ) { $errors->add( 'seahawk_pending_block_guest', __( '미처리 주문이 있습니다. 새 주문을 하기 전에 결제를 완료하거나 취소해 주세요.' ) ); } } }

메모

• 지원 워크플로에 맞게 메시지를 수정하세요.
• 필요한 경우 현금 결제 또는 계좌 이체를 통한 결제를 허용하는 것을 고려해 보세요.

휴가 모드 또는 일시 중지 모드를 활성화하세요

장바구니와 결제 기능을 비활성화하면서도 카탈로그는 계속 표시할 수 있습니다. 재고 관리 기간이나 재고 감사에 적합합니다.

add_action( 'init', 'seahawk_holiday_mode' ); function seahawk_holiday_mode() { if ( ! apply_filters( 'seahawk_holiday_mode_enabled', false ) ) { return; } remove_action( 'woocommerce_after_shop_loop_item', 'woocommerce_template_loop_add_to_cart', 10 ); remove_action( 'woocommerce_single_product_summary', 'woocommerce_template_single_add_to_cart', 30 ); remove_action( 'woocommerce_proceed_to_checkout', 'woocommerce_button_proceed_to_checkout', 20 ); remove_action( 'woocommerce_checkout_order_review', 'woocommerce_checkout_payment', 20 ); add_action( 'woocommerce_before_main_content', 'seahawk_shop_disabled_notice', 5 ); add_action( 'woocommerce_before_cart', 'seahawk_shop_disabled_notice', 5 ); add_action( 'woocommerce_before_checkout_form', 'seahawk_shop_disabled_notice', 5 ); } function seahawk_shop_disabled_notice() { wc_print_notice( __( '저희 상점은 현재 일시적으로 이용할 수 없습니다. 잠시 후 다시 확인해 주세요.' ), 'error' ); }

전환하는 방법

• 간단한 도우미 코드 조각이나 사이트별 플러그인을 통해 필터를 true로 설정하세요

add_filter( 'seahawk_holiday_mode_enabled', '__return_true' );

(선택 사항) ⟶ 이메일 수신자 이름 및 주소 변경

이메일 발신자를 브랜드 정체성.

add_filter( 'wp_mail_from_name', 'seahawk_wp_mail_from_name', 99 ); function seahawk_wp_mail_from_name( $name ) { $wc_name = get_option( 'woocommerce_email_from_name' ); return $wc_name ? html_entity_decode( $wc_name ) : $name; } add_filter( 'wp_mail_from', 'seahawk_wp_mail_from', 99 ); function seahawk_wp_mail_from( $email ) { $wc_email = get_option( 'woocommerce_email_from' ); return $wc_email ? sanitize_email( $wc_email ) : $email; }

설정 위치

• WooCommerce ⟶ 설정 ⟶ 이메일 ⟶ "보내는 사람" 이름 및 주소.

고객 계정 및 접근 규칙: WooCommerce 코드 조각

계정 데이터는 고객 지원, 주문 내역 및 제한된 콘텐츠에사용됩니다. 다음 코드 조각을 사용하여 계정 필드를 제어하고 기존 구매자를 위한 기능을 잠금 해제하세요.

결제 시 계정 입력란을 필수 항목으로 설정하세요

고객이 결제 시 계정을 생성하도록 하려면 사용자 이름과 비밀번호를 필수 입력 사항으로 설정하세요.

`add_filter( 'woocommerce_checkout_fields', 'seahawk_require_account_on_checkout' );` `function seahawk_require_account_on_checkout( $fields ) { if ( isset( $fields['account']['account_username'] ) ) { $fields['account']['account_username']['required'] = true; } if ( isset( $fields['account']['account_password'] ) ) { $fields['account']['account_password']['required'] = true; } if ( isset( $fields['account']['account_password-2'] ) ) { $fields['account']['account_password-2']['required'] = true; } return $fields; }`

좋은

• 회원제 매장.
• 주문 변경 지원 및 저장된 주소.
• 구매 후 온보딩.

사용자가 특정 제품을 이미 구매했는지 확인합니다

다운로드 제한, 반복 구매 제한 또는 업그레이드 제안 표시 등에 유용합니다.

function seahawk_user_bought_any( $product_ids = array(), $user_id = 0 ) { if ( empty( $product_ids ) ) return false; if ( ! $user_id && is_user_logged_in() ) { $user_id = get_current_user_id(); } if ( ! $user_id ) return false; $orders = wc_get_orders( array( 'type' => 'shop_order', 'status' => array( 'wc-completed', 'wc-processing' ), 'limit' => -1, 'customer_id' => $user_id, 'return' => 'ids', ) ); if ( empty( $orders ) ) return false; foreach ( $orders as $order_id ) { $order = wc_get_order( $order_id ); foreach ( $order->get_items() as $item ) { $pid = $item->get_product_id(); $vid = $item->get_variation_id(); if ( in_array( $pid, $product_ids, true ) || in_array( $vid, $product_ids, true ) ) { return true; } } } return false; }

템플릿에서 사용하는 방법

// 제품 템플릿 또는 숏코드 예시 $unlock_for = array( 21, 67 ); // 접근 권한을 부여하는 제품 ID if ( seahawk_user_bought_any( $unlock_for ) ) { echo '<p> 구매해주셔서 감사합니다. 보너스 콘텐츠가 잠금 해제되었습니다.</p> '; } 그렇지 않으면 { echo '<p> 강좌를 구매하시면 보너스 강의를 이용하실 수 있습니다.</p> '; }

아이디어

• 기존 구매자에게만 맞춤 탭을 표시합니다.
• "장바구니에 담기"를 다운로드 링크로 바꾸세요.
• 기존 소유주에게 할인된 가격으로 업그레이드 옵션을 제공합니다.

검색 및 필터 기능 활용: WooCommerce 코드 스니펫

검색 결과 및 템플릿에서 쇼핑객에게 표시되는 내용을 제어하세요. 깔끔한 결과는 사용자가 원하는 제품을 더 빠르게 찾을 수 있도록 도와주고, 비공개 카테고리는 숨길 수 있습니다.

사이트 검색에서 특정 카테고리 숨기기

렌탈, 도매 또는 초안 카테고리는 검색 결과에서 제외하세요.

add_action( 'pre_get_posts', 'seahawk_hide_category_from_search' ); function seahawk_hide_category_from_search( $query ) { if ( is_admin() || ! $query->is_main_query() || ! $query->is_search() ) { return; } $tax_query = array( array( 'taxonomy' => 'product_cat', 'field' => 'slug', 'terms' => array( 'rentals' ), ​​// 카테고리 슬러그로 대체 'operator' => 'NOT IN', ), ); $query->set( 'post_type', array( 'product' ) ); $query->set( 'tax_query', $tax_query ); }

사용 사례

• 도매 전용 상품을 숨깁니다.
• 시즌 한정 상품은 출시 전까지 제외합니다.
• B2B 번들 상품이 소매 검색 결과에 나타나지 않도록 하세요.

템플릿에서 카테고리 또는 태그를 빠르게 확인하는 방법

카테고리 또는 태그에 따라 블록, 배지 또는 메시지를 조건부로 로드합니다.

// 제품 루프 또는 단일 템플릿에서 if ( has_term( 'sneakers', 'product_cat', get_the_ID() ) ) { echo ' <span class="badge">Limited Edition</span> '; } if ( has_term( array( 'gift', 'bundle' ), 'product_tag', get_the_ID() ) ) { echo '<p> 24시간 내 배송</p> '; }

아이디어

• 태그가 부착된 상품에는 "선물 준비 완료" 배지를 표시하세요.
• 사이즈 차트는 의류 카테고리에만 추가해 주세요.
• 화장품에 안전 주의사항을 표시하세요.

제품 카테고리 위젯에서 특정 카테고리를 제외합니다

사이드바는 사용자가 탐색하기를 원하는 콘텐츠에 집중하도록 구성하세요.

add_filter( 'woocommerce_product_categories_widget_args', 'seahawk_widget_exclude_cats' ); function seahawk_widget_exclude_cats( $args ) { $args['exclude'] = array( 16, 25 ); // 카테고리 ID로 대체 return $args; }

팁

• 제품 ⟶ 카테고리 ⟶에서 제품 이름 위에 마우스를 올리면 URL에 포함된 ID를 확인할 수 있습니다.

관리자 편의성 향상: WooCommerce 코드 스니펫

WooCommerce 쇼핑몰을 운영한다는 것은 WordPress 관리자 페이지. 이 코드 조각들은 중요한 정보를 한눈에 볼 수 있도록 하고 브랜드 이미지에 맞춰 발송 이메일을 최적화하여 일상적인 업무를 더욱 편리하게 만들어 줍니다.

주문 목록에 사용자 지정 열 추가

주문 목록 보기에서 일련 번호 또는 추적 코드와 같은 추가 데이터를 직접 표시합니다.

// 새 열 추가 add_filter( 'manage_edit-shop_order_columns', 'seahawk_edit_shop_order_columns' ); function seahawk_edit_shop_order_columns( $columns ) { $columns['serial'] = __( '일련번호', 'woocommerce' ); return $columns; } // 열에 데이터 채우기 add_action( 'manage_shop_order_posts_custom_column', 'seahawk_shop_order_column_content', 10, 2 ); function seahawk_shop_order_column_content( $column, $post_id ) { if ( 'serial' === $column ) { $serial = get_post_meta( $post_id, '_order_serial_number', true ); if ( $serial ) { echo esc_html( $serial ); } } } 그렇지 않으면 { echo '—'; } } }

도움이 되는 이유

• 데이터를 미리 보여줌으로써 클릭 횟수를 줄여줍니다.
• 주문 상품 개봉에 소요되는 시간을 줄여줍니다.

사용자 정의 게시물 유형에 연결된 제품 또는 SKU 추가

사용자 지정 제품 설정을 실행하는 경우 열을 더 확장할 수 있습니다.

add_filter( 'manage_edit-product_columns', 'seahawk_edit_product_columns' ); function seahawk_edit_product_columns( $columns ) { $columns['sku'] = __( 'SKU', 'woocommerce' ); return $columns; } add_action( 'manage_product_posts_custom_column', 'seahawk_product_column_content', 10, 2 ); function seahawk_product_column_content( $column, $post_id ) { if ( 'sku' === $column ) { $product = wc_get_product( $post_id ); echo $product ? $product->get_sku() : ''; } }

사용 사례

• 제품 SKU를 한눈에 확인하세요.
• 카탈로그 관리자의 업무 효율성을 높이세요.

이메일 발신자 이름과 주소를 브랜드에 맞춰 정렬하세요

워드프레스 기본 설정은 전문적이지 않아 보일 수 있습니다. WooCommerce 설정에서 값을 가져와서 수정해 보세요.

add_filter( 'wp_mail_from_name', 'seahawk_custom_from_name', 99 ); function seahawk_custom_from_name( $name ) { $wc_name = get_option( 'woocommerce_email_from_name' ); return $wc_name ? html_entity_decode( $wc_name ) : $name; } add_filter( 'wp_mail_from', 'seahawk_custom_from_address', 99 ); function seahawk_custom_from_address( $email ) { $wc_email = get_option( 'woocommerce_email_from' ); return $wc_email ? sanitize_email( $wc_email ) : $email; }

값을 설정하는 위치

• WooCommerce ⟶ 설정 ⟶ 이메일 ⟶ 보내는 사람 이름 및 보내는 사람 주소.

성능 및 레이아웃 최적화 도우미: WooCommerce 코드 스니펫

페이지 로딩 속도 향상과 깔끔한 ​​레이아웃은 전환율을 높여줍니다. 이러한 스니펫은 모바일에서 장바구니를 보기 좋게 표시하고 추천 상품 검색을 효율적으로 만들어 줍니다.

카트 테이블을 이동이 편리하게 되도록 만드세요

작은 화면에서는 장바구니 테이블이 세로로 배열된 형태로 표시됩니다. 다음 CSS 코드를 자식 테마 스타일시트 또는 커스터마이저 CSS 패널에 추가하세요.

/* 모바일 친화적인 WooCommerce 장바구니 테이블 */ @media screen and (max-width: 700px) { .woocommerce table.shop_table, .woocommerce table.shop_table thead, .woocommerce table.shop_table tbody, .woocommerce table.shop_table th, .woocommerce table.shop_table td, .woocommerce table.shop_table tr { display: block; } .woocommerce table.shop_table thead tr { position: absolute; top: -9999px; left: -9999px; } .woocommerce table.shop_table tr { margin-bottom: 12px; border: 1px solid #e5e7eb; border-radius: 8px; overflow: hidden; } .woocommerce table.shop_table td { position: relative; padding-left: 50% !important; border: none; border-bottom: 1px solid #f1f5f9; } } .woocommerce table.shop_table td::last-child { border-bottom: none; } .woocommerce table.shop_table td::before { position: absolute; top: 10px; left: 10px; width: 45%; white-space: nowrap; font-weight: 600; content: attr(data-title); } }

작동 방식

• WooCommerce가 테이블 셀에 추가하는 `data-title` 속성을 사용합니다.
• 헤더를 숨기고 각 행을 카드로 바꿉니다.
• 플러그인 없이도 휴대폰의 가독성을 향상시켜 줍니다.

주요 제품 ID에 트랜지언트를 사용하세요

추천 상품 목록을 캐싱하면 반복적인 쿼리를 줄일 수 있습니다. 한 번만 저장해두면 여러 템플릿에서 재사용할 수 있습니다.

function seahawk_get_featured_product_ids( $cache_key = 'seahawk_featured_ids', $ttl = HOUR_IN_SECONDS ) { $ids = get_transient( $cache_key ); if ( false !== $ids ) { return $ids; } $featured_query = new WP_Query( array( 'post_type' => 'product', 'posts_per_page' => -1, 'meta_query' => array( array( 'key' => '_featured', 'value' => 'yes', 'compare' => '=', ), ), 'fields' => 'ids', 'no_found_rows' => true, ) ); $ids = $featured_query->posts; set_transient( $cache_key, $ids, $ttl ); return $ids; } // 사용 예시 ⟶ 미니 그리드 생성 add_shortcode( 'seahawk_featured_grid', function( $atts ) { $ids = seahawk_get_featured_product_ids(); if ( empty( $ids ) ) return '<p> 추천 상품이 없습니다.</p> '; $out = '<ul class="featured-grid"> '; foreach ( $ids as $pid ) { $out .= '<li> <a href="' . esc_url( get_permalink( $pid ) ) . '">' . esc_html( get_the_title( $pid ) ) . '</a></li> '; } $out .= '</ul> '; $out을 반환합니다; } );

팁

• 추천 상태를 전환할 때 일시적인 현상을 지우세요.
• 제품 업데이트에 연동하여 캐시를 삭제합니다.

add_action( 'save_post_product', function( $post_id ) { delete_transient( 'seahawk_featured_ids' ); } );

규정 준수 및 현지화 세부 정보: WooCommerce 코드 스니펫

폼과 언어 설정을 약간만 수정하면 다양한 지역에서 결제 속도가 빠르고 정확해집니다. 이러한 코드 조각은 추가 플러그인 없이 현지화하는 데 도움이 됩니다.

필요하지 않은 경우 상태 필드를 제거하세요

일부 국가에서는 주(state)라는 명칭을 사용하지 않습니다. 해당 항목을 숨기면 양식이 간소화되고 혼란이 줄어듭니다.

add_filter( 'woocommerce_default_address_fields', 'seahawk_remove_state_field' ); function seahawk_remove_state_field( $fields ) { if ( isset( $fields['state'] ) ) { $fields['state']['required'] = false; $fields['state']['hidden'] = true; } return $fields; }

팁

• 특정 국가에 대해서만 숨기려면 조건부 논리를 사용하세요.

사용자 지정 국가를 목록에 추가

테스트 환경이나 특정 지역에 유용합니다.

add_filter( 'woocommerce_countries', 'seahawk_add_custom_country' ); function seahawk_add_custom_country( $countries ) { $countries['XX'] = __( 'Exampleland', 'woocommerce' ); // 국가 코드와 이름을 대체합니다. return $countries; } add_filter( 'woocommerce_continents', 'seahawk_map_custom_country' ); function seahawk_map_custom_country( $continents ) { // 대륙에 국가 코드를 추가합니다. if ( isset( $continents['EU']['countries'] ) ) { $continents['EU']['countries'][] = 'XX'; } return $continents; }

나타나는 곳

• WooCommerce 설정 ⟶ 일반 ⟶ 판매 위치.
• 결제 및 계정 페이지에 국가 드롭다운 메뉴가 있습니다.

gettext를 사용하여 마이크로카피를 빠르게 번역하세요

템플릿을 수정하지 않고도 스토어 전체의 오타를 수정하거나 문구를 변경할 수 있습니다.

add_filter( 'gettext', 'seahawk_quick_translate', 10, 3 ); function seahawk_quick_translate( $translated, $original, $domain ) { // 예시 ⟶ "옵션 선택"을 "선택"으로 변경 if ( '옵션 선택' === $original && 'woocommerce' === $domain ) { return '선택'; } // 예시 ⟶ "장바구니에 추가"를 "수건에 추가"로 이름 변경 if ( '장바구니에 추가' === $original && 'woocommerce' === $domain ) { return '수건에 추가'; } return $translated; }

메모

• 원문과 정확히 일치해야 합니다.
• 변경 사항은 브랜드 보이스와 일관성을 유지하세요.

(선택 사항) ⟶ 지역별 가격 구분 기호 현지화

사용자가 익숙한 형식으로 가격을 읽을 수 있도록 도와주세요.

add_filter( 'wc_price_args', 'seahawk_price_format_by_locale' ); function seahawk_price_format_by_locale( $args ) { if ( function_exists( 'get_user_locale' ) && 'fr_FR' === get_user_locale() ) { $args['decimal_separator'] = ','; $args['thousand_separator'] = ' '; } return $args; }

시험

• 장바구니 총액.
• 쿠폰 및 세금.
• 주문 이메일.

마지막으로

이제 카탈로그 표시, 결제 흐름, 배송 로직, 가격 책정, 현지화 및 관리자 편의성을 아우르는 WooCommerce 코드 스니펫 라이브러리를 갖게 되었습니다. 이 스니펫들을 함께 사용하면 무거운 플러그인 없이도 원하는 기능을 완벽하게 제어할 수 있으며 WordPress 사이트를 더욱 간결하게 유지할 수 있습니다.

배포하기 전에 다음 마지막 권장 사항을 염두에 두세요

• 실제 사이트에 스니펫을 적용하기 전에 항상 스테이징 환경에서 테스트하십시오.
• functions.php 파일이나 스니펫 플러그인으로 내보낸 파일의 백업을 보관하세요.
• 향후 개발자들이 각 코드 조각의 기능을 이해할 수 있도록 모든 코드 조각에 주석을 추가하세요.
• WooCommerce 업데이트 검토 ⟶ 일부 코드 조각은 시간이 지남에 따라 수정이 필요할 수 있습니다.

이러한 작은 기능들을 주의해서 사용하면 수십 개의 플러그인 설치를 줄일 수 있고 온라인 스토어를 더 빠르고 쉽게 관리할 수 있습니다.

WooCommerce 코드 스니펫 관련 FAQ