= Componente API - Banner =
[[PageOutline(1-3, Conteúdo)]]

== O que é ==

Esse componente permite que um banner em forma de DIV flutuante seja habilitado, carregando uma imagem quando o usuário se logue no Expresso.

== Como funciona ==

O Expresso carrega o footer.inc.php (PHP do rodapé) que carrega o script "banner.js", caso pertença a um grupo de usuários liberado dentro do "header.inc.php". Possui "fade-in" ao abrir e "fade-out" para fechar. Configurável somente para carregar uma imagem (jpg, gif ou png), com valores de largura e altura configuráveis, e tempo de expiração (mínimo um dia).

== Como instalar ==

1 - Faça download do arquivo [http://trac.expressolivre.org/attachment/wiki/bannerAPIComponent/banner.js banner.js] em anexo e copie para dentro da pasta "phpwapi/templates/default/js";[[BR]]
2 - Copie e cole no final do arquivo "phpgwapi/inc/footer.inc.php" o seguinte pedaço de código:[[BR]]

{{{
 if(is_array($GLOBALS['phpgw_info']['server']['enable_banner_groups'])) {
		foreach($GLOBALS['phpgw']->accounts->membership() as $idx => $group){
        	if(array_search($group['account_name'],$GLOBALS['phpgw_info']['server']['enable_banner_groups']) !== FALSE){
            	echo '<script type="text/javascript" src="'.$GLOBALS['phpgw_info']['server']['webserver_url'].'/phpgwapi/templates/default/js/banner.js"></script>';
                break;
			}
		}
	}
}}}

== Como configurar ==

1 - Adicione no arquivo "header.inc.php" a linha abaixo, incluindo o(s) gidNumber(s) do(s) grupo(s) liberado(s) para carregar o banner:[[BR]]

{{{
	$GLOBALS['phpgw_info']['server']['enable_banner_groups'] = array("22448", "1005");
}}}

2 - Configure as informações do banner que será carregado, dentro do arquivo "banner.js":[[BR]]

{{{
// Caminho da imagem (raiz do expresso)
var url_path = '/arqs-divulgacao/cipa.jpg';
// Tamanho da imagem (pixels)
var img_height = 350;
var img_width  = 350;
// N. de dias que expira
var expDays = 1;  // Para aparecer uma vez por dia. Se quiser, por exemplo, uma vez a cada três dias coloque "3".
}}}

[[Image(banner.jpg,,center)]]