relations widgets for backpack

Widgets de relations avec le sac à dos Laravel

1. Installation
2. Captures d'écran
3. Caractéristiques
4. Documentation
5. Usage
6. Comment activer la création d'un modèle associé

3.0 Quoi de neuf :

• entrée de recherche relation_table
• bouton de création relation_table avec référence d'attribut de relation
• pagination relation_table

Installation

 composer require izica/relations-widgets-for-backpack

Captures d'écran

Caractéristiques

• utiliser des widgets pour afficher les relations dans l'opération show
• afficher ou masquer des panneaux ou des champs par conditions
• construire la valeur du champ par fermeture
• utiliser la notation par points pour accéder aux champs de relation

Documentation

• relation_panneau

  • name - nom de la relation
  • label - étiquette du panneau
  • backpack_crud - URL du sac à dos crud,
  • buttons (facultatif) - définissez false pour masquer tous les boutons d'action
  • button_show (facultatif) - définissez false pour masquer
  • button_edit (facultatif) - définissez false pour masquer
  • visible (facultatif) - fermeture pour cacher ou afficher le panneau
  • fields (facultatif) - tableau de champs, par défaut, récupère les colonnes à fillable dans le modèle
    • name - nom
    • label - pour le champ
    • closure - utilisez la fermeture au lieu du champ de nom,
    • visible (facultatif) - fermeture pour cacher ou afficher le panneau

• relation_table

  • name - (obligatoire) nom de la relation
  • label - étiquette du panneau
  • relation_attribute - (facultatif) utilisé pour transmettre le nom du paramètre URL pour button_create
  • search - (facultatif) closure , permet la saisie de la recherche
  • per_page - (facultatif) active la pagination, null par défaut
  • backpack_crud - URL du sac à dos crud,
  • buttons (facultatif) - définissez false pour masquer tous les boutons d'action
  • button_create (facultatif) - définissez false pour masquer
  • button_show (facultatif) - définissez false pour masquer
  • button_edit (facultatif) - définissez false pour masquer
  • button_delete (facultatif) - définissez false pour masquer
  • visible (facultatif) - closure pour cacher ou afficher le panneau
  • columns (facultatif) - array de colonnes, récupère par défaut les colonnes fillable dans le modèle
    • name - nom
    • label - pour le champ
    • closure - utilisez closure au lieu du champ de nom pour transmettre la valeur,

Usage

Panneau des relations

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 ' );
}

Tableau des relations

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 ' );
}

Comment activer la création d'un modèle associé

Vous devez définir :

• button_create => true
• relation_attribute => attribute_name

Ensuite, vous devez ajouter à la valeur default du champ relation/sélection :

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