Tài liệu Plugin WordPress
Tìm hiểu cách cài đặt, cấu hình và tùy chỉnh tiện ích chuyển đổi tiền tệ của bạn
Mục lục
1 Cài đặt
Cách 1: Cài đặt từ WordPress (Khuyến nghị)
- Truy cập trang quản trị WordPress của bạn
- Đi tới Plugins > Add New
- Tìm kiếm "Currency.Wiki Converter"
- Nhấn "Install Now" rồi "Activate"
Cách 2: Cài đặt thủ công
- Tải plugin từ WordPress.org
- Đi tới Plugins > Add New > Upload Plugin
- Chọn file ZIP đã tải và nhấn "Install Now"
- Kích hoạt plugin sau khi cài đặt
2 Sử dụng Gutenberg Block
Cách dễ nhất để thêm tiện ích chuyển đổi tiền tệ vào trang của bạn:
- Chỉnh sửa bất kỳ trang hoặc bài viết nào bằng trình chỉnh sửa Gutenberg
- Nhấn nút + để thêm block mới
- Tìm kiếm "Currency Converter" hoặc duyệt danh mục Widgets
- Cấu hình tiện ích bằng bảng bên phải
Mẹo: Bạn có thể xem trước trực tiếp tiện ích khi thay đổi cài đặt trong trình chỉnh sửa block.
3 Cách dùng Shortcode
Bạn cũng có thể thêm tiện ích bằng shortcode trong bài viết, trang hoặc mẫu giao diện:
Cách sử dụng cơ bản
[currencywiki_converter]
Các thuộc tính khả dụng
| Thuộc tính | Mặc định | Mô tả |
|---|---|---|
| style | compact | Kiểu giao diện tiện ích (compact, inline, tall, mini-chart, v.v.) |
| theme | auto | Chủ đề màu sắc (auto, light, dark) |
| from | USD | Tiền tệ nguồn mặc định (mã ISO 3 ký tự) |
| to | EUR | Tiền tệ đích mặc định (mã ISO 3 ký tự) |
| amount | 1 | Số tiền mặc định để chuyển đổi |
| accent | #3b82f6 | Màu nhấn (mã hex như #3b82f6) |
| embed | script | Phương thức nhúng (script hoặc iframe) |
| width | auto | Chiều rộng tùy chỉnh (pixel) |
| height | auto | Chiều cao tùy chỉnh (pixel) |
Ví dụ
Tiện ích chủ đề tối:
[currencywiki_converter theme="dark"]
Tiền tệ và số tiền tùy chỉnh:
[currencywiki_converter from="GBP" to="JPY" amount="100"]
Kiểu mini chart:
[currencywiki_converter style="mini-chart"]
Dùng nhúng iframe (tương thích giao diện):
[currencywiki_converter embed="iframe"]
4 Kiểu giao diện tiện ích
Chọn nhiều kiểu giao diện tiện ích phù hợp với thiết kế website của bạn:
mini
Chuyển đổi tối giản, phù hợp không gian hẹp (250x140px)
square
Chuyển đổi tỷ lệ vuông 1:1 (250x250px)
compact
Chuyển đổi nhỏ gọn, tiết kiệm không gian (280x200px)
inline
Bố cục ngang, lý tưởng cho header (450x120px)
tall
Bố cục dọc với nhãn cổ điển (220x360px)
mini-chart
Chuyển đổi nhỏ gọn kèm biểu đồ lịch sử (250x260px)
multi-expandable
Chuyển đổi nhiều tiền tệ, người dùng có thể thêm/xóa (300x400px)
multi-fixed
Danh sách chuyển đổi nhiều tiền tệ cố định (280x360px)
rates-compact
Danh sách tỷ giá đơn giản (260x260px)
rates-viewer
Xem tỷ giá đầy đủ kèm biểu đồ (350x420px)
rates-viewer-compact
Xem tỷ giá nhỏ gọn kèm biểu đồ (300x340px)
Mẹo: Dùng Trình tạo tiện ích trong quản trị WordPress để xem trước tất cả kiểu trước khi thêm vào website.
5 Tùy chọn cấu hình
Trang cài đặt plugin trong quản trị WordPress cho phép bạn cấu hình các tùy chọn mặc định:
Tùy chọn chủ đề
- auto - Tự động khớp với màu sắc website
- light - Luôn dùng nền sáng
- dark - Luôn dùng nền tối
Phương thức nhúng
- script - Mặc định. Tiện ích tải trực tiếp với đầy đủ chức năng. Danh sách tiền tệ hiển thị nổi trên nội dung.
- iframe - Phương án dự phòng. Tiện ích tải trong iframe riêng biệt. Dùng nếu gặp xung đột giao diện với theme.
Lưu ý: Nếu danh sách tiền tệ bị che hoặc cắt, hãy thử chuyển sang chế độ nhúng iframe.
6 Khắc phục sự cố
Tiện ích không hiển thị?
Đảm bảo plugin đã được kích hoạt. Kiểm tra các plugin cache và xóa cache nếu cần. Thử dùng phương thức nhúng iframe nếu script không hoạt động.
Tiện ích bị lỗi giao diện hoặc xung đột?
Một số theme WordPress có thể xung đột với script tiện ích. Chuyển sang chế độ nhúng iframe bằng cách thêm embed="iframe" vào shortcode.
Danh sách tiền tệ bị ẩn hoặc cắt?
Điều này xảy ra khi phần tử chứa có overflow:hidden. Hãy dùng nhúng iframe hoặc chỉnh CSS của theme để cho phép overflow.
Tiện ích hiển thị tỷ giá cũ?
Tỷ giá được cập nhật tự động. Nếu bạn dùng plugin cache, hãy loại trừ script tiện ích khỏi cache hoặc xóa cache sau khi thay đổi.
Cần hỗ trợ?
Không tìm thấy thông tin bạn cần? Đội ngũ hỗ trợ của chúng tôi luôn sẵn sàng giúp đỡ.
