relations widgets for backpack

Widgets de relações com mochila Laravel

1. Instalação
2. Capturas de tela
3. Características
4. Documentação
5. Uso
6. Como habilitar a criação de modelo relacionado

3.0 O que há de novo:

• entrada de pesquisa de relação_tabela
• botão de criação de relação_tabela com referência de atributo de relação
• paginação de relação_tabela

Instalação

 composer require izica/relations-widgets-for-backpack

Capturas de tela

Características

• use widgets para mostrar relações na operação show
• mostrar ou ocultar painéis ou campos por condições
• construir valor do campo por fechamento
• use a notação ponto orm para acessar campos de relação

Documentação

• painel_relacionamento

  • name - nome da relação
  • label - etiqueta do painel
  • backpack_crud - URL da mochila crud,
  • buttons (opcional) - defina false para ocultar todos os botões de ação
  • button_show (opcional) - defina false para ocultar
  • button_edit (opcional) - defina false para ocultar
  • visible (opcional) - fechamento para ocultar ou mostrar painel
  • fields (opcional) - array de campos, por padrão obtém colunas fillable no modelo
    • name - nome
    • label - para campo
    • closure - use fechamento em vez do campo de nome,
    • visible (opcional) - fechamento para ocultar ou mostrar painel

• tabela_relação

  • name - (obrigatório) nome da relação
  • label - etiqueta do painel
  • relation_attribute - (opcional) usado para passar o nome do parâmetro de URL para button_create
  • search - closure (opcional), permite entrada de pesquisa
  • per_page - (opcional) ativa a paginação, null por padrão
  • backpack_crud - URL da mochila crud,
  • buttons (opcional) - defina false para ocultar todos os botões de ação
  • button_create (opcional) - defina false para ocultar
  • button_show (opcional) - defina false para ocultar
  • button_edit (opcional) - defina false para ocultar
  • button_delete (opcional) - defina false para ocultar
  • visible (opcional) - closure para ocultar ou mostrar painel
  • columns (opcional) - array de colunas, por padrão obtém colunas fillable no modelo
    • name - nome
    • label - para campo
    • closure - use closure em vez do campo de nome para passar valor,

Uso

Painel de relacionamento

belongsTo , hasOne

 use Backpack  CRUD  app  Library  Widget ;

protected function setupShowOperation ()
{
    Widget:: add ([
        ' type '           => ' relation_panel ' ,
        ' name '           => ' account_contact ' ,
        ' label '          => ' Account contact info ' ,
        ' backpack_crud '  => ' accountcontact ' ,
        ' visible ' => function ( $ entry ){
            return $ entry -> is_public_person ;
        },
        ' buttons ' => false ,
        ' fields '         => [
            [
                ' label ' => ' Birthdate ' ,
                ' closure ' => function ( $ entry ){
                    return date ( ' d.M.Y ' , $ entry -> birthdate );
                }
            ],
            [
                ' label ' => ' Contact phone ' ,
                ' name '  => ' contact_phone ' ,
            ],
            [
                ' label ' => ' Contact email ' ,
                ' name '  => ' contact_email ' ,
            ],
            [
                ' label ' => ' Address ' ,
                ' name '  => ' address.name ' ,
                ' visible ' => function ( $ entry ){
                    return !! $ entry -> address ;
                }       
            ],
        ],
    ])-> to ( ' after_content ' );
}

Tabela de relações

hasMany

 protected function setupShowOperation ()
{
    Widget:: add ([
        ' type '           => ' relation_table ' ,
        ' name '           => ' order_cargos ' ,
        ' label '          => ' Order cargo list ' ,
        ' backpack_crud '  => ' ordercargo ' ,
        ' visible ' => function ( $ entry ){
            return $ entry -> order_cargos -> count () > 0 ;
        },
        ' search ' => function ( $ query , $ search ) {
            return $ query -> where ( ' name ' , ' like ' , " % { $ search } % " );
        },
        ' relation_attribute ' => ' order_id ' ,
        ' button_create ' => true ,
        ' button_delete ' => false ,
        ' columns ' => [
            [
                ' label ' => ' Type ' ,
                ' name '  => ' order_cargo_type.name ' ,
            ],
            [
                ' label ' => ' Weight ' ,
                ' name '  => ' weight ' ,
            ],
            [
                ' label ' => ' Value, $ ' ,
                ' closure ' => function ( $ entry ){
                    return "{ $ entry -> value } $ " ;
                }
            ],
        ],
    ])-> to ( ' after_content ' );
}

Como habilitar a criação de modelo relacionado

Você precisa definir:

• button_create => true
• relation_attribute => attribute_name

Em seguida, você precisa adicionar ao valor default do campo relação/seleção:

    CRUD :: addField ([
        ' type ' => " relationship " ,
        ' name ' => ' order ' ,
        ' default ' => $ _GET [ ' order_id ' ] ?? null
    ]);