영수증 템플릿들
영수증 템플릿 편집기를 사용하면 POS 시스템에서 인쇄된 영수증의 모양과 내용을 사용자 정의할 수 있습니다. 템플릿 편집기는 다음 경로를 통해 접근할 수 있습니다: WP Admin > POS > Templates
개요
템플릿 시스템은 두 가지 유형의 템플릿을 제공합니다:
- 기본 템플릿들: 플러그인 및 테마 파일에서 자동으로 감지됩니다. 이러한 템플릿은 삭제할 수 없지만 사용자 정의 버전을 만들기 위해 복사할 수 있습니다.
- 사용자 정의 템플릿들: 사용자가 생성한 템플릿으로 완전히 사용자 정의하고 편집하며 관리할 수 있습니다.
템플릿 편집기 접근
- WordPress 관리 대시보드로 이동합니다.
- POS > Templates로 가세요.
- 두 개의 섹션으로 구성된 사용 가능한 템플릿 목록이 표시됩니다:
- 기본 템플릿들 (플러그인/테마 파일에서)
- 사용자 정의 템플릿들 (당신의 사용자 정의 생성물)
기본 템플릿들
시스템은 세 가지 출처에서 영수증 템플릿을 자동으로 감지합니다:
템플릿 출처
| 출처 | 설명 | 상태 |
|---|---|---|
| 플러그인 | WooCommerce POS에 포함된 기본 영수증 템플릿 | 항상 사용 가능 |
| 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 함수
WCPOS 관련 데이터 및 기능에 접근하기 위해 wcpos_ 접두사가 붙은 WCPOS 전용 함수를 사용할 수 있습니다.
모범 사례
템플릿 개발
- 복사본에서 시작: 처음부터 만들기보다 항상 기본 템플릿 복사본에서 시작합니다.
- 철저히 테스트: 활성화하기 전에 미리보기 기능을 사용하여 템플릿을 테스트합니다.
- 백업 유지: 사용자 정의 템플릿을 내보내거나 코드의 복사본을 유지합니다.
- 모바일 친화적: 템플릿이 다양한 화면 크기에서 잘 작동하도록 합니다.
코드 품질
- HTML 유효성 검사: HTML이 잘 형성되었는지 확인합니다.
- 출력 이스케이프: 보안을 위해 WordPress 이스케이프 함수를 사용합니다.
- 오류 처리: PHP 코드에 적절한 오류 검사를 포함합니다.
- 주석: 향후 참조를 위해 사용자 정의 사항을 문서화합니다.
성능
- CSS 최적화: 스타일을 최소화하고 효율적으로 유지합니다.
- PHP 최소화: 템플릿에서 복잡한 논리를 피합니다.
- 인쇄 테스트: 템플릿이 영수증 프린터와 잘 작동하는지 확인합니다.
문제 해결
일반적인 문제
템플릿에서 변경 사항이 표시되지 않음
- 변경 사항을 저장하기 위해 "업데이트"를 클릭했는지 확인하세요.
- 템플릿이 "활성"으로 설정되어 있는지 확인하세요.
- 모든 캐싱 플러그인을 지웁니다.
구문 오류
- 구문 강조를 사용하여 문제를 식별하세요.
- 세미콜론, 괄호 또는 따옴표가 누락되었는지 확인하세요.
- PHP 구문을 유효성 검사하세요.
스타일 문제
- 미리보기 모드에서 CSS를 테스트하세요.
- 스타일이 영수증 프린터와 호환되는지 확인하세요.
- 인쇄 친화적인 디자인 원칙을 염두에 두세요.
템플릿이 사용 가능하지 않음
- 템플릿 유형이 "영수증"으로 설정되어 있는지 확인하세요.
- 템플릿 상태가 "게시됨"인지 확인하세요.
- 올바른 권한이 있는지 확인하세요.
도움 받기
템플릿 사용자 정의와 관련하여 문제가 발생하면:
- 오류 메시지에 대한 템플릿 미리보기를 확인하세요.
- PHP 오류에 대한 WordPress 디버그 로그를 검토하세요.
- 먼저 기본 템플릿 복사본으로 테스트하세요.
- AI 지원: 현대 AI 도구인 Gemini, ChatGPT 및 Claude는 이러한 단순한 WordPress 템플릿을 도와주는 데 탁월합니다. 템플릿 코드를 붙여넣고 달성하려는 내용을 설명할 수 있습니다.
- 고급 사용자 정의를 위해 WooCommerce POS 문서를 참조하세요.
고급 사용자 정의
영수증 템플릿에 대한 더 많은 제어가 필요한 고급 사용자를 위해:
테마 통합
사용자 정의 receipt.php 파일을 테마에 배치하여 기본 템플릿을 재정의할 수 있습니다:
your-theme/woocommerce-pos/receipt.php
후크 및 필터
WooCommerce POS는 템플릿 사용자 정의를 위한 다양한 후크 및 필터를 제공합니다. 사용 가능한 옵션에 대해 개발자 문서를 참조하세요.
사용자 정의 필드
적절한 WordPress 및 WooCommerce 함수를 사용하여 사용자 정의 주문 필드, 제품 속성 및 기타 메타데이터를 영수증 템플릿에 포함할 수 있습니다.