the booostrap-italia per TYPO3 CMS
==================================

versione software: 002
compatibile con: TYPO3 v10.4.x
consigliato: solo per TYPO3 v10.4.x+
ultimo aggiornamento: 18-03-2021

===================================

Comprende il seguente software; versioni in uso:

bootstrap package v.- 11.x --> dal repository typo3, che utilizza bootstrap4 versione v. 4.3.2 

bootstrap italia v. 1.2.6 -> scaricato da github, al momento solo gli stili contenuti nella cartella src (pari a quella in rete) 
- stili scss e altro, url: https://github.com/italia/bootstrap-italia
- componenti: https://github.com/italia/design-web-toolkit

icone carine in formato svg/png si scaricano da qui:
https://www.flaticon.com/packs/academic-2

in formato png a varie dimensioni:
https://freeicons.io

o ancor meglio da qui si possono personalizzare a video nei colori, testo, tratto, ecc.
https://icons8.it/icon/114326/tocco

==================================

CONTENUTO DELLE CARTELLE:

BackendLayouts
Layout aggiuntivi di backend; per aggiungerli a quelli di default presenti in un sito, procedere in questo modo:
1, editare le proprieta' di pagina della home-page
2. in Risorse/TS aggiungere: <INCLUDE_TYPOSCRIPT: source="DIR:fileadmin/theme-bootstrap-italia/BackendLayouts" extensions="tsconfig">
3. salvare la pagina
4. creare l'icona con Illustrator in formato SVG e salvarla in theme-bootstrap-italia/images
5. indicare l'icona nell'ultima riga del layout di backend creato piu' sopra

da questo momento in poi il layout sarà aggiunto tra quelli disponibili per tutte le pagine, nel menu "aspetto" 
va creato anche il corrispondente layout di frontend, nella cartella:
theme-bootstrap-italia/Resources/Private/Templates/Page
  
Creazione di un nuovo Layout di Backend
  1. editare il file più vicino al layout desiderato, recuperandolo dalla cartella di bootstrap_package
  2. modificarlo e salvarlo in BackendLayout
  3. editare il file: override/_backendlayouts.scss e aggiungere gli stili necessari per il corretto output di frontend
  4.creare la relazione tra i due layouts (Backend/Frontend), via TypoScript, vedi Configuration/Typoscript/setup.txt
    ad esempio:
    page.10.10 {
       pagets__subnavigation_left_2_cols_75-25 = TEXT
       pagets__subnavigation_left_2_cols_75-25.value =  SubnavigationLeft2Col75-25
    }
  

backup
usata per backup manuale

Configuration/Typoscript
constanti e setup per la personalizzazione del prodotto

images
immagini varie e svg

override
Contiene tutti gli stili e variabili di sovrascrittura / aggiunta di nuovo elementi in TYPO3 (es. Layout di Backend)
il file _override.scss carica a sua volta gli altri stili suddivisi per categoria
il file variables.scss definisce le variabili a loro volta sovrascrivibili via CONSTANTS
queste variabili possono essere utilizzate in WEB > Template > Edit all template > CONSTANTS, esempio:
plugin.bootstrap_package.settings.scss.carousel-background-opacity = 0.4; 
quindi aggiungendo in _variables.scss una nuova variabile, questa può essere sovrascritta via CONSTANT, es:
in _variables.scss -> $variabile: 20px;
in constants -> plugin.bootstrap_package.settings.scss.variabile = 30px; 

Resources
copia della cartella della estensione boostrap_package:
typo3conf/ext/bootstrap_package/Resources
all'interno contiene:
* partials e layout di contenuto e relativi ai modelli (templates) in uso
* layouts di pagina
* scss per l'output dei contenuti di bootstrap 4 (Public/Scss/bootstrap4/scss)
* typoscript nella carella Configuration/Typoscript
* ... altro ....
i file non necessari ad es. la sottocartella Less, sono stati rimossi
la versione di bootstrap_package: 10.0.6

src
contiene gli stili scss di bootstrap italia
loghi di default e svg per i layout di backend

----- 
  
Download di icone in formato svg/png
per scaricare le icone del sito d2d, utilizzate nelle proprieta' di pagina (icona di pagina), scaricare da qui:
https://icon-icons.com/it/pack/Technology-Icons/1898

======================================

AGGIORNAMENTO SOFTWARE

ovviamente le versioni in uso di bootstrap 4 vanno tenute allineate all'ultima versione di bootstrap4

BOOTSRAP PACKAGE
se aggiornato bootstrap_package (TYPO3) copiare le cartelle da 
   typo3conf/ext/boostrap_package/Resources/Public/Contrib/bootstrap4/scss
   typo3conf/ext/boostrap_package/Resources/Public/Scss/Theme
nelle corrispondenti che si trovano in /var/www/t3sources/template/bootstrap-italia/Resources
sovrascrivendo tutti i files
files modificati da NON sovrascrivere:
     Resources/Private/Partials/Page/Navigation/Main.htm
     Resources/Private/Partials/Page/Navigation/Breacrumb.htm

BOOTSTRAP ITALIA
la cartella src contiene solo gli stili scss
E' stato modificato il file:
bootstrap-italia.scss
che carica a sua volta tutte le altre librerie di bootstrap4 (typo3, theme, ecc.)
del quale siste una copia di sicurezza:
bootstrap-italia.scss.backup
da usare in caso di accidentale sovrascrittura
Pertanto si procede scaricando la cartella SRC da git per sovrascrivere i files in questione, poi si modifica il file che carica tutte le librerie, vedi la sottocartella backup/bootstrap-italia.scss.backup
il quale carica, in luogo di _variables.scss il file modificato: _variables-t3.scss
questo file va modificato come segue: trovare tutte le occorrenze delle variabli definite, utilizzando un editor, e far si' che TUTTE le variabili all'interno debbano terminare con !default
vedi la copia di sicurezza: backup/_variables-t3.less.backup 
     
