Xin chào các bạn. Trong các bài viết trước Cách tạo mới element trong Visual Composer mình đã hướng dẫn các bạn cách tạo mới một Element
trong Visual Composer
. Nhưng đó là khi chúng ta có nhu cầu viết 1 element
mới hoàn toàn. Vậy các element
có sẵn của Visual Composer
thì sao. Là một plugin khá nổi tiếng cho WordPress
. Visual Composer cũng mang đến cho người dùng sự tiện ích của nó. Với khá nhiều các element được định nghĩa sẵn. Nhưng nó đã đủ cho nhu cầu chưa, có lẽ với các bạn developer thì nó sẽ cần thêm một vài parameter
nữa cho đầy đủ hơn. Hôm nay mình xin giới thiệu các bạn cách thêm options cho các element có sẵn.
1 – Cách Sử dụng
Trước tiên thì chúng ta cần xác định được element nào cần thêm parameter
. Ví dụ chúng ta cần thêm 2 parameter có thể chọn được icon và nhập sub title cho heading.
Hãy tạo cấu trúc cho parameter với tên Custom heading icon
. Chúng ta sẽ có đoạn code như sau:
// Add Params for custom heading array( "type" => "attach_image", "heading" => esc_html__("Custom heading icon image", 'life-churches'), "param_name" => "image", 'description' => esc_html__('Choose image', 'life-churches'), ), array( 'type' => 'textarea', 'heading' => esc_html__('Sub Title', 'life-churches'), 'param_name' => 'sub_title', 'std' => '', 'description' => esc_html__('Subtitle as short description of box', 'life-churches') ),
Đoạn code trên đang khai báo 2 parameter là Custom heading icon image
và Sub Title
với:
type
là attach_image (các bạn có thể tìm các type được định nghĩa sẵn ở đây)heading
là tên của parameterparam_name
là name space của parameter để truy vấndescription
là mô tả của parameter
2 – Sử dụng Shortcode
Sau khi đã tạo được cấu trúc của các parameter
. Chúng ta sẽ add các parameter đó vào shortcode tương ứng của element. Ví dụ:
// VC add custom params if(function_exists('vc_add_params')){ vc_add_params('vc_custom_heading', $params_custom_heading); }
Hãy kiểm tra kết quả sau khi đã add các parameter vào shortcode
. như vậy là đã add thành công các parameter vào trong shortcode của Custom Heading
3 – Gọi giá trị của parameter trong template
Sau khi đã add thành công các parameter
vào shortcode
. Chúng ta phải gọi value của các parameter
vào template
để hiển thị ra front-end. Hãy tìm file templates của element và overide vào template
(Để khi update plugin sẽ không ảnh hưởng đến phần custom). Overide file vc_custom_heading.php
vào trong template với cấu trúc folder themename/vc_templates/vc_custom_heading.php
$output = '<div class="dgt-custom-heading">'; if ($atts['icon']) { $output .= '<span class="dgt-heading-icon">'; $output .= '<img src="' . esc_url($heading_icon_image['url']) . '" width="'. esc_attr($heading_icon_image['width']) .'" height="'. esc_attr($heading_icon_image['height']) .'" alt="' . esc_html__('Icon Heading', 'life-churches') . '" />'; $output .= '</span>'; } if ($atts['sub_title'] != '') { $output .= '<p class="dgt-sub-title">' . wp_kses($atts['sub_title'], array('br' => array())) . '</p>'; } $output .= '</div>'; echo $output;
3 – Hiển thị kết quả
Sau khi đã thêm các parameter vào shortcode của element tương ứng và gọi value vào templates. Hãy kiểm tra xem nó đã hiển thị ngoài front-end hay chưa. Bạn thử set icon image và fill text cho sub title. Như vậy là chúng ta đã add thành công parameter cho element Visual Composer. các bạn có thể tham khảo thêm ở đây để tìm hiểu thêm về plugin này. Chúc các bạn thành công