
<<<<<<<<< MamboletoJoomla! 2.0 RC2 >>>>>>>>


Utilitário de geração de boletos bancários com Joomla 1.0.12 e Virtuemart 1.0.12

Por Fernando Soares fsoares@fsoares.com.br - htt://www.fernandosoares.com.br

Setembro 2007


Esta é a versão 2.0 RC2 do Mamboleto, que além da estabilidade apresentada na versão RC1, tem alguns acréscimos 
em sua API e em sua configuração, bem como alguns ajustes estéticos. Foram feitas diversas correções de BUGs e 
muitos aprimoramentos.
Para ser sincero com todos devo admitir que já estava com esta versão pronta e empacotada para o lançamento no 
dia 26 de agosto mas ai veio a percepção de que iria ser uma simples versão de correção de BUGs menores e de
algumas melhorias estéticas. Não queria isso... queria sim apresentar algo que fosse novo no Mamboleto e que 
fosse melhorar sua usuabilidade...ixi palavrão...mas trocando em miúdos, que ampliasse o leque de possibilidades
de uso.
Bom, tendo em mente isso adiei o lançamento e foi trabalhar para acrescentar mais bancos / boletos ao Mamboleto
pois isso sim seria uma novidade atraente. De fato tomei a decisão acertada ao adiar o lançamento desta versão
visto que logo na semana seguinte alguns usuários não só solicitaram novos bancos / boletos como também enviaram
a documentação oficial dos bancos para a geração destes boletos (Real e Mercantil).
Desenvolvi os boletos para estes dois bancos e como já estava com a mão massa mesmo consegui a documentação para 
mais dois bancos / boletos (HSBC e Unibanco). Estes foram escolhidos levando em conta o fato de serem mais 
utilizados, pelo menos na minha região, e também de serem grandes bancos. Isso faz com que mais pessoas possam
usufruir deste componente.
Sendo assim, o principal destaque desta versão RC2 é o acréscimo de mais quatro bancos / boletos ao Mamboleto, 
que passa a contar agora com 10 (dez) bancos / boletos e estes, assim como os demais, foram elaborados com base
nas documentações oficiais dos bancos. Claro que isso não impede que hajam BUGs ou erros, portanto testem tudo!



==========================================
MODIFICAÇÕES PRESENTES NA VERSÃO 2.0 RC2
==========================================

-Correção de BUG em que os valores acima de 1000,00 provocavam a formação incorreta da linha digitável e código de
 barras.

-Correção de BUG em que os centavos dos valores não eram representados no boleto e nem na linha digitável ou código
 de barras.

-Correção de BUG em que se o valor fosse entrado com ","(vírgula) como separador de decimais também eram omitidos os
 centavos dos valores.

-Acrescentados mais 4 bancos / boletos ao Mamboleto. São eles Banco Real, Banco Mercantil do Brasil, Unibanco e HSBC.

-Acrescentada a possibilidade de trabalhar com as carteiras 106, 107, 122, 142, 143, 195, 196 e 198 no Boleto Itaú.

-Possibilidade de emissão de boletos para cobrança com registro e sem registro no boleto Unibanco.

-Ativada a opção para criação de novas configurações personalizadas e também para sua eliminação.

-Modificada a maneira como os boletos pegam o dado "Carteira".

-Padronizados e documentados todos os boletos para que se torne mais fácil identificar possíveis problemas.

-Corrigido BUG em ambos os módulos para VirtueMart que fazia com que o botão (ou botões) para geração do(s) boleto(s)
 não fosse(m) exibido(s) caso o usuário não fizesse o preenchimento dos campos de caminho para imagem de logotipo,
 largura imagem ou altura imagem.

-Modificado o módulo Multi-Banco do Mamboleto para VirtueMart de forma a tornar possível selecionar os bancos a serem
 exibidos e sua ordem de exibição. Sendo que agora você pode selecionar entre 1 e 6 bancos para usar.

-Modificado o código de geração da segunda via do boleto bancário para que gerencie de forma satisfatória a exibição
 dos links dos bancos escolhidos no módulo Multi-Banco do Mamboleto.

-Foram acrescentados mais 5 (cinco) campos para informações de demonstrativo na API do Mamboleto, porém estes campos
 estão disponíveis somente através da API e não através da tela de configuração dos boletos onde continuam a haver
 apenas 4 opções como antes. Assim a API passa a ter os campos "demons5", "demons6", "demons7", "demons8", "demons9".
 Isso visa facilitar os projetos de integração onde é necessário um detalhamento mais completo no demonstrativo.

