WordFence

🏠 Root / home / artorgp / www / wp-content / plugins / advanced-custom-fields / schemas / fields / v1 /

Editing: select.json

{
    "$schema": "http://json-schema.org/draft-07/schema#",
    "type": "object",
    "additionalProperties": false,
    "properties": {
        "label": {
            "type": "string",
            "description": "The field label displayed in the edit screen",
            "minLength": 1
        },
        "type": {
            "type": "string",
            "enum": [
                "select"
            ],
            "description": "Field type identifier. Must be \"select\" for this field type."
        },
        "name": {
            "type": "string",
            "description": "The field name used to save/load data. Auto-generated from label if not provided.",
            "pattern": "^[a-z_][a-z0-9_]*$"
        },
        "key": {
            "type": "string",
            "description": "Unique field key. Auto-generated if not provided.",
            "pattern": "^field_[a-z0-9]+$"
        },
        "instructions": {
            "type": "string",
            "description": "Instructions displayed to editors below the field label"
        },
        "required": {
            "type": "boolean",
            "description": "Whether this field is required",
            "default": false
        },
        "conditional_logic": {
            "type": [
                "boolean",
                "array"
            ],
            "description": "Conditional logic rules. Set to false to disable, or provide rules array.",
            "default": false
        },
        "wrapper": {
            "type": "object",
            "description": "HTML wrapper attributes",
            "properties": {
                "width": {
                    "type": "string",
                    "description": "Width percentage (e.g., \"50\")"
                },
                "class": {
                    "type": "string",
                    "description": "Custom CSS classes"
                },
                "id": {
                    "type": "string",
                    "description": "Custom HTML ID"
                }
            }
        },
        "default_value": {
            "type": [
                "string",
                "number",
                "boolean",
                "null"
            ],
            "description": "Default value when creating new content"
        },
        "placeholder": {
            "type": "string",
            "description": "Placeholder text shown in empty fields"
        },
        "prepend": {
            "type": "string",
            "description": "Text to prepend before the input"
        },
        "append": {
            "type": "string",
            "description": "Text to append after the input"
        },
        "maxlength": {
            "type": "integer",
            "description": "Maximum character length (if applicable)",
            "minimum": 1
        },
        "allow_in_bindings": {
            "type": "boolean",
            "description": "Whether this field can be used in block bindings",
            "default": false
        },
        "choices": {
            "type": "object",
            "description": "Available choices for the select field. Object with key-value pairs where keys are saved values and values are display labels (e.g., {\"red\": \"Red\", \"blue\": \"Blue\"})"
        },
        "multiple": {
            "type": "boolean",
            "description": "Allow multiple selections",
            "default": false
        },
        "allow_null": {
            "type": "boolean",
            "description": "Allow a null (empty) value to be selected",
            "default": false
        },
        "ui": {
            "type": "boolean",
            "description": "Use enhanced Select2 UI for better usability",
            "default": false
        },
        "ajax": {
            "type": "boolean",
            "description": "Load choices dynamically via AJAX (useful for large choice sets)",
            "default": false
        },
        "return_format": {
            "type": "string",
            "description": "Format of returned value",
            "enum": [
                "value",
                "label",
                "array"
            ],
            "default": "value"
        },
        "create_options": {
            "type": "boolean",
            "description": "Allow users to create new choices from the field",
            "default": false
        },
        "save_options": {
            "type": "boolean",
            "description": "Save new choices created by users back to the field",
            "default": false
        }
    },
    "required": [
        "label",
        "type",
        "choices"
    ]
}