Uno sguardo sul mondo del TCA, il Table Configuration Array di TYPO3 che consente di integrare tabelle del database nella gestione di backend di TYPO3.

1. TCA: tips&tricks
Mauro Lorenzutti
T3Camp Italia Bologna 16/17 Novembre 2012
Il terzo evento italiano dedicato a TYPO3

2. Mauro Lorenzutti
CTO di Webformat
Sviluppatore e consulente TYPO3 dal 2004
TYPO3 Certified Integrator dal 2009
Sviluppatore di numerose estensioni, tra cui:
 DB Integration (wfqbe)
 Webformat Shop System (extendedshop)
 TYPO3-Alfresco Connector
 TYPO3-Magento Connector
Contacts:
 mauro.lorenzutti@webformat.com
 www.webformat.com
 http://it.linkedin.com/in/maurolorenzutti
 http://twitter.com/MauroLorenzutti
Mauro Lorenzutti: TCA Tips & Tricks Pag. 2

3. Di cosa parleremo
Introduzione
Campi disponibili
Kickstarter
Type e palette extTables.php
Wizard pageTSConfig
Modulo List
Conclusioni
51 slide….
Mauro Lorenzutti: TCA Tips & Tricks Pag. 3

4. Tanta roba!!!

5. TCA?
TCA: Table Configuration Array
È un array globale che descrive ogni
tabella e ogni campo del database di
TYPO3
Viene usato per generare
automaticamente:
 Le form di inserimento e editing di ogni tabella
 La lista dei record nel modulo List
Mauro Lorenzutti: TCA Tips & Tricks Pag. 5

6. I file coinvolti
ext_tables.sql
Contiene il codice SQL per generare la tabella
ext_tables.php
Contiene l’array usato per generare la lista di record nel modulo List
tca.php
Contiene l’array che descrive ogni singolo campo usato per generare le form di
inserimento e modifica
locallang_db.xml
 Contiene le label da associare alla tabella e ad ogni campo
Mauro Lorenzutti: TCA Tips & Tricks Pag. 6

7. Pages
Mauro Lorenzutti: TCA Tips & Tricks Pag. 7

8. I tipi di campo disponibili
Input None
Text Passthrough
Check User
Radio Flex
Select Inline
Group
Mauro Lorenzutti: TCA Tips & Tricks Pag. 8

9. Guardiamoli da vicino
*http://www.flickr.com/photos/ranti/7666715742/

10. Input
Mauro Lorenzutti: TCA Tips & Tricks Pag. 10

11. Text
Mauro Lorenzutti: TCA Tips & Tricks Pag. 11

12. Check

13. Radio

14. Select

15. Select con pre-processing

16. Select da db

17. Group DB

18. Group File

19. None

20. Passthrough

21. Kickstarter
Tutti i campi visti fino a questo momento possono essere generati
con il modulo Kickstarter
Mauro Lorenzutti: TCA Tips & Tricks Pag. 21

22. Kickstarter, appunto
Kickstarter  velocizza la creazione di un modulo
Ci sono però molte funzionalità non definibili tramite il kickstarter
Ad es. i seguenti tipi di campo non sono supportati:
User
Flex
Inline
Bisogna modificare manualmente i file seguenti:
ext_tables.sql
ext_tables.php
tca.php
locallang_db.xml
Mauro Lorenzutti: TCA Tips & Tricks Pag. 22

23. User

24. Flex

25. Moltissime opzioni disponibili:
http://typo3.org/documentation/document-library/
core-documentation/doc_core_tca/4.7.1/view/1/3/#id590095
Inline

26. Layout della form
Di default un campo sotto l’altro 
Form chilometriche…
Tre strumenti:
Types
Palettes
--div--
Mauro Lorenzutti: TCA Tips & Tricks Pag. 26

27. Types
Visualizzazione di campi in base al valore di un campo
Definizione del “Type Field” nel ext_tables.php:
Definizione delle liste di campi nel tca.php:
Pag. 27

28. Palettes
Visualizzazione raggruppata dei campi
Definizione delle palettes nel tca.php:
Pag. 28

29. --div--
Visualizzazione a tab della form
Attivazione dei tab in ext_tables.php
Definizione dei tab nel tca.php
Pag. 29

30. Aggiornamento campi
Aggiornare un campo in funzione del valore inserito in un altro
campo
requestUpdate
vs
AJAX
Mauro Lorenzutti: TCA Tips & Tricks Pag. 30