-Foi acrescentado o campo "sacador" à API do Mamboleto que será impresso no boleto bancário logo abaixo do nome do
 sacado onde lê-se "Sacador / Avalista". Esta também foi uma decisão destinada à facilitar os projetos de integração.

-Acrescentadas mais duas opções ao menu principal: "Configurações Personalizadas" e "Administrar Bancos".

-As imagens do menu principal foram incluidas na instalação do Mamboleto e agora estão disponíveis na pasta "imagens".

-Acrescentada em "Configurações Personalizadas" uma opção para definir caminho para o seu logotipo ou para uma imagem
 a ser exibida no topo do boleto bancário.

-Ampliada a capacidade dos campos de instruções do boleto ("instrucoes_linha") e de demonstrativo ("demost") que ficam
 gravados no banco de dados de 100 para 200 caracteres.

-Corrigido um BUG nos módulos para VirtueMart "ps_mamboleto.php" e "ps_mamboleto_mb.php" que fazia com que o e-mail com
 o boleto fosse enviado somente com o primeiro nome do sacado.

-Os módulos para o VirtueMart agora geram o boleto bancário com o endereço completo do comprador.

-Correção de um bug relacionado ao carregamento da classe javascript quando da abertura da tela de "Configurações 
 Personalizadas" que ocorre somente quando o Mamboleto é instalado em uma instalação Joomla! feita em um diretório
 do domínio principal.

-Correções na estética geral do Mamboleto.




==========================================
MODIFICAÇÕES PRESENTES NA VERSÃO 2.0 RC1
==========================================

-Foram feitas inúmeras modificações para eliminar a necessidade do "Register Globals=ON" e do "Joomla! RG_EMULATION=ON".

-Foi alterado o modo de postagem dos dados de GET para POST nos métodos de pagamento "Boleto Bancário" e "Boleto Multi-Banco"
 para o VirtueMart. Agora estes não deixam transparecer os dados que estão sendo enviados.

-O método de pagamento "Boleto Multi-Banco" para o VirtueMart agora também oferece a opção de envio do boleto por e-mail
 através da seleção de um boleto padrão para geração e envio do boleto bancário.

-Foi acrescentada uma opção de configuração do logotipo ou imagem que é exibida ao final e de seu tamanho em pixels em
 ambos os métodos de pagamento "Boleto Bancário" e "Boleto Multi-Banco".

-Reorganizada a maneira como são exibidos os links para geração dos boletos no módulo "Boleto Multi-Banco" de forma a
 aproveitar melhor o espaço.

-Removido o uso da biblioteca GD como meio de geração do código de barras dos boletos.

-Corrigida maneira como os dados da agência e conta são obtidos do banco de dados.

-Corrigida a interface de revisão de boletos bancários (link "Revisar Boleto") para que refita exatamente o modo como os
 boletos são gerados via API ou integração do Mamboleto (como os módulos para o VirtueMart). Havia uma distorção com 
 relação ao número da agência bancária, mas somente na tela de revisão de boletos bancários, no restante estava tudo certo.

-Acrescentada a opção de definir o prazo de vencimento do boleto bancário, em "X" dias após a data da compra em ambos os
 métodos de pagamento "Boleto Bancário" e "Boleto Multi-Banco".

-Modificado o código de geração da segunda via do boleto bancário para que somente seja apresentada esta opção
 caso a data atual seja igual ou menor que a data de vencimento do boleto bancário (Data Pedido + "X" dias).

-Na geração da segunda via do boleto bancário agora este contém a data do pedido como data do documento e não mais
 a data atual.

-Ainda no código de geração da segunda via do boleto bancário, este foi atualizado para utilizar o método POST de forma
 a não deixar transparecer os dados que estão sendo enviados.

-Também na geração da segunda via do boleto bancário agora a data de vencimento é calculada com base na data do
 pedido e do prazo em dias informado na configuração do método de pagamento para o VirtueMart (Data Pedido + "X"
 dias). Desta forma o boleto bancário terá sempre o mesmo vencimento, mesmo que seja gerada uma segunda via.

