wiki:Contribuicoes/BannerAPIComponent

Componente API - Banner

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  banner.js em anexo e copie para dentro da pasta "phpwapi/templates/default/js";
2 - Copie e cole no final do arquivo "phpgwapi/inc/footer.inc.php" o seguinte pedaço de código:

 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:

	$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":

// 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".

Exemplo visualização do banner

Attachments

  • banner.js Download (6.0 KB) - added by niltonneto 7 years ago. Arquivo Javascript para carregar banner.
  • banner.jpg Download (219.6 KB) - added by niltonneto 7 years ago. Exemplo visualização do banner