31. RequestUpdate
Aggiornare un campo in funzione del valore inserito in un altro
campo
Nazione -> provincia
Selezionata una nazione aggiorniamo la lista delle province
1. attivare il requestUpdate sul campo nazione (ext_tables.php)
Mauro Lorenzutti: TCA Tips & Tricks Pag. 31

32. RequestUpdate 2
2. legare i due campi (tca.php):
Mauro Lorenzutti: TCA Tips & Tricks Pag. 32

33. Aggiornamento via AJAX
Nazione -> provincia
Selezionata una nazione aggiorniamo la lista delle province via AJAX
Due campi “user”:
user_nazione
user_provincia
User_nazione lo abbiamo già visto nelle slide precedenti
Mauro Lorenzutti: TCA Tips & Tricks Pag. 33

34. User_provincia

35. Componenti AJAX 1
Registriamo un ajaxID nel file localconf.php:
Implementiamo la funzione richiamata dal javascript:
Mauro Lorenzutti: TCA Tips & Tricks Pag. 35

36. Componenti AJAX 2
Aggiungiamo il javascript alla funzione user_nazione:
Mauro Lorenzutti: TCA Tips & Tricks Pag. 36

37. Facile no?
* http://www.flickr.com/photos/rainbow_warrior/199405178/

38. Wizard
E se l’inserimento del dato richiede
una form più complessa?
Wizard disponibili:
Add
Edit
List
Colorpicker
Forms
Table
Rte
Tsconfig
Browse_links
Mauro Lorenzutti: TCA Tips & Tricks Pag. 38

39. Modificare il TCA
E se volessimo modificare dei campi già esistenti?
Estensione custom
vs
extTables.php
vs
pageTSConfig
Mauro Lorenzutti: TCA Tips & Tricks Pag. 39

40. Modificare il TCA – estensione custom
Nel file ext_tables.php:
Attenzione all’ordine con cui TYPO3 include le estensioni
Mauro Lorenzutti: TCA Tips & Tricks Pag. 40

41. Modificare il TCA – extTables.php
Nel file typo3conf/extTables.php:
Viene incluso in coda alle estensioni
Non necessario inizializzare il TCA delle tabelle da modificare
Upgrade-safe
Mauro Lorenzutti: TCA Tips & Tricks Pag. 41

42. Modificare il TCA – pageTSConfig
Via TypoScript nel campo Page TSConfig:
http://typo3.org/documentation/document-library/core-documentation/doc_core_tsconfig/4.7.0/view/1/4/#id701510
Mauro Lorenzutti: TCA Tips & Tricks Pag. 42

43. Ci siamo quasi…
Introduzione
Campi disponibili
Kickstarter
Type e palette extTables.php
Wizard pageTSConfig
Modulo List
Conclusioni
Mauro Lorenzutti: TCA Tips & Tricks Pag. 43

44. Listare i record
Gratis grazie al TCA:
Mauro Lorenzutti: TCA Tips & Tricks Pag. 44

45. Limiti del modulo List
Ricerca non strutturata
Funzionalità limitate
Soluzioni? Modulo custom:
Mauro Lorenzutti: TCA Tips & Tricks Pag. 45

46. DB Integration (wfqbe)
E se il modulo List non mi basta ma non so / voglio sviluppare un
modulo di backend?
WFQBE:
http://typo3.org/extensions/repository/view/wfqbe
Mauro Lorenzutti: TCA Tips & Tricks Pag. 46

47. DB Management (wfqbe)
Pag. 47

48. Non abbiamo parlato di…
Configurazione RTE
Soft references
Configurazione e creazione wizard
Flexform
TCA nel frontend
Hook per intercettare eventi significativi sui record:
Apertura
Salvataggio
Inserimento
Cancellazione
Molto altro ancora…
Mauro Lorenzutti: TCA Tips & Tricks Pag. 48

49. TCA Reference
http://typo3.org/documentation/document-library/core-documentation/doc_core_tca/
Mauro Lorenzutti: TCA Tips & Tricks Pag. 49

50. Conclusioni
Il TCA è potente e flessibile
Se qualcosa non è supportato…
si può implementare ;-)
Mauro Lorenzutti: TCA Tips & Tricks Pag. 50

51. Question time
Grazie a tutti per l’attenzione
I miei contatti:
mauro.lorenzutti@webformat.com
 http://it.linkedin.com/in/maurolorenzutti
 http://twitter.com/MauroLorenzutti
Mauro Lorenzutti: TCA Tips & Tricks Pag. 51