Mở rộng Trình tùy chỉnh chủ đề WordPress

  1. 1. Giới thiệu về Trình tùy biến chủ đề WordPress
  2. 2. Tương tác với tùy biến chủ đề WordPress
  3. 3. WordPress nồi hơi tùy biến chủ đề
  4. 4. Hiện đang đọc: Mở rộng Trình tùy chỉnh chủ đề WordPress
  5. 5. Nồi hơi tùy biến chủ đề – Tùy chọn có điều kiện, Chủ đề con và Plugin

Phần 3 của loạt Trình tùy chỉnh chủ đề đã giới thiệu cho bạn Trình tạo nồi hơi tùy biến chủ đề cho phép bạn đơn giản hóa mã xử lý các tùy chọn chủ đề của mình. Tất cả những gì bạn cần làm là vượt qua một loạt các trường tùy chọn và bản tóm tắt sẽ đảm nhiệm việc đăng ký các phần, cài đặt và điều khiển của Theme Customizer cho bạn phía sau hậu trường.


Cho đến bây giờ, bản tóm tắt cho phép bạn sử dụng các trường văn bản, hộp kiểm, nút radio và chọn các trường trong Tùy biến chủ đề, bài viết này cho bạn thấy cách bạn có thể mở rộng nó.

Lưu ý: Trước khi tiếp tục, vui lòng tải xuống phiên bản mới nhất của Trình tạo tùy chỉnh chủ đề WordPress từ kho lưu trữ Github của nó. Tôi đã thực hiện một số cải tiến cho nó kể từ hướng dẫn trước và điều quan trọng là mã của bạn được cập nhật. Hãy xem bài viết trước để biết thêm ghi chú về các thay đổi, nhưng tóm lại, một khi bạn sao chép bản soạn thảo vào thư mục chủ đề của mình, bạn không cần phải chỉnh sửa các tệp của nó – tất cả việc chỉnh sửa được thực hiện bằng cách sử dụng bộ lọc và móc hành động.

Kết nối với nồi hơi tùy biến chủ đề

Có một số móc hành động và bộ lọc trong Trình tạo nồi hơi tùy chỉnh chủ đề WordPress. Bạn có thể nối vào bất kỳ một trong số chúng từ tệp chủ đề. add_actionadd_filter chức năng:

  • ‘Thsp_cbp_directory_uri – Móc lọc được xác định trong helpers.php, cho phép bạn thay đổi vị trí của Trình tùy chỉnh nồi hơi trong thư mục chủ đề của bạn. Theo mặc định, đường dẫn soạn sẵn trông như thế này – get_template_directory_uri (). ‘/ Tùy biến-nồi hơi – nhưng nếu bạn thay vì di chuyển nó đến một vị trí tùy chỉnh, thì đây là cái móc có thể giúp bạn.
  • ‘Thsp_cbp_menu_link bản – Bộ lọc móc được xác định trong helpers.php, cho phép bạn thay đổi liên kết văn bản Menu. Boilerplate thêm một liên kết dưới Giao diện trong bảng điều khiển WordPress, cho phép người dùng dễ dàng truy cập vào Theme Customizer. Theo mặc định, liên kết đó sẽ cho biết Tùy chỉnh chủ đề của chủ đề và bạn có thể thay đổi văn bản bằng cách sử dụng hook bộ lọc _c thsp_cbp_menu_link lòng hồi.
  • ‘Thsp_cbp_capability – Móc lọc được định nghĩa trong helpers.php. Cho phép bạn thay đổi khả năng yêu cầu mặc định được sử dụng trong phương thức $ wp_customize-> add_setting.
  • ‘Thsp_cbp_option – Móc lọc được định nghĩa trong helpers.php. Nếu bạn sử dụng tùy chọn ’Tùy chọn trong các đối số cài đặt của bạn, hãy sử dụng móc này để thay đổi tên của mục nhập, các giá trị cài đặt chủ đề của bạn sẽ được lưu trữ trong bảng wp_options. Giá trị mặc định là ‘thsp_cbp_theme_options, hãy đảm bảo bạn móc vào cái này và thay đổi nó thành cái gì đó có tên chủ đề của bạn trong đó.
  • ‘Thsp_cbp_options_array – Bộ lọc móc được xác định trong tùy chọn.php, bạn PHẢI móc vào nó và thay thế mảng tùy chọn mặc định (chứa tùy chọn mẫu) bằng các tùy chọn được sử dụng trong chủ đề của bạn. Tôi sẽ lặp lại điều đó, in đậm và gạch chân nó: You PHẢI móc vào nó và thay thế mảng tùy chọn mặc định bằng các tùy chọn được sử dụng trong chủ đề của bạn.
  • ‘Thsp_cbp_custom_controls – Hành động hook được xác định trong custom-controls.php, bằng cách móc vào nó, bạn có thể tạo các điều khiển tùy chỉnh của riêng mình, tiếp tục đọc để xem ví dụ về cách thực hiện.
  • Tshp_cbp_remove_sectionsTshp_cbp_remove_controlsTshp_cbp_remove_sinstall – Móc lọc được xác định trong customizer.php. Bạn có thể chuyển cho họ các mảng ID phần tích hợp (hoặc ID điều khiển hoặc ID cài đặt) để xóa một số phần, điều khiển hoặc cài đặt tích hợp.