-Implementadas novas opções de configuração e envio de dados via API do Mamboleto. Veja a lista completa de de opções na
 descrição de como usar a API do Mamboleto.





==========================================
MODIFICAÇÕES PRESENTES NA VERSÃO 2.0 RC
==========================================

-Corrigido o meio de geração do código de barras dos boletos quando a biblioteca GD não está disponível.

-O envio dos e-mails com o boleto agora também funciona quando a biblioteca GD não está disponível.




==========================================
MODIFICAÇÕES PRESENTES NA VERSÃO 2.0 BETA2
==========================================

-As tabelas do banco de dados agora seguem o padrão do Joomla!. Ex.: "jos_mblto_banco". Assim agora é possível ter
 mais de um mamboleto, em mais de um site é claro, intalado no mesmo banco de dados sem problemas de sobreposição
 de dados.

-Implemantado o método de envio do boleto via email através do framework do Joomla!.

-Foi acrescentado o boleto do banco BANRISUL.

-Implementado novo método de geração do código de barras I25 para os boletos bancários através da biblioteca GD
 do PHP.

-Foram modificados os métodos de pagamento para VirtueMart de forma a se compatibilizarem com esta nova versão do
 Mamboleto.

-Foram executadas correções no boleto do Banco Itaú para corrigir a formação do código de barras e também para
 permitir o uso das carteiras 126, 131, 146, 150 e 168.

-Foram executadas correções no boleto do Banco do Brasil de forma a sanar bugs reportados.

-Agora há 5 tipos de boletos que pode ser gerados para o Banco do Brasil como descrito abaixo:

	a)-O boleto do Banco do Brasil agora detecta se o tamanho do número do convênio é de 4, 6, 7 ou 8 dígitos.

	b)-Os boletos são gerados de acordo com a regra para cada tamanho de convênio.

	c)-No caso do convênio de 6 dígitos há duas opções:

		-Informando o código 1 (padrão) o nosso número poderá ter até 5 dígitos.

		-Informando o código 2 o nosso número poderá ter até 17 dígitos.


-Corrigido o boleto da Caixa Ecônomica Federal.

-Corrigido o boleto do Banco Bradesco.

-Corrigido o boleto do Banco Santander, que tem padronizado seus boletos para o banco "033", conforme informações
 obtidas do próprio banco.

-Acrescentado mais opções de ano na tela de revisão de boleto, sendo que agora está disponível a faixa de 1997
 a 2020.

-Removidas várias opções inválidas da interface de administração de boletos.

-Removidas várias opções inválidas da interface de administração de configurações.

-Removidas várias opções inválidas da interface de revisão de boletos.




==========================================
MODIFICAÇÕES PRESENTES NA VERSÃO 2.0 BETA
==========================================

-O processo de instalação foi corrigido e melhorado para evitar os erros das varsões anteriores.

-Não é mais necessário executar o processo de integração ao Joomla! pois agora este processo é executado durante a
instalação do componente. O botão "Integrar ao Joomla!" ainda foi mantido por mera cautela, afinal este é um BETA.

-A ajuda contida no componente foi modificada e melhorada com acréscimo de links para o forum da língua portuguesa
em forum.joomla.org, para www.joomla.com.br (Matheus Mendes) e para www.fernandosoares.com.br (Fernando Soares).

-O código php que permite a impressão da segunda via do boleto no VirtuMart foi modificado para que já seja compatível 
com a utilização do método de pagamento multi-banco do MamboletoJoomla! em conjunto com o VirtueMart.


-Foi acrescentado um icone de menu para o MamboletoJoomla!.



==========================================
MODIFICAÇÕES PRESENTES NA VERSÃO 2.0 ALPHA
==========================================

-Não é preciso modificar manualmente o número da carteira ($cart) nos arquivos de classe de banco onde ela é requerida,
 como em "class.banco.bancodobrasil.php" e "class.banco.itau.php".
 Agora este valor é atualizado diretamente do banco de dados onde estão os dados que você configurou para cada boleto. 

-Correção e atualização de dados na interface de Revisão dos Boletos (revisar_boleto.php).
 Foram inclídos novos valores para "ano".
 Foram definidos novos valores padrão para o formulário.

-Foram corrigidas as funçoes que calculavam de forma errada o "DC" e o dígito verificador no número do banco dependendo
 do valor de entrada.

