영수증 템플릿
영수증 템플릿 편집기를 사용하면 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 함수
WCPOS 관련 데이터 및 기능에 접근하기 위해 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 기능을 사용하여 영수증 템플릿에 사용자 정의 주문 필드, 제품 속성 및 기타 메타데이터를 포함할 수 있습니다.