WP Manifestindependent plugin directory
manifest / media / wp-slider

FDA Slider

Plugin WordPress tạo slider. Nền, nội dung, ảnh, kiểu chữ và nút có thể tùy biến cho từng slide, sau đó chèn vào trang bằng shortcode.

★ 0stars

Install

Download source zip No release zip yet

This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.

Install straight from GitHub with WP-CLI:

wp plugin install https://github.com/fda-cada/wp-slider/archive/refs/heads/main.zip
No built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.

Plugin WordPress tạo slider giới thiệu chương trình đào tạo. Nền, nội dung, ảnh, kiểu chữ và nút có thể tùy biến cho từng slide, sau đó chèn vào trang bằng shortcode.

  • Phiên bản: 1.0.0
  • Yêu cầu: WordPress 6.3 trở lên, PHP 7.4 trở lên
  • Giấy phép: GPL-2.0-or-later

Cài đặt

  1. Chép thư mục fda-slider vào wp-content/plugins/, hoặc nén thành .zip rồi tải lên ở Plugin → Cài plugin → Tải plugin lên. Plugin không cần bước build.
  2. Kích hoạt plugin. Menu FDA Slider sẽ xuất hiện trong trang quản trị.

Lần kích hoạt đầu tiên, plugin tạo sẵn slider "Chương trình đào tạo" gồm 4 slide lấy từ nội dung của website FDA. Slider này có thể sửa hoặc xóa như mọi slider khác và sẽ không được tạo lại khi kích hoạt lần sau.

Sử dụng

  1. Vào FDA Slider → Thêm slider, đặt tên và thêm các slide.

  2. Bấm Đăng. Khung Cách chèn sẽ hiện shortcode và nút Xem trước.

  3. Dán shortcode vào trang, widget hoặc khối Shortcode:

    [fda_slider id="123"]

Shortcode của mỗi slider cũng được hiển thị trong danh sách Tất cả slider. Trong file template của theme, có thể gọi:

echo do_shortcode( '[fda_slider id="123"]' );

Một trang có thể chứa nhiều slider. Slider chỉ hiển thị khi đã được đăng và có ít nhất một slide. Nút Xem trước dùng được cả với bản nháp, nhưng luôn hiển thị nội dung đã lưu gần nhất.

Các tùy chọn

Từng slide

Thẻ Nội dung
Nội dung Dòng nhỏ phía trên, tên trên thanh điều hướng, tiêu đề, mô tả, căn chữ, các số liệu, nút chính và nút phụ
Nền Màu đơn, chuyển màu hoặc ảnh. Nền ảnh có thêm vị trí ảnh và lớp phủ màu
Ảnh Ảnh đặt bên trái hoặc phải, kiểu hiển thị, chiều rộng (30–70%), vùng ưu tiên khi cắt
Chữ & nút Màu, cỡ chữ và độ đậm riêng cho slide này

Các slide có thể kéo để đổi thứ tự, nhân bản hoặc xóa.

Tiêu đề cho phép dùng <br>, <em>, <strong>. Mô tả cho phép thêm thẻ <a>. Nút chỉ hiển thị khi có cả chữ và liên kết. Văn bản thay thế (alt) của ảnh lấy từ Thư viện Media.

Giao diện chung

Đặt phông chữ, màu và kích thước mặc định cho cả slider, cùng màu của thanh điều hướng. Có 11 phông Google Fonts hỗ trợ tiếng Việt, hoặc dùng phông của theme. Khi chọn Google Fonts, trình duyệt của khách truy cập sẽ tải phông từ fonts.googleapis.com.

Giá trị kiểu được lấy theo thứ tự: slide → slider → mặc định trong stylesheet. Ô để trống nghĩa là kế thừa từ cấp tiếp theo.

Cài đặt

