Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.
Both sides previous revision Previous revision Next revision | Previous revision | ||
creare_un_nuovo_strumento [11/07/2010 18:05] |
creare_un_nuovo_strumento [16/11/2015 15:50] (versione attuale) Massimo Colombi Revisione della creazione di uno strumento |
||
---|---|---|---|
Linea 12: | Linea 12: | ||
---- | ---- | ||
\\ | \\ | ||
- | **Esempio: creazione di uno strumento chiamato "Calendar".**\\ | + | **Esempio: creazione di uno strumento chiamato "Calendars".**\\ |
- Creazione delle CARTELLE relative allo strumento: | - Creazione delle CARTELLE relative allo strumento: | ||
- | - home/app/apis/CALENDAR: contiene le api specifiche del nuovo strumento | + | - home/app/apis/calendars: contiene le api specifiche del nuovo strumento |
- | - home/app/views/CALENDAR: contiene i files che permettono la visualizzazione dello strumento | + | - home/app/views/calendars: contiene i files che permettono la visualizzazione dello strumento |
- Creazione dei FILES relativi allo strumento: | - Creazione dei FILES relativi allo strumento: | ||
- | - home/app/models/CALENDAR.PHP: viene definita la classe CALENDAR e si specificano le sue dipendenze con altre classi. | + | - home/app/models/calendar.php: viene definita la classe Calendar e si specificano le sue dipendenze con altre classi. |
- | - home/app/controllers/CALENDAR_CONTROLLERS.PHP: viene definito il controller di CALENDAR. Le sue funzioni dipendono dalla tipologia dello strumento e da ciò che lo stesso deve svolgere; presumibilmente, se lo strumento CALENDAR dovesse servire a creare un nuovo calendario con gli impegni di ogni utente, nel file //calendar_controllers.php// sarebbero racchiuse - tra le altre - le funzioni //create// ed //edit// che gestirebbero la creazione e modifica di un nuovo calendario per ogni singolo utente. | + | - home/app/controllers/calendars_controller.php: viene definito il controller di Calendar. Le sue funzioni dipendono dalla tipologia dello strumento e da ciò che lo stesso deve svolgere; presumibilmente, se lo strumento Calendar dovesse servire a creare un nuovo calendario con gli impegni di ogni utente, nel file //calendars_controller.php// sarebbero racchiuse - tra le altre - le funzioni //create// ed //edit// che gestirebbero la creazione e modifica di un nuovo calendario per ogni singolo utente. |
- | - home/app/strings/ita/CALENDAR.TPL: file che racchiude le coppie 'identificatore-stringa italiana' per il controller e per le view dello strumento. | + | - home/app/strings/ita/calendars.tpl: file che racchiude le coppie 'identificatore-stringa italiana' per il controller e per le view dello strumento. |
- | - home/app/strings/eng/CALENDAR.TPL: file che racchiude le coppie 'identificatore-stringa inglese' per il controller e per le view dello strumento. | + | - home/app/strings/eng/calendars.tpl: file che racchiude le coppie 'identificatore-stringa inglese' per il controller e per le view dello strumento. |
- | - home/app/apis/CALENDAR/CALENDAR_API_CONTROLLER.PHP: file contenente le funzioni che permettono allo strumento di interfacciarsi con gli altri moduli. | + | - home/app/apis/calendars/calendars_api_controller.php: file contenente le funzioni che permettono allo strumento di interfacciarsi con gli altri moduli. |
- | - home/app/apis/CALENDAR/CALENDAR_API_VIEW.PHP: file contenente la classe CalendarApiView che estende ApiView. | + | - home/app/apis/calendars/calendars_api_view.php: file contenente la classe CalendarApiView che estende ApiView. |
- | - home/app/apis/CALENDAR/CALENDAR_EVENT_HANDLERS.XML: file xml nel quale sono riportati gli eventi ai quali risponde lo strumento stesso. | + | - home/app/apis/calendars/calendars_event_handlers.xml: file xml nel quale sono riportati gli eventi ai quali risponde lo strumento stesso. |
- | Ci sono poi dei files e delle cartelle che vengono create solo se lo strumento ne richiede l'utilizzo, come la cartella //home/app/apis/CALENDAR/VIEWS// con i file //.tpl// delle viste relative alle api.\\ | + | Ci sono poi dei files e delle cartelle che vengono create solo se lo strumento ne richiede l'utilizzo, come la cartella //home/app/apis/calendars/views// con i file //.tpl// delle viste relative alle api.\\ |
- | All'interno di //home/app/views/CALENDAR// vanno inseriti i file //.tpl// che gestiscono la vista dei componenti dello strumento (come ad esempio edit.tpl, create.tpl, addstep.tpl etc...); questi file quindi dipendono dalla struttura dello strumento stesso.\\ | + | All'interno di //home/app/views/calendars// vanno inseriti i file //.tpl// che gestiscono la vista dei componenti dello strumento (come ad esempio edit.tpl, create.tpl, addstep.tpl etc...); questi file quindi dipendono dalla struttura dello strumento stesso.\\ |
---- | ---- | ||
Linea 109: | Linea 109: | ||
---- | ---- | ||
\\ | \\ | ||
- | Infine vale la pena citare i moduli con i quali gli strumenti vengono in contatto più di frequente e le ripettive funzioni per invocarli.\\ | ||
- | \\ | ||
- | Modulo USERS:\\ | ||
+ | All'interno del controller che gestisce il nuovo strumento, per utilizzare le API relative agli strumenti con i quali relazionarsi, basta richiamare le stesse attraverso la funzione "loadApi()". | ||
+ | Riportiamo qui di seguito l'esempio di come lo strumento 'Infodisc' richiama le API del modulo wikitool:\\ | ||
+ | |||
+ | [...] | ||
+ | $this->loadApi('Wikitool'); | ||
+ | $wiki=$this->WikitoolApi->getWikiFor('Infodisc',$id); | ||
+ | $this->set('wiki',$wiki ); | ||
+ | [...] | ||
+ | \\ | ||
+ | \\ | ||
+ | \\ | ||
+ | \\ | ||
+ | [[gli strumenti | indietro]] - [[il modello generale | avanti]] |