Xataface Italia

Utilizzando semplici file di configurazione INI, è possibile personalizzare l'aspetto della vostra applicazione. È possibile modificare i widget, le etichette, le descrizioni dei campi, e altro ancora.

Nelle due sezioni precedenti abbiamo imparato come creare una semplice applicazione per la progettazione un database e quindi di installare la struttura di base per rendere la nostra applicazione operativa. Ora è il momento di "decorare" l'applicazione. La decorazione avviene per mezzo di semplici file di configurazione che sono collocati in posizioni strategiche della applicazione. Siamo in grado di personalizzare le cose come:

• Tipi di widget (ad esempio, utilizzare un elenco di selezione per un campo piuttosto che un campo di testo)
• Etichette (per esempio, l'etichetta del campo ProgramName può essere "Nome del programma" invece di "ProgramName")
• Descrizioni dei campi. È possibile aggiungere descrizioni ai campi per aiutare a spiegare il loro significato e come usare l'applicazione
• Attributi HTML (ad esempio, Creare un campo di testo largo 50 caratteri)

Elenchi di configurazione tabelle

Ricorderete che quando abbiamo usato lo script 'makesite' per generare la struttura di directory per la nostra applicazione web, è stata creata una directory chiamata 'tables', con sottodirectory dopo ciascuna delle tabelle nel database. La struttura di directory dell'applicazione appare come:

Le tabelle  "Program" e "Course" sono riferiti come le "directory di configurazione delle tabelle". Tutti i file di configurazione di una tabella in un'applicazione Xataface sono memorizzati nella directory di configurazione della tabella associata. Ad esempio tutti i file di configurazione per la tabella 'Program' si trova in 'tabella / Program'.

Ci sono 4 file principali che sono generalmente contenuti nella directory di configurazione di una tabella:

• fields.ini - contiene la configurazione per i campi della tabella (ad esempio, le etichette dei campi, le descrizioni, i tipi di widget, ecc ..)
• valuelists.ini - Contiene liste di valori (vocabolari) che possono essere utilizzati nella tabella per limitare l'ingresso in alcuni campi, come elenchi di selezione.
• relationships.ini - Definisce i rapporti tra questa tabella e altre tabelle dell'applicazione.
• <TableName> Php (dove <TableName> è il nome della tabella. Una classe delegata PHP che permette di personalizzare ulteriormente il comportamento della applicazione rispetto a questa tabella che possono contenere campi personalizzati, importare / esportare funzionalità, le autorizzazioni informazioni, e molto altro ...

 Personalizzazione delle etichette e descrizioni

Inizieremo con l'aggiunta di etichette personalizzate e descrizioni alla tabella 'Program' della nostra applicazione 'FacultyOfWidgetry'. Questi tipi di impostazioni di personalizzazione sono collocati in un file chiamato 'fields.ini' all'interno della directory di configurazione della tabella.

1. Creare il file 'fields.ini' nella directory di configurazione delle tabella Program (ad esempio,  tables / Program / fields.ini).
2. Aggiungere il codice seguente al file:

   [ProgramName]
   widget:label = "Program Name"
   widget:description = "Enter the name of the program"

   Ora guardate il modulo "Modifica record" nell'applicazione Xataface:
   <
   
   Notate come l'etichetta per la "ProgramName" ora dice "Program Name" (notare lo spazio tra "Program" e "Name"). E la sua descrizione corrisponde alla descrizione specificata nel file fields.ini.

Il widget: label e il widget: Description possono essere definiti per ogni campo in ogni tabella della applicazione

Utilizzare diversi widgets

Se nessun widget sono definiti nel file fields.ini, un'applicazione Xataface farà una ipotesi migliore al tipo di widget che deve essere utilizzato per modificare il valore in un campo. In generale, i widget utilizzati per default sono le seguenti:

• VARCHAR, CHAR, INT: campo di testo HTML
• DATE, DATETIME fields: widget Calendario
• TEXT fields : area di testo html
• BLOB fields : campo di upload file html
• INT Fields with "AUTO INCREMENT" : campo nascosto html
• VARCHAR or CHAR fields con "Password" o "password" come parte del nome: campo password html
• ENUM fields : lista di selezione

È possibile modificare il widget che viene utilizzato per modificare un campo specificando "widget: tipo" attributo per il campo nel file fields.ini. Per ulteriori informazioni su i widget disponibili, vedere la: pagina dei tipi di Widget.