theme.php

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.

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

Permette di definire layout per pagine e news.

labels

Permette di definire le etichette del tema.

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.

<?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',
	],
 
];