theme.php
Panoramica
Il file theme.php contiene le informazioni del tema e le sue configurazioni. Gli array associativi al suo interno permettono di aggiungere e modificare alcune funzionalità, come layout, etichette e posizioni di menù, vetrine e ricerca.
Contenuto del file
Il file si suddivide nei seguenti array associativi, le stringhe che contengono la dicitura theme::common
fanno riferimento al contenuto in lingua inserito nei file common.php.
info
Contiene le informazioni del tema che verranno mostrate nel pannello alla voce "Temi".
'info' => [ 'version' => '1.1', 'author' => 'SelfComposer DevTeam', 'name' => 'theme::common.info.name', 'description' => 'theme::common.info.description', ],
I parametri sono i seguenti:
nome | tipo | descrizione |
---|---|---|
version | string | Numero della versione del tema, es: 1.0 |
author | string | Nome dell'autore, o del team, che ha realizzato il tema |
name | string | Contiene il riferimento in lingua del nome del tema |
description | string | Contiene il riferimento in lingua della descrizione del tema |
available_for
Permette di limitare la disponibilità del tema in base ai diversi tipi di moduli abilitati. Ad esempio se il tema è creato ad hoc per l'e-commerce è possibile fare in modo che venga visualizzato nel pannello solo se è attivo il modulo e-commerce, aggiungendolo a questa lista.
features
Permette di abilitare alcune funzionalità aggiuntive per il tema. Nell'esempio viene attivata la funzionalità delle immagini alternative.
'features' => [ 'alt_image' => [ 'enabled' => true, 'description' => 'theme::common.features.alt_image', ], 'icon' => [ 'enabled' => true, ], ],
I parametri utilizzati sono
nome | tipo | descrizione |
---|---|---|
alt_image | array | Nome della funzionalità aggiuntiva da attivare |
enabled | bool | Con valore true attiva la funzionalità |
description | string | Riferimento in lingua della descrizione della funzionalità |
admin
Permette di abilitare la sezione impostazioni tema del pannello se enable
è impostato a true
.
pagination
Contiene il riferimento al tipo di paginazione.
layouts
labels
Permette di definire le etichette del tema.
menu_positions
Permette di definire le posizioni dei menu del tema.
showcase_positions
Permette di definire la posizione delle vetrine del tema.
search_positions
Permette di definire le posizioni per la ricerca avanzata del tema.
readme
Associa i file readme alla lingua, in modo da essere mostrati nel pannello.
File originale
<?php return [ /* |-------------------------------------------------------------------------- | Info |-------------------------------------------------------------------------- */ 'info' => [ 'version' => '1.1', 'author' => 'SelfComposer DevTeam', 'name' => 'theme::common.info.name', 'description' => 'theme::common.info.description', ], /* |-------------------------------------------------------------------------- | Limit availability ( specify modules ) |-------------------------------------------------------------------------- */ 'available_for' => [], /* |-------------------------------------------------------------------------- | Features |-------------------------------------------------------------------------- */ 'features' => [ 'alt_image' => [ 'enabled' => true, 'description' => 'theme::common.features.alt_image', ], 'icon' => [ 'enabled' => true, 'description' => 'theme::common.features.icon', ], ], /* |-------------------------------------------------------------------------- | Admin panel |-------------------------------------------------------------------------- */ 'admin' => [ 'enabled' => true, ], /* |-------------------------------------------------------------------------- | Pagination |-------------------------------------------------------------------------- */ 'pagination' => 'cms::pagination.bootstrap-3.slider', /* |-------------------------------------------------------------------------- | Layouts |-------------------------------------------------------------------------- */ 'layouts' => [ 'generic' => [ 'layouts.image_right' => 'theme::common.layouts.generic.image_right', ], ], /* |-------------------------------------------------------------------------- | Labels |-------------------------------------------------------------------------- */ 'labels' => [ 'slogan' => ['field' => 'text', 'label' => 'theme::common.labels.slogan.label', 'descr' => 'theme::common.labels.slogan.descr'], ], /* |-------------------------------------------------------------------------- | Positions |-------------------------------------------------------------------------- */ 'menu_positions' => [ 'top' => 'theme::common.menu_positions.top', ], 'showcases_positions' => [ 'home_slider' => 'theme::common.showcases_positions.home_slider', 'home_center' => 'theme::common.showcases_positions.home_center', ], 'search_positions' => [ 'left' => 'theme::common.search_positions.left', ], 'readme' => [ 'it' => 'readme_it', ], ];