Lưu ý: Mặc dù chúng tôi có khả năng mở rộng và tạo các móc nối của riêng bạn để các nhà phát triển khác có thể sử dụng chúng để mở rộng mã của bạn, nhưng không thể nói quá tầm quan trọng của việc này. Sau tất cả, đó là cách thức hoạt động của WordPress (cốt lõi). Và tôi không thể cảm ơn Pippin và của anh ấy bài viết đủ để đưa ý tưởng này vào đầu tôi.

Điều khiển tùy chỉnh

Phiên bản cập nhật của Trình tùy chỉnh chủ đề (mà bạn vừa kiểm tra, phải không?) Có thêm một số điều khiển bạn có thể sử dụng – trường textarea, trường số HTML5 và trường hình ảnh, về cơ bản là phiên bản ưa thích của các nút radio.

Các điều khiển tùy chỉnh này được xác định trong custom-controls.php, tôi đã thắng qua tất cả chúng ở đây, nhưng hãy để Lọ xem một (trường số HTML5) để xem tất cả hoạt động như thế nào:

/ **
* Tạo điều khiển Tùy biến cho trường đầu vào [type = number]
*
* @since Theme_Customizer_Boilerplate 1.0
* /
lớp CBP_Customizer_Number_Control mở rộng WP_Customize_Control {

công khai $ type = 'số';

hàm công khai render_content () {
tiếng vang '';
}

}

Như bạn có thể thấy, tất cả những gì bạn cần làm là xác định loại điều khiển mới $ và chức năng render_content của nó, điều này tạo ra điều khiển trong màn hình Tùy biến chủ đề.

Sử dụng các điều khiển tùy chỉnh tích hợp nồi hơi nồi hơi

Nó giống như các trường đơn giản được trình bày trong hướng dẫn trước, điều duy nhất bạn cần biết là các loại bạn cần sử dụng cho mỗi loại:

  • Trường số – ‘con số’
  • Trường văn bản – ‘Textarea
  • Hình ảnh hoạt động như các nút radio – Hình ảnh_radio, Đây là một ví dụ về kiểm soát này trong một bản miễn phí sắp tới Chủ đề Cazuela:

Chủ đề tùy biến nồi hơi

Biết tên của các loại điều khiển mới này, thêm một loại dễ dàng. Ở đây, cách bạn có thể thêm một điều khiển trường số vào mảng chứa tất cả các tùy chọn của bạn:

/ *
* ============
* ============
* Trường số
* ============
* ============
* /
'new_number_field' => mảng (
'settings_args' => mảng (
'mặc định' => '',
'loại' => 'tùy chọn',
'khả năng' => $ thsp_cbp_capability,
'vận chuyển' => 'làm mới',
),
'control_args' => mảng (
'nhãn' => __ ('Số', 'my_theme lòng địa chỉ'),
'gõ' => 'số', // Điều khiển Textarea
'ưu tiên' => 8
)
)

Lưu ý: Nếu bạn không chắc chắn nên thêm phần này vào đâu, hãy kiểm tra bằng cách sử dụng mảng tùy chọn để thêm phần tùy chỉnh, cài đặt và điều khiển phần của phần 3 của loạt bài này. Ngoài ra, có một mẫu cho mỗi một điều khiển tùy chỉnh trong tệp tùy chọn.php.

Thêm điều khiển tùy chỉnh của riêng bạn

Hãy để lại cho quay lại ‘thsp_cbp_custom_controls Móc hành động của tôi đã đề cập trước đó:

/ **
* Móc hành động cho phép bạn tạo các điều khiển của riêng mình
* /
do_action ('thsp_cbp_custom_controls');

Nó có một hook hành động WordPress đơn giản cho phép bạn thêm các điều khiển tùy chỉnh của riêng mình mà không cần sửa đổi các tệp Boilerplate của Theme Customizer. Tại sao bạn muốn tránh chỉnh sửa chúng? Bởi vì nếu thay vào đó, bạn sẽ móc vào nồi hơi, bất cứ khi nào ai đó cập nhật nó, bạn có thể lấy phiên bản mới nhất, thả nó vào chủ đề của bạn và không làm mất các thay đổi bạn đã thực hiện. Hãy suy nghĩ chỉnh sửa các tệp cốt lõi của WordPress so với viết plugin, chỉnh sửa chủ đề so với tạo chủ đề con, v.v..

Nếu bạn cần thêm các điều khiển tùy chỉnh của riêng mình, đây là cách bạn có thể làm điều đó:

chức năng my_theme_add_customizer_boilerplate_control () {
/ **
* Tạo điều khiển tùy chỉnh để sử dụng với Trình tùy chỉnh chủ đề nồi hơi
* Sử dụng tiền tố lớp duy nhất!
*
* @since Theme_Customizer_Boilerplate 1.0
* /
lớp CBP_Customizer_My_Control mở rộng WP_Customize_Control {

công khai $ type = 'my_type'; // Thay đổi cai nay đi

hàm công khai render_content () {
// Kiểm soát đầu ra ở đây
}

}
}
add_action ('thsp_cbp_custom_controls', 'my_theme_add_customizer_boilerplate_control');

Hãy chắc chắn rằng bạn đặt tiền tố cho lớp điều khiển tùy chỉnh của mình với một cái gì đó độc đáo, vì vậy tên của nó không xung đột với một lớp khác. Tôi đã sử dụng ‘CBP_, (Trình tùy chỉnh nồi hơi) – vì bạn sử dụng nồi hơi trong một chủ đề, tên chủ đề của bạn rất có ý nghĩa và sẽ hoạt động tốt với bạn.

Tùy biến chủ đề: Điều gì tiếp theo?

Giờ đây, Trình tạo nồi hơi tùy biến chủ đề WordPress có thể mở rộng thông qua các móc nối, chúng tôi sẽ xem xét để thêm các tùy chọn chủ đề có điều kiện của LINE.

Bạn nghĩ gì về Customizer Boilerplate cho đến nay? Bạn có kế hoạch sử dụng nó trong chủ đề của bạn? Bất kỳ ý tưởng về làm thế nào nó có thể được cải thiện? Phản hồi của bạn luôn được chào đón.

Jeffrey Wilson Administrator
Sorry! The Author has not filled his profile.
follow me
    Like this post? Please share to your friends:
    Adblock
    detector
    map