영수증 템플릿
영수증 템플릿 편집기를 사용하면 POS 시스템에서 인쇄되는 영수증의 모양과 내용을 사용자 지정할 수 있습니다. 템플릿 편집기에 접근하려면: WP Admin > POS > Templates로 이동하세요.
개요
템플릿 시스템은 두 가지 유형의 템플릿을 제공합니다:
- 기본 템플릿: 플러그인 및 테마 파일에서 자동으로 감지됩니다. 삭제할 수는 없지만 사용자 지정 버전 생성을 위해 복사할 수 있습니다.
- 사용자 지정 템플릿: 사용자가 생성한 템플릿으로, 완전히 사용자 지정, 편집 및 관리할 수 있습니다.
템플릿 편집기에 접근하기
- WordPress 관리 대시보드로 이동합니다.
- POS > Templates로 가세요.
- 사용 가능한 템플릿 목록이 두 섹션으로 나누어 표시됩니다:
- 기본 템플릿 (플러그인/테마 파일에서)
- 사용자 지정 템플릿 (사용자에 의해 생성된)
기본 템플릿
시스템은 세 가지 출처에서 영수증 템플릿을 자동으로 감지합니다:
템플릿 출처
| 출처 | 설명 | 상태 |
|---|---|---|
| 플러그인 | WooCommerce POS와 함께 제공되는 기본 영수증 템플릿 | 항상 사용 가능 |
| Pro 플러그인 | WooCommerce POS Pro의 향상된 템플릿 | 활성 라이센스가 있는 경우 사용 가능 |
| 테마 | 활성 테마에서의 사용자 지정 템플릿 | 테마에 템플릿이 포함되어 있는 경우 사용 가능 |
템플릿 작업
각 기본 템플릿에 대해 다음 작업을 수행할 수 있습니다:
- 미리보기: 샘플 데이터를 사용하여 템플릿이 어떻게 보이는지 확인합니다.
- 복사: 편집할 수 있는 사용자 지정 복사를 만듭니다.
- 활성화: POS용 활성 템플릿으로 설정합니다.
사용자 지정 템플릿 만들기
방법 1: 기본 템플릿에서 복사
- 기본 템플릿 섹션에서 사용자 지정할 템플릿을 찾습니다.
- 복사 버튼을 클릭합니다.
- 사용자 지정 템플릿의 이름을 입력합니다.
- 템플릿 복사를 클릭합니다.
- 새로 생성된 사용자 지정 템플릿을 편집합니다.
방법 2: 처음부터 생성
- 페이지 상단의 새 템플릿 추가를 클릭합니다.
- 템플릿 이름을 입력합니다.
- 영수증 템플릿 타입을 선택합니다.
- 편집기에서 템플릿 코딩을 시작합니다.
템플릿 편집기 기능
템플릿 편집기는 다음을 제공합니다:
코드 편집기
- 문법 강조 표시: 더 나은 코드 가독성을 위한 PHP 문법 강조
- 행 번호: 쉬운 탐색 및 디버깅
- 전체 화면 편집: 방해 없는 편집 환경
템플릿 설정 패널
- 언어: 적절한 문법 강조를 위해 PHP로 설정
- 템플릿 유형: 영수증 또는 보고서 템플릿 중 선택
- 상태: 게시/초안 상태 관리
- 가시성: 템플릿 가시성 제어
템플릿 작업
- 미리보기: 샘플 데이터와 함께 템플릿이 어떻게 렌더링되는지 확인합니다.
- 활성화: 이 템플릿을 POS의 기본으로 설정합니다.
- 업데이트: 변경 사항 저장
- 휴지통으로 이동: 사용자 지정 템플릿 삭제
템플릿 구조
영수증 템플릿은 HTML 출력을 생성하는 PHP 파일입니다. 기본 구조는 다음과 같습니다:
<?php
/**
* Custom Receipt Template
*/
if ( ! defined( 'ABSPATH' ) ) {
exit; // Exit if accessed directly
}
?>
<!DOCTYPE html>
<html <?php language_attributes(); ?>>
<head>
<meta charset="<?php bloginfo( 'charset' ); ?>">
<meta name="viewport" content="width=device-width, initial-scale=1">
<style>
/* Your custom CSS styles */
body { font-family: sans-serif; font-size: 14px; }
.receipt-header { text-align: center; margin-bottom: 20px; }
/* Add more styles as needed */
</style>
</head>
<body>
<!-- Your receipt content -->
<div class="receipt-header">
<h1><?php echo get_bloginfo( 'name' ); ?></h1>
<p><?php echo get_bloginfo( 'description' ); ?></p>
</div>
<!-- Order details, items, totals, etc. -->
</body>
</html>
사용 가능한 템플릿 변수
사용자 지정 템플릿을 만들 때는 다양한 WordPress 및 WooCommerce 기능과 데이터에 접근할 수 있습니다:
상점 정보
get_bloginfo( 'name' )- 상점 이름get_bloginfo( 'description' )- 상점 태그라인get_bloginfo( 'url' )- 상점 URL
주문 데이터
현재 주문 데이터는 템플릿이 렌더링될 때 표준 WooCommerce 주문 기능을 통해 사용할 수 있습니다.
WCPOS 함수
POS 관련 데이터 및 기능에 접근하기 위해 wcpos_로 접두사가 붙은 WCPOS 전용 함수를 사용할 수 있습니다.
모범 사례
템플릿 개발
- 복사본으로 시작: 처음부터 새로 만들기보다 항상 기본 템플릿을 복사하여 시작하세요.
- 철저하게 테스트: 활성화하기 전에 미리보기 기능을 사용하여 템플릿을 테스트하세요.
- 백업 유지: 사용자 정의 템플릿을 내보내거나 코드의 복사본을 유지하세요.
- 모바일 친화적: 템플릿이 다양한 화면 크기에서 잘 작동하는지 확인하세요.
코드 품질
- HTML 검증: HTML이 잘 형성되었는지 확인하세요.
- 출력 이스케이프: 보안을 위해 WordPress 이스케이프 함수를 사용하세요.
- 오류 처리: PHP 코드에서 적절한 오류 검사를 포함하세요.
- 주석: 향후 참조를 위해 사용자 지정 내용을 문서화하세요.
성능
- CSS 최적화: 스타일을 최소화하고 효율적으로 유지하세요.
- PHP 최소화: 템플릿 내에서 복잡한 로직을 피하세요.
- 인쇄 테스트: 영수증 프린터와 잘 작동하는지 확인하세요.
문제 해결
일반적인 문제
템플릿에서 변경 사항이 표시되지 않음
- 변경 사항을 저장하려면 "업데이트"를 클릭했는지 확인하세요.
- 템플릿이 "활성"으로 설정되어 있는지 확인하세요.
- 모든 캐싱 플러그인을 지우세요.
문법 오류
- 문법 강조를 사용하여 문제를 식별하세요.
- 세미콜론, 괄호 또는 따옴표가 누락되지 않았는지 확인하세요.
- PHP 문법을 검증하세요.
스타일링 문제
- 미리보기 모드에서 CSS를 테스트하세요.
- 스타일이 영수증 프린터와 호환되는지 확인하세요.
- 인쇄 친화적인 디자인 원칙을 염두에 두세요.
템플릿을 사용할 수 없음
- 템플릿 유형이 "영수증"으로 설정되어 있는지 확인하세요.
- 템플릿 상태가 "게시됨"인지 확인하세요.
- 적절한 권한이 있는지 확인하세요.
도움 받기
템플릿 사용자 정의 중 문제가 발생하면:
- 오류 메시지에 대한 템플릿 미리보기를 확인하세요.
- PHP 오류에 대한 WordPress 디버그 로그를 검토하세요.
- 기본 템플릿의 복사본으로 테스트하세요.
- AI 지원: Gemini, ChatGPT 및 Claude와 같은 최신 AI 도구는 이러한 간단한 WordPress 템플릿에 대해 도움을 주는 데 매우 유용합니다. 템플릿 코드를 붙여넣고 원하는 작업을 설명할 수 있습니다.
- 고급 사용자 지정을 위해 WooCommerce POS 문서를 참조하세요.
고급 사용자 정의
영수증 템플릿에 대해 더 많은 제어가 필요한 고급 사용자를 위해:
테마 통합
사용자 지정 receipt.php 파일을 테마에 배치하여 기본 템플릿을 재정의할 수 있습니다:
your-theme/woocommerce-pos/receipt.php
훅 및 필터
WooCommerce POS는 템플릿 사용자 지정을 위한 다양한 훅과 필터를 제공합니다. 사용 가능한 옵션은 개발자 문서를 참조하세요.
사용자 지정 필드
적절한 WordPress 및 WooCommerce 함수를 사용하여 영수증 템플릿에 사용자 지정 주문 필드, 제품 속성 및 기타 메타데이터를 포함할 수 있습니다.