Tags: skin

Criando uma Skins pro B2evolution 2.x

No b2evolution 2.0 e acima, skins/pels seguem uma nova organização. (Essa página está atualizada para b2evo 2.2.0)

Para criar uma nova skin, você precisa criar um novo diretório dentro do diretório /skins directory (como no b2evo 1.x). Por exemplo: /skins/myskin2

Antes de usar seu novo skin/pele num blogue, você deverá instalar esta skin/pele através de “Global Settings/Configurações Globais” > “Skin install/Instalar Skin” > “Install new/Nova Instalação". Isto é necessário para que o b2evolution possa mapear os arquivos do skin e localizar o contâiner do widget.

Template principal

Pelo menos, o diretório do skin /skins/myskin2 deve conter um arquivo do template principal de nome index.main.php.

Dependendo do que o b2evo quer mostrar ele chamará um template específico de primeiro nível ( “top level” template) também conhecido como “main” template (*.main.php) dentro do diretório skin. Se o template procurado não for encontrado, o b2evo voltará para o padrão index.main.php.

$disp	Chamada ao Template “top level”	Veja exemplos nesse skin/pele
‘arcdir’	arcdir.main.php	-
‘catdir’	arcdir.main.php	-
‘comments’	comments.main.php	_rss2
‘feedback-popup’	feedback_popup.main.php	photoblog
‘mediaidx’	mediaidx.main.php	-
‘msgform’	msgform.main.php	-
‘page’	page.main.php	evopress
‘posts’	posts.main.php	evopress
‘profile’	profile.main.php	-
’single’	single.main.php	evopress
’subs’	subs.main.php	-
default	index.main.php	custom

disp template

Se nenhum template principal (*.main.php) for encontrado para uma visualização específica, o padrão index.main.php será acionado. Este template geralmente irá incluir uma chamada ao template skin_include( ‘$disp$’, … ) o qual acionará um template de segundo nível ("second level” template), também conhecido como “disp” template.

$disp	Chamada ao Template 2^o nível	Veja exemplo nesse skin/pele
‘arcdir’	_arcdir.disp.php	custom
‘catdir’	_arcdir.disp.php	custom
‘comments’	_comments.disp.php	custom
‘feedback-popup’	_feedback_popup.disp.php	-
‘mediaidx’	_mediaidx.disp.php	photoblog
‘msgform’	_msgform.disp.php	custom
‘page’	_page.disp.php	custom
‘posts’	_posts.disp.php	custom
‘profile’	_profile.disp.php	custom
’single’	_single.disp.php	custom
’subs’	_subs.main.php	custom

Se um template disp específico não for encontrado dentro do diretório skin (por exemplo /skins/myskin2/_msgform.disp.php não é encontrado), então o template disp padrão do /skin será utilizado (aqui /skins/_msgform.disp.php será utilizado).

Inclusor de arquivos (Include files)

O template main e disp acima chamará um inclusor de arquivos “include files” (*.inc.php).

Por exemplo, muitas skins usam um cabeçalho e rodapé comuns para todos os seus templates. Isso estará em arquivo de inclusão (include files) de nomes como esses:

* _html_header.inc.php (contém cabeçalhos comuns INVIŚIVEIS, tipicamente as seções HEAD das páginas HTML)
* _body_header.inc.php (contém cabeçalhos comuns VIŚIVEIS, tipicamente os bannr no topo do blogue)
* _body_footer.inc.php (contém rodapés comuns VIŚIVEIS, tipicamente os créditos no rodapé da página)
* _html_footer.inc.php (contém rodapés comuns INVIŚIVEIS, tipicamente códigos de logging and debugging)

Se um inclusor de arquivos específico (include file) não é encotrado dentro do diretorio do skin (por exemplo /skins/myskin2/_html_header.inc.php não é achado), então o “include” padrão do diretório /skins será utilizado (aqui /skins/_html_header.inc.php) deverá ser utilizado.