-Acrescentei mais três layout´s de bancos (Santander, Bradesco e Caixa Ecônomica Federal) para geração de boletos, assim
 sendo, gostaria que informassem possíveis BUG´S.

-O método de pagamento para o VirtueMart foi atualizado com os novos bancos.

-No método de pagamento para VirtueMart: Agora a seleção do boleto/banco a ser utilizado foi modificada de forma a ser
 feita através da seleção do banco na lista lá presente, não sendo mais necessário saber o ID do boleto/banco a ser usado.


-BUG que persiste: Ao clicar em "Gerar Boleto >>" o boleto é gerado e no final aparece o formulário
		   novamente, porém se você clicar novamente em "Gerar Boleto >>" são gerados inúmeros
		   erros.

-Workarround(driblar):	Após clicar em "Gerar Boleto >>" se você precisar repetir a operação, clique
			no botão "Voltar" de seu browser.


==========================================

1. INSTALAÇÃO
2. MÉTODO DE PAGAMENTO MAMBOLETO NO VIRTUEMART
	2.1 BOLETO BANCÁRIO - MÉTODO DE PAGAMENTO MONO-BANCO
	2.2 BOLETO BANCÁRIO - MÉTODO DE PAGAMENTO MULTI-BANCO
3. SEU LOGOTIPO DO BOLETO
4. SEGUNDA VIA DO BOLETO NO VIRTUEMART
5. COMO UTILIZAR A API DO MAMBOLETO
6. VARIÁVEIS DISPONÍVEIS NOS ARQUIVOS CLASS DOS BANCOS


1. <<<<<<<<<<<<<<<   INSTALAÇÃO   >>>>>>>>>>>>>>>>>

------------------------------------------------

-Descompacte o arquivo MamboletoJoomla_2-0_RC2.zip

------------------------------------------------

-Instale mamboleto_2-0_RC2.zip como um componente

------------------------------------------------

-Acesse  Components > Mamboleto

------------------------------------------------

-Clique em Boletos e selecione o título do boleto correspondente ao seu banco.

------------------------------------------------

-Configure com seus dados bancários, normalmente fornecidos pelo banco.

-Salve.

------------------------------------------------

________________________________________________
Se necessário:
________________________________________________

-Clique em Configurações Gerais.

-Depois em Modificar Configuração.

-Ajuste a configuração de acordo com seus dados.

ou

-Edite o arquivo administrator\components\com_mamboleto\include\pre.php e configure as URLs.

-Depois edite o arquivo administrator\components\com_mamboleto\config\phpboleto.ini.php
 e configure os dados necessários como segue:

[Admin Geral]								=> Não altere
BOLETO_SISTEMA=banco							=> Não altere
VERSAO=Versão 2.0 RC2							=> Não altere
TITULO_ADMIN_NORMAL=MamboletoJoomla! - Interface de Administração	=> Não altere
[Banco de Dados]							=> Não altere
BOLETO_DBTYPE=mysql		=> Tipo de banco de dados
BOLETO_DBHOST=localhost		=> Servidor do banco de dados
BOLETO_DBNAME=joomla		=> Nome do banco de dados
BOLETO_DBUSER=root		=> Usuário do banco de dados
BOLETO_DBPASS=123		=> Senha do banco de dados


*** ATENÇÃO: NÃO ALTERE A ORDEM DAS LINHAS ACIMA OU ALGUNS BOLETOS PROVOCARÃO ERROS.
 
________________________________________________

------------------------------------------------
Teste uma compra.
------------------------------------------------

>>> Imprima um boleto e leve ao seu banco para ver se TUDO funciona.

>>> LEMBRE-SE DE QUE ESTA NÃO É UMA VERSÃO FINAL E ISTO SIGNIFICA QUE ELA PODE CONTER ERROS!

IMPORTANTE:

-Reporte os erros/bugs encontrados no programa e principalmente nos boletos através do 
forum forum.joomla.org. O link para o forum correto está na Ajuda do MamboletoJoomla!.

------------------------------------------------ 




2. >>>>>>>>>>>>> MÉTODO DE PAGAMENTO MAMBOLETO NO VIRTUEMART


2.1 --------- BOLETO BANCÁRIO - MÉTODO DE PAGAMENTO MONO-BANCO ---------


-Unzip mamboleto_virtuemart_payment_6-0.zip

