OctoberCMS/WinterCMS关联记录拖拽排序配置无效求助

要让关联记录的拖拽排序生效，你需要满足几个核心前提，之前的配置问题大概率出在这些环节：

1. 数据库表必须包含结构字段 #

关联的Ticket模型对应的数据库表，必须添加以下字段（如果是普通排序而非树形结构，至少需要sort_order）：

• parent_id（可选，仅树形结构需要）
• sort_order（必填，存储排序值）
• nest_left、nest_right、nest_depth（树形结构必填）

2. 模型需启用Structure行为 #

在Ticket模型的代码中，必须引入StructureController行为：

class Ticket extends Model
{
    public $implement = [
        'Backend.Behaviors.ModelController',
        'Backend.Behaviors.StructureController' // 这行必须加
    ];

    // 可选：如果需要单独配置结构行为，可指向对应的配置文件
    // public $structureConfig = 'config_structure.yaml';

    // ... 其他模型逻辑
}

3. 关联配置的正确位置 #

structure配置必须放在view节点下，正确的config_relation.yaml示例：

# ===================================
#  Relation Behavior Config
# ===================================

tickets:
    label: 'cashless.events::lang.relations.tickets'
    view:
        list: $/cashless/events/models/ticket/columns.yaml
        toolbarButtons: create|delete
        structure:   
            showTree: false  # 非树形结构设为false，树形则设为true
            showReorder: true
            maxDepth: 2          
            dragRow: true
    manage:
        form: $/cashless/events/models/ticket/fields.yaml
        recordsPerPage: 10

4. 列表列（columns.yaml）配置 #

在Ticket模型的columns.yaml中，需要包含排序相关列，或者直接使用结构列：

# $/cashless/events/models/ticket/columns.yaml
columns:
    name:
        label: 'cashless.events::lang.ticket.name'
    # 方式1：显示sort_order字段（可选，可设为invisible隐藏）
    sort_order:
        label: '排序'
        type: number
        invisible: true
    # 方式2：使用内置的结构列（树形结构推荐）
    # _structure:
    #     label: '结构'
    #     type: structure

5. 清理缓存 #

修改配置后必须清理系统缓存：

• 后台路径：设置 → 清理缓存
• 命令行执行：

  # OctoberCMS
  php artisan cache:clear
  php artisan october:cache
  # WinterCMS
  php artisan cache:clear
  php artisan winter:cache
  

按以上步骤检查调整后，关联列表的拖拽排序选项应该就能正常显示了。

内容的提问来源于stack exchange，提问作者Crazy