영수증 템플릿
영수증 템플릿 편집기를 사용하면 POS 시스템에서 인쇄된 영수증의 모양과 내용을 사용자 정의할 수 있습니다. 템플릿 편집기에 접근하려면 다음으로 이동하십시오: WP Admin > POS > Templates
개요
템플릿 시스템은 두 가지 유형의 템플릿을 제공합니다:
- 기본 템플릿: 플러그인 및 테마 파일에서 자동으로 감지됩니다. 이러한 템플릿은 삭제할 수 없지만 사용자 정의 버전을 만들기 위해 복사할 수 있습니다.
- 사용자 정의 템플릿: 사용자가 생성한 템플릿으로, 완전히 사용자 정의하고 수정 및 관리할 수 있습니다.
템플릿 편집기 접근
- WordPress 관리 대시보드로 이동합니다.
- POS > Templates로 이동합니다.
- 두 개의 섹션으로 정리된 사용 가능한 템플릿 목록을 볼 수 있습니다:
- 기본 템플릿 (플러그인/테마 파일에서)
- 사용자 정의 템플릿 (사용자가 만든 템플릿)
기본 템플릿
시스템은 세 가지 출처에서 영수증 템플릿을 자동으로 감지합니다:
템플릿 출처
| 출처 | 설명 | 상태 |
|---|---|---|
| 플러그인 | WCPOS에 포함된 기본 영수증 템플릿 | 항상 사용 가능 |
| Pro 플러그인 | WCPOS 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 템플릿을 도와주는 데 훌륭합니다. 템플릿 코드를 붙여넣고 원하는 것을 설명하면 됩니다.
- 고급 사용자 정의를 위해 WCPOS 문서를 참조하십시오.
고급 사용자 정의
영수증 템플릿에 대한 더 많은 제어가 필요한 고급 사용자용:
테마 통합
사용자 정의 receipt.php 파일을 테마에 배치하여 기본 템플릿을 무시할 수 있습니다:
your-theme/woocommerce-pos/receipt.php
후크 및 필터
WCPOS는 템플릿 사용자 정의를 위한 다양한 후크 및 필터를 제공합니다. 사용 가능한 옵션에 대한 개발자 문서를 참조하십시오.
사용자 정의 필드
적절한 WordPress 및 WooCommerce 함수를 사용하여 영수증 템플릿에 사용자 정의 주문 필드, 제품 속성 및 기타 메타데이터를 포함할 수 있습니다.