-Coloque os arquivos "ps_mamboleto.php" e "ps_mamboleto.cfg.php" 
 no diretório administrator\components\com_virtuemart\classes\payment

------------------------------------------------

-No Joomla! acesse > Components > VirtueMart

-No menu do VirtueMart, vá em Loja > Adicionar método de pagamento:

tab General:
Marque Ativo
Nome do formulário: Boleto Bancário
Código: MBT
Class name: ps_mamboleto

-Marque Apenas a Endereço

Selecione Grupo de clientes
desconto: 0.00
listar encomendas: 0

-Salve

------------------------------------------------

-Clique no método de pagamento "Boleto Bancário"

-Vá na aba "Configuração"

-Selecione o banco que irá utilizar para gerar os boletos.

-Selecione se deve ser enviado um email com o boleto ou não.

-Defina o prazo de vencimento dos boletos gerados.

-Informe o caminho local ou URL para seu logotipo ou outra imagem que queira exibir ao final.
 Exemplo: "./administrator/components/com_mamboleto/imagens/mamboleto.gif"

-Configure o tamanho (altura e largura) da imagem em pixels.

-Salve


------------------------------------------------



2.2 >>>>>>>>>>>>> BOLETO MULTI-BANCO - MÉTODO DE PAGAMENTO MULTI-BANCO



-Unzip mamboleto_virtuemart_payment_multi_6-0.zip

-Coloque os arquivos "ps_mamboleto_mb.php" e "ps_mamboleto_mb.cfg.php" 
 no diretório administrator\components\com_virtuemart\classes\payment

------------------------------------------------

-No Joomla! acesse > Components > VirtueMart

-No menu do VirtueMart, vá em Loja > Adicionar método de pagamento:

tab General:
-Marque Ativo
Nome do formulário: Boleto Multi-Banco
Código: MBT_MB
Class name: ps_mamboleto_mb

-Marque Apenas a Endereço

Selecione Grupo de clientes
desconto: 0.00
listar encomendas: 0

-Salve

------------------------------------------------

-Clique no método de pagamento "Boleto Multi-Banco"

-Vá na aba "Configuração"

-Selecione os bancos que irá disponibilizar para geração dos boletos. Você pode escolher até 6.

-Selecione o banco padrão para geração dos boletos bancários que serão enviados por e-mail.

-Defina o prazo de vencimento dos boletos gerados.

-Informe o caminho local ou URL para seu logotipo ou outra imagem que queira exibir ao final.
 Exemplo: "./administrator/components/com_mamboleto/imagens/mamboleto.gif"

-Configure o tamanho (altura e largura) da imagem em pixels.

-Salve


------------------------------------------------



3. >>>>>>>>>>>>> SEU LOGOTIPO DO BOLETO


Para colocar seu logotipo no boleto você deve:

	-Criar um arquivo de imagem de nome "logo.png", ou nome de sua preferência, com seu
	 logotipo ou imagem para ser exibida no topo do boleto.

	OBS.:	Este logotipo deve ter no MÁXIMO 40px de ALTURA e sugiro que 
		tenha ATÉ 160px de LARGURA para não afetar o layout do boleto.

	-Faça o upload deste arquivo para a pasta administrator/components/com_mamboleto/imagens
	 ou para alguma pasta de imagens de sua instalação.

	-Vá ao Mamboleto, depois em Configurações Personalizadas e logo em seguida clique em
	 Mamboleto.

	-Defina em "Logo boleto" o caminho para a imagem de seu logotipo.
	 O caminho padrão é: "./administrator/components/com_mamboleto/imagens/logo.png"


Pronto! Seu logo já estará nos boletos.





4. >>>>>>>>>>>>> SEGUNDA VIA DO BOLETO NO VIRTUEMART


Faz com que apareça a opção "Imprima seu boleto" quando o usuário está logado e clica no 
menu "Manutenção da Conta de Usuário" e em seguida em uma encomenda pendente.


Para implementar a opção de gerar segunda via do boleto:

-No arquivo "account.order_details.php" do VirtueMart 1.0.7 (no Virtuemart 1.0.10 e posteriores as 
linhas são quase iguais) depois de:


