.. _tutor/architettura/menu/directoryBranch:

directoryBranch
===============




Il *directoryBranch* permette di costruire **dinamicamente** un branch basato sul contenuto della cartella *webpages* di un `Package <https://www.genropy.org/docs/genropy_orm/model/package.html>`_. Le voci contenute nel nuovo ramo saranno le singole pagine::

  class Menu(object):
    def config(self,root):
        root.directoryBranch("Test", pkg="test", folder='batch')
                                
Si noti che è possibile specificare una ``folder``, che permetterà di inserire nel ramo solo le *webpages* contenute nella cartella indicata. Se omesso verrà preso l'intero contenuto della cartella *webpages*. Se omesso il *pkg* verrà considerato il package corrente.

.. raw:: html

 <hr>

**Parametri:**

+------------------------+------+--------------------------------------------------+
|     Nome parametro     | Tipo |                   Descrizione                    |
+========================+======+==================================================+
|checkpref               |T     |Permette di mostrare la voce di menu o il branch  |
|                        |      |solo se rispettata una determinata condizione     |
|                        |      |espressa nelle preferenze, nella forma            |
|                        |      |"pkg.nomepreferenza" (es:                         |
|                        |      |checkpref='adm.gestione_utenti_nel_menu')         |
+------------------------+------+--------------------------------------------------+
|checkenv                |T     |Permette di mostrare la voce di menu o il branch  |
|                        |      |solo se rispettata una determinata condizione     |
|                        |      |espressa nell'environment (es:                    |
|                        |      |checkenv='deposito_id')                           |
+------------------------+------+--------------------------------------------------+
|newPanel                |B     |Se impostato a True la voce di menu si aprirà in  |
|                        |      |un nuovo tab del browser                          |
+------------------------+------+--------------------------------------------------+
|newWindow               |B     |Se impostato a True la voce di menu si aprirà in  |
|                        |      |una nuova finestra del browser                    |
+------------------------+------+--------------------------------------------------+
|pkg                     |T     |Il package a cui si riferisce il branch (es:      |
|                        |      |pkg='test')                                       |
+------------------------+------+--------------------------------------------------+
|folder                  |T     |La sottocartella di "webpages" con la quale       |
|                        |      |costruire il menu (es: folder='batch')            |
+------------------------+------+--------------------------------------------------+
|                               *Common Parameters*                                |
+------------------------+------+--------------------------------------------------+
|label                   |T     |Solitamente implicito, si riferisce all'etichetta |
|                        |      |della voce di menu                                |
+------------------------+------+--------------------------------------------------+
|tags                    |T     |Permette di indicare i tag utente a cui le pagine |
|                        |      |sono riservate (es: tags='admin')                 |
+------------------------+------+--------------------------------------------------+

.. sectionauthor:: Davide Paci