Tùy chọn Mặc định Giới hạn
Tự động chuyển slide Bật
Dừng khi rê chuột Bật
Thời gian mỗi slide 7 giây 2–60
Hiệu ứng chuyển Mờ dần Mờ dần, trượt ngang, không có
Thời lượng hiệu ứng 600 ms 100–2000
Chiều cao tối thiểu 100% màn hình 30–100
Chiều rộng tối đa của nội dung 1240 px 800–2000
Điều hướng Tab có tên slide Tab, vạch ngắn, ẩn
Mũi tên trước/sau Bật
Số thứ tự (01 / 04) Tắt
Thẻ H1 cho tiêu đề slide đầu Tắt Chỉ bật khi trang chưa có H1 nào khác

Tiêu đề các slide còn lại luôn dùng H2. Slider chỉ có một slide thì không hiện thanh điều hướng.

Hành vi trên trang

  • Người xem có thể chuyển slide bằng tab, mũi tên, phím ← → (khi con trỏ bàn phím đang ở trong slider) hoặc vuốt trên màn hình cảm ứng.
  • Khi tự động chuyển đang bật, slider có nút tạm dừng. Slider cũng tạm dừng khi tab trình duyệt bị ẩn hoặc khi người dùng di chuyển bằng bàn phím trong slider.
  • Nếu hệ điều hành đặt chế độ giảm chuyển động (prefers-reduced-motion), slider tắt hiệu ứng và không tự chuyển.
  • Slide đầu tiên tải ảnh ngay với độ ưu tiên cao, các slide sau tải ảnh theo kiểu lazy.

Dành cho lập trình viên

Cấu trúc

fda-slider.php                        Khai báo plugin, nạp các class, đăng ký hook
includes/class-fda-slider-schema.php  Post type, giá trị mặc định, token kiểu, làm sạch dữ liệu
includes/class-fda-slider-admin.php   Màn hình sửa slider, cột danh sách, trang xem trước
includes/class-fda-slider-frontend.php Shortcode và HTML hiển thị
includes/class-fda-slider-seed.php    Tạo slider mẫu khi kích hoạt lần đầu
assets/css/slider.css                 Giao diện slider, gồm giá trị mặc định của biến CSS
assets/js/slider.js                   Hoạt động của slider, không phụ thuộc thư viện
assets/css/admin.css, assets/js/admin.js  Giao diện và thao tác trong trang quản trị

Lưu trữ dữ liệu

Mỗi slider là một bài viết thuộc post type fda_slider, không công khai và dùng quyền của page. Toàn bộ cấu hình nằm trong post meta _fda_slider:

array(
    'settings' => array( /* xem FDA_Slider_Schema::default_settings() */ ),
    'style'    => array( /* token kiểu của cả slider */ ),
    'slides'   => array( /* mỗi phần tử theo FDA_Slider_Schema::default_slide() */ ),
)

Option fda_slider_seeded đánh dấu slider mẫu đã được tạo. Plugin chưa có bước gỡ cài đặt, nên các slider và option này vẫn nằm trong cơ sở dữ liệu sau khi xóa plugin.

Thêm một token kiểu

Mỗi token được xuất thành biến CSS theo quy tắc btn1_hover_bg → --fda-btn1-hover-bg.

  1. Thêm token vào FDA_Slider_Schema::style_groups(), hoặc nav_style_fields() nếu token chỉ áp dụng cho cả slider. Kiểu hợp lệ là color, px và weight. Biểu mẫu quản trị và bước làm sạch dữ liệu sẽ tự cập nhật theo.
  2. Khai báo giá trị mặc định của biến trong .fda-slider ở assets/css/slider.css, rồi dùng biến đó trong CSS.

Slider chèn sau khi tải trang

Khi HTML của slider được chèn bằng JavaScript (AJAX, popup), hãy khởi tạo lại sau khi chèn. Lệnh này bỏ qua các slider đã khởi tạo:

window.FDASlider.init( container );

slider.js chỉ được nạp trên trang có shortcode chạy phía server, nên trang chỉ có slider chèn động cần tự nạp file này và slider.css.

Phát hành

Khi thay đổi CSS hoặc JS, tăng FDA_SLIDER_VERSION và dòng Version trong fda-slider.php để trình duyệt không dùng file cũ trong bộ nhớ đệm.