<!-- Begin Payment Information --> 

      <table class="moduletable" border="0" cellspacing="0" cellpadding="0" width="100%">
      <tr> 
        <th  valign="top" align="left" colspan="3"><?php echo $VM_LANG->_PHPSHOP_ORDER_PRINT_PAYINFO_LBL ?></th>
      </tr>
      <tr> 
        <td style="padding-left: 5px;" valign="top" width="30%"><?php echo $VM_LANG->_PHPSHOP_ORDER_PRINT_PAYINFO_LBL ?> :</td>
        <td valign="top"><?php $dbpm->p("payment_method_name"); ?> </td>
      


      
-Coloque:


<!-- Inicio da Modificação Mamboleto  -->

<!-- Versão Setembro/2007 -->

<!-- Funciona com Joomla! 1.0.12 e VirtueMart 1.0.12 - por Fernando Soares - http://www.fernandosoares.com.br -->   

<?php
require_once(CLASSPATH.'ps_payment_method.php');


$ps_payment_method = new ps_payment_method;
$payment = $dbpm->f("payment_method_name");

//Mostra a opção imprimir boleto se a situação da encomenda for pendente e se o nome do método de pagamento for Boleto Bancário

if ( $db->f("order_status") == "P" ) {
if (($payment == "Boleto Bancário") or ($payment == "Boleto Multi-Banco")) {

/* arquivo de configuração com o id do boleto*/
if ($payment == "Boleto Bancário") {
	require_once(CLASSPATH ."payment/ps_mamboleto.cfg.php");
} elseif ($payment == "Boleto Multi-Banco") {
	require_once(CLASSPATH ."payment/ps_mamboleto_mb.cfg.php");
}


$total = $db->f("order_total");
  
$cliente = $dbbt->f("first_name")."&nbsp;".$dbbt->f("middle_name")."&nbsp;".$dbbt->f("last_name");
$sql = "SELECT max(order_id)+1 as order_id FROM #__vm_orders";
$dados = null;
$database->setQuery($sql);      
$database->loadObject($dados);

/* Dados que serão passados */
$nosso_numero = $order_id;

// Novo =============
//Pega e monta datas para processamento e comparação

$data_documento = date("d/m/Y", $db->f("cdate"));
$vencimento_numerico = $db->f("cdate")+60*60*24*PRAZO_BLTO;
$vencimento = date("d/m/Y", $vencimento_numerico);
$hoje = time();

if ($vencimento_numerico >= $hoje) {

// Novo =============

if ($payment == "Boleto Bancário"){
$id = MAMBOLETO_ID; // definido na configuração.

//envia os dados por POST para melhorar a segurança

echo '<td valign=\"middle\">';
echo '<center>';
echo '<form target="_blank" action="'.$mosConfig_live_site.'/index2.php" method="post">';
echo '<input type="hidden" name="option" value="com_mamboleto" />';
echo '<input type="hidden" name="no_html" value="0" />';
echo '<input type="hidden" name="vencimento" value="'.$vencimento.'" />';
echo '<input type="hidden" name="nosso_numero" value="'.$nosso_numero.'" />';
echo '<input type="hidden" name="numero_documento" value="'.$order_id.'" />';
echo '<input type="hidden" name="data_documento" value="'.$data_documento.'" />';
echo '<input type="hidden" name="valor_documento" value="'.$total.'" />';
echo '<input type="hidden" name="id" value="'.$id.'" />';
echo '<input type="hidden" name="sacado" value="'.$cliente.'" />';
echo '<input type="image" src="./administrator/components/com_mamboleto/imagens/mamboletop.gif" name="submit" border="0" alt="Emita seu Boleto">';
echo '</form>';
echo '<h5>CLIQUE ACIMA E IMPRIMA SEU BOLETO!</h5>';
echo '</center>';
echo '</td></tr>';

} elseif ($payment == "Boleto Multi-Banco") {
$nome_banco = array('','&nbsp;Unibanco<br>&nbsp;','&nbsp;HSBC<br>&nbsp;','&nbsp;Bradesco<br>&nbsp;','&nbsp;Santander<br>&nbsp;','&nbsp;Caixa Econ.<br>Federal','&nbsp;Banco do<br>Brasil','&nbsp;Banco<br>Itaú','&nbsp;BANRISUL<br>&nbsp;','&nbsp;Banco<br>Real','&nbsp;Banco<br>Mercantil');
$img_banco = array('','409-0.gif','399-9.gif','237-2.gif','033-7.gif','104-0.gif','001-9.gif','341-7.gif','041-8.gif','356-5.gif','389-1.gif');

for ($i = 0; $i <= 5; $i++) {

   $id = array(MAMBOLETO_MB1, MAMBOLETO_MB2, MAMBOLETO_MB3, MAMBOLETO_MB4, MAMBOLETO_MB5, MAMBOLETO_MB6);

if ($id[$i] != "NU"){

//envia os dados por POST para melhorar a segurança

echo '<td>';
echo '<center>';
echo '<form target="_blank" action="'.$mosConfig_live_site.'/index2.php" method="post">';
echo '<input type="hidden" name="option" value="com_mamboleto" />';
echo '<input type="hidden" name="no_html" value="0" />';
echo '<input type="hidden" name="vencimento" value="'.$vencimento.'" />';
echo '<input type="hidden" name="nosso_numero" value="'.$nosso_numero.'" />';
echo '<input type="hidden" name="numero_documento" value="'.$order_id.'" />';
echo '<input type="hidden" name="data_documento" value="'.$data_documento.'" />';
echo '<input type="hidden" name="valor_documento" value="'.$total.'" />';
echo '<input type="hidden" name="id" value="'.$id[$i].'" />';
echo '<input type="hidden" name="sacado" value="'.$cliente.'" />';
echo '<input type="image" src="./administrator/components/com_mamboleto/imagens/'.$img_banco[$id[$i]].'" name="submit" border="0" alt="Boleto Bancário">';
echo '</form>';
echo '<h5>'.$nome_banco[$id[$i]].'</h5>';
echo '</center>';
echo '</td>';

		    }
			    }
echo "</tr>";
					    }
					}
}
}
?>

