WordPress 플러그인 문서
통화 변환기 위젯을 설치, 설정, 맞춤화하는 방법을 알아보세요
목차
1 설치
방법 1: WordPress에서 설치 (추천)
- WordPress 관리자 대시보드로 이동하세요
- 플러그인 > 새로 추가로 이동하세요
- "Currency.Wiki Converter"를 검색하세요
- "지금 설치"를 클릭한 후 "활성화"를 클릭하세요
방법 2: 수동 설치
- WordPress.org에서 플러그인을 다운로드하세요
- 플러그인 > 새로 추가 > 플러그인 업로드로 이동하세요
- 다운로드한 ZIP 파일을 선택하고 "지금 설치"를 클릭하세요
- 설치 후 플러그인을 활성화하세요
2 Gutenberg 블록 사용
페이지에 통화 변환기를 추가하는 가장 쉬운 방법:
- Gutenberg 에디터로 페이지나 게시물을 편집하세요
- + 버튼을 클릭하여 새 블록을 추가하세요
- "Currency Converter"를 검색하거나 위젯 카테고리를 찾아보세요
- 오른쪽 사이드바 패널에서 위젯을 설정하세요
팁: 블록 에디터에서 설정을 변경할 때 위젯의 실시간 미리보기를 볼 수 있습니다.
3 숏코드 사용법
게시물, 페이지 또는 테마 템플릿에서 숏코드를 사용하여 위젯을 추가할 수도 있습니다:
기본 사용법
[currencywiki_converter]
사용 가능한 속성
| 속성 | 기본값 | 설명 |
|---|---|---|
| style | compact | 위젯 스타일 (compact, inline, tall, mini-chart 등) |
| theme | auto | 색상 테마 (auto, light, dark) |
| from | USD | 기본 소스 통화 (3자리 ISO 코드) |
| to | EUR | 기본 대상 통화 (3자리 ISO 코드) |
| amount | 1 | 기본 변환 금액 |
| accent | #3b82f6 | 강조 색상 (예: #3b82f6) |
| embed | script | 임베드 방식 (script 또는 iframe) |
| width | auto | 픽셀 단위의 사용자 지정 너비 |
| height | auto | 픽셀 단위의 사용자 지정 높이 |
예시
다크 테마 위젯:
[currencywiki_converter theme="dark"]
맞춤 통화 및 금액:
[currencywiki_converter from="GBP" to="JPY" amount="100"]
미니 차트 스타일:
[currencywiki_converter style="mini-chart"]
iframe 임베드 사용 (테마 호환용):
[currencywiki_converter embed="iframe"]
4 위젯 스타일
웹사이트 디자인에 맞는 다양한 위젯 스타일 중에서 선택하세요:
mini
최소형 변환기, 좁은 공간에 적합 (250x140px)
square
정사각형 1:1 비율 변환기 (250x250px)
compact
작고 공간 효율적인 변환기 (280x200px)
inline
수평 레이아웃, 헤더에 적합 (450x120px)
tall
클래식 라벨이 있는 세로 레이아웃 (220x360px)
mini-chart
히스토리 차트가 포함된 컴팩트 변환기 (250x260px)
multi-expandable
여러 통화로 변환, 사용자가 추가/제거 가능 (300x400px)
multi-fixed
고정된 다중 통화 변환 목록 (280x360px)
rates-compact
간단한 환율 목록 (260x260px)
rates-viewer
차트가 포함된 전체 환율 뷰어 (350x420px)
rates-viewer-compact
차트가 포함된 컴팩트 환율 뷰어 (300x340px)
팁: WordPress 관리자에서 위젯 빌더를 사용해 모든 스타일을 사이트에 추가하기 전에 미리볼 수 있습니다.
5 설정 옵션
WordPress 관리자 내 플러그인 설정 페이지에서 기본 옵션을 설정할 수 있습니다:
테마 옵션
- auto - 사이트 색상 스킴과 자동으로 일치
- light - 항상 밝은 배경 사용
- dark - 항상 어두운 배경 사용
임베드 방식
- script - 기본값. 위젯이 인라인으로 전체 기능과 함께 로드됩니다. 통화 드롭다운이 주변 콘텐츠 위에 표시됩니다.
- iframe - 대체 옵션. 위젯이 격리된 iframe에서 로드됩니다. 테마와 스타일 충돌이 있을 때 사용하세요.
참고: 통화 드롭다운이 다른 요소 뒤에 가려지거나 잘릴 경우, iframe 임베드 모드로 전환해보세요.
6 문제 해결
위젯이 표시되지 않나요?
플러그인이 활성화되어 있는지 확인하세요. 캐싱 플러그인이 있다면 캐시를 비우세요. 스크립트 임베드가 작동하지 않으면 iframe 임베드 방식을 사용해보세요.
위젯이 깨지거나 스타일이 충돌하나요?
일부 WordPress 테마가 위젯 스크립트와 충돌할 수 있습니다. 숏코드에 embed="iframe"을 추가하여 iframe 임베드 모드로 전환하세요.
통화 드롭다운이 숨겨지거나 잘리나요?
컨테이너 요소에 overflow:hidden이 적용된 경우 발생할 수 있습니다. iframe 임베드 모드를 사용하거나, 위젯 컨테이너의 CSS에서 overflow를 허용하도록 조정하세요.
위젯이 오래된 환율을 표시하나요?
환율은 자동으로 업데이트됩니다. 캐싱 플러그인을 사용하는 경우, 위젯 스크립트를 캐싱에서 제외하거나 변경 후 캐시를 비우세요.
