El id
Type: el_id
Description
Element ID field for setting custom HTML element IDs.
Screenshot
Basic Usage
[
"type" => "el_id",
"heading" => __("Field Label", "your-text-domain"),
"param_name" => "your_param_name",
"description" => __("Field description", "your-text-domain"),
]
Common Parameters
All param types support these common parameters:
| Parameter | Type | Description |
|---|---|---|
type | String | Required. Must be "el_id" |
holder | String | HTML tag name where the value is displayed in backend edit mode. Default: hidden input |
class | String | CSS class added to the holder HTML tag |
heading | String | Label shown in the editor interface |
param_name | String | Required. Parameter name used in shortcode |
value | Mixed | Value for the parameter |
description | String | Help text shown below the field |
group | String | Tab/group name to organize parameters |
section | String | Section slug to visually group params within a tab |
weight | Integer | Display order (higher = shows first) |
edit_field_class | String | CSS class for field width (e.g., "vc_col-sm-6") |
dependency | Array | Show/hide based on other field values |
admin_label | Boolean | Show value in element title bar |
param_holder_class | String | CSS class for the param wrapper in the edit element modal |
save_always | Boolean | Force saving the value even if it equals the default or is empty |
callback | Array | JavaScript function callback (e.g., ['after_add' => 'myCallback']) |
settings | Array | Type-specific configuration options (see Type-Specific Parameters below) |
deprecated | String | Version in which the param was deprecated |
Type-Specific Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
settings | Array | - | Configuration array with the following options: |
auto_generate | Boolean | false | Whether to auto-generate the ID value |
Complete Example
<?php
add_action('vc_before_init', 'my_element_with_el_id');
function my_element_with_el_id() {
vc_map([
"name" => __("My Element", "domain"),
"base" => "my_element",
"category" => __("My Category", "domain"),
"params" => [
[
"type" => "el_id",
"heading" => __("Field Label", "domain"),
"param_name" => "param_name",
"description" => __("Field description", "domain"),
"settings" => ["auto_generate" => true],
],
],
]);
}