<!-- Fim da Modificação Mamboleto  -->





-Pronto!




5. >>>>>>>>>>>>> COMO UTILIZAR A API DO MAMBOLETO



Para utilizar este componente no Frontend:

	1 - 	Passe os valores (pode ser por formulário, pela url, por sessão.. tanto faz) correspondentes 
		a cada campo do boleto (veja a lista abaixo).

	2 - 	Certifique-se de que está chamando este componente numa nova janela 
		(index2.php?option=com_mamboleto&no_html=0) e que todos os parâmetros estão sendo passados.


-Lista dos valores que podem ser passados para o MamboletoJoomla 2.0 RFINAL:

 
* Estrutura dos parâmetros que devem ser passados ao método:

Parâmetro	      Conteúdo		   Descrição				   Valor Padrão
===================   ==================   =====================================   ==================================
vencimento	   => data		=> a data de vencimento do boleto 	=> Data atual + 7 dias
					   bancário (dd/mm/aaaa)
nosso_numero	   => numérico		=> seu número de controle do documento	=> 0
numero_documento   => numérico		=> número do documento ou do pedido	=> 0
data_documento	   => data		=> a data de emissão do documento ou do	=> Data atual
					   pedido (dd/mm/aaaa)
valor_documento    => numérico		=> valor do documento (xxx,xx ou xxx.xx)=> 0
id		   => numérico		=> id do boleto a ser emitido		=> 6 (Banco do Brasil)
						3 -> Bradesco
						4 -> Santander
						5 -> Caixa Econ.Federal
						6 -> Banco do Brasil
						7 -> Itaú
						8 -> Banrisul
sacado		   => alfa-numérico	=> o nome do sacado			=> o dizer: "Não informado"
endereco	   => alfa-numérico	=> o endereço do sacado			=> - (vazio)
cgc_cpf		   => numérico		=> o cgc ou cpf do sacado		=> - (vazio)



* Parâmetros necessários somente para o envio do boleto por email:

Parâmetro	      Conteúdo		   Descrição				   Valor Padrão
===================   ==================   =====================================   ==================================
boletomail	   => numérico		=> ativa ou desativa o envio de email	=> 0 (desativado)
					   com o boleto bancário.
						1 -> para ativa
						0 -> para desativa
recipiente_email   => alfa-numérico	=> e-mail do destinatário		=> - (vazio)
assunto		   => alfa-numérico	=> a linha de assunto do e-mail	com o	=> - (vazio)
					   boleto bancário


* Parâmetros opcionais que normalmente são gravados no banco de dados:

Parâmetro	      Conteúdo		   Descrição				   Valor Padrão
===================   ==================   =====================================   ==================================
sacador		   => alfa-numérico	=> o nome do sacador/avalista		=> - (vazio)
instrucoes_linha1  => alfa-numérico	=> Linha 1 das instruções do boleto	=> definido na configuração do boleto
instrucoes_linha2  => alfa-numérico	=> Linha 2 das instruções do boleto	=> definido na configuração do boleto
instrucoes_linha3  => alfa-numérico	=> Linha 3 das instruções do boleto	=> definido na configuração do boleto
instrucoes_linha4  => alfa-numérico	=> Linha 4 das instruções do boleto	=> definido na configuração do boleto
instrucoes_linha5  => alfa-numérico	=> Linha 5 das instruções do boleto	=> definido na configuração do boleto
demons1		   => alfa-numérico	=> Linha 1 do demonstrativo do boleto	=> definido na configuração do boleto
demons2	   	   => alfa-numérico	=> Linha 2 do demonstrativo do boleto	=> definido na configuração do boleto
demons3	   	   => alfa-numérico	=> Linha 3 do demonstrativo do boleto	=> definido na configuração do boleto
demons4	   	   => alfa-numérico	=> Linha 4 do demonstrativo do boleto	=> definido na configuração do boleto
demons5	   	   => alfa-numérico	=> Linha 5 do demonstrativo do boleto	=> - (vazio)
demons6	   	   => alfa-numérico	=> Linha 6 do demonstrativo do boleto	=> - (vazio)
demons7	   	   => alfa-numérico	=> Linha 7 do demonstrativo do boleto	=> - (vazio)
demons8	   	   => alfa-numérico	=> Linha 8 do demonstrativo do boleto	=> - (vazio)
demons9	   	   => alfa-numérico	=> Linha 9 do demonstrativo do boleto	=> - (vazio)



* Parâmetros normalmente não necessários:

Parâmetro	      Conteúdo		   Descrição				   Valor Padrão
===================   ==================   =====================================   ==================================
acrescimos	   => numérico		=> o valor dos acréscimos		=> - (vazio)
valor_cobrado	   => numérico		=> o valor total cobrado pelo boleto	=> - (vazio)
data_processamento => data		=> a data do processamento do boleto	=> Data do documento
especificacao_moeda=> alfa-numérico	=> Símbolo da moeda a usar		=> a expressão "R$"
quantidade         => numérico		=> a quantidade da moeda a usar		=> - (vazio)
valor_moeda        => numérico		=> o valor da cotação da moeda a usar	=> - (vazio)
descontos          => numérico		=> o valor total dos descontos		=> - (vazio)
deducoes           => numérico		=> o valor total das deduções		=> - (vazio)
multa              => numérico		=> o valor total da multa		=> - (vazio)






Exemplo de utilização: 

http://seu.site.com.br/index2.php?option=com_mamboleto&no_html=0&vencimento=20/07/2007&nosso_numero=961580786&numero_documento=123

&data_documento=16/07/2007&valor_documento=1250,00&id=6&sacado=Nome&endereco=Endereço




-Não importa como esses dados irão chegar, contanto que eles cheguem.

-Pode ser VirtueMart, phpShop, osCommerce, Facile Forms, etc...


==========================================


6. >>>>>>>>>>>>> VARIÁVEIS DISPONÍVEIS NOS ARQUIVOS CLASS DOS BANCOS


Variáveis disponíveis no Array $info:

[tipo] [vencimento] [nosso_numero] [numero_documento] [codigo_barra] [data_documento] [valor_documento]

[cgc_cpf] [agencia] [conta_cedente] [convenio] [sacado] [instrucoes_linha1] [instrucoes_linha2]

[instrucoes_linha3] [instrucoes_linha4] [instrucoes_linha5] [acrescimos] [valor_cobrado] [data_processamento]

[especificacao_moeda] [quantidade] [valor_moeda] [descontos] [deducoes] [multa] [demons1] [demons2] [demons3]

[demons4] [boletomail] [remetente_nome] [remetente_email] [recipiente_nome] [recipiente_email] [assunto]

[mensagem_texto] [mensagem_html] [enviar_pdf] [servidor_smtp] [servidor_http] [agencia_dig] [conta_cedente_dig]

[codigo_banco] [carteira] [codigo]


==========================================

Baseado em:

Adaptação do Mamboleto para Joomla! 1.0.8 e virtuemart 1.0.4
19/05/2006	messuka@messuka.com.br