Em outubro de 2009 divulguei aqui uma customização para a sessão de ticket’s do WHMCS. Hoje tem mais uma dica de customização com intuito de facilitar nossa vida. Quando algum cliente envia um ticket apartir de um contato (e-mail) não cadastrado no WHMCS ele nos informa que o mesmo não está registrado, daí vamos na aba opções e na opção ID Cliente inserimos o código do cliente e salvamo assim atribuímos o ticket para determinado cliente cadastrado. Sim e daí? Nenhuma novidade, apartir da versão 4.1.2 o WHMCS retirou o dropdown (lista) de todos os clientes e isso às vezes é meio chato para pesquisar e inserir o ID do cliente.

Lendo o fórum da WHMCS encontrei uma customização que cumpre esse papel e ficou bem interessante o resultado.

Primeiramente efetue o download do código aqui.

Descompacte o arquivo clientlist_anywhere_1.0.2.zip você encontra a pasta clientlist_anywhere_1.0.2 nela consta algumas pastas + instruções.

- Abra a pasta upload e envie para raiz do seu diretório WHMCS ( /seuwhmcs ) caso sua pasta admin seja outra renomeie para o nome correspondente.
- Assim ela enviará para os diretórios:

- ( /seuwhmcs/admin ) o arquivo ajaxclientlist.php
- ( /seuwhmcs/admin/includes/smarty/plugins ) o arquivo function.clientlist.php

Para finalizar acesse ( /seuwhmcs/admin/templates/v4 ) localize o arquivo viewticket.tpl e localize a linha 249 ou 250 e confira o trecho.

<input type=”text” name=”userid” size=”10″ value=”{$userid}” />

Substitua por:

{clientlist id=”userid” clientid=$userid width=”300px”}

Assim o campo ID cliente será substituído por o nome e sobrenome e e-mail dos clientes.

Daí você pode questionar, seria mais fácil eu localizar o ID do cliente na busca rápida (topo do WHMCS) e visualizar o ID via link? Na verdade não é mais rápido, nessa caixa você pode digitar o nome do cliente, Ex: Test e ele como está exibido por ordem alfabética irá localizar mais fácil.

Editando o arquivo ajaxclientlist.php você ainda pode exibir outros campos ao invés do nome, sobrenome e e-mail, exemplo abaixo:

Espero que tenham gostado!

Destes 3 anos que venho utilizando o WHMCS e prestando serviços para diversas empresas, uma das queixas comuns dos usuários é a “falta” de relatórios que atendam X necessidade. Até comentei em um post antigo como criamos um relatório, inicialmente não detalhei como realizamos a criação apenas colei um código já pronto.

O modelo abaixo é apenas um formato de relatório obtido em http://wiki.whmcs.com/Reports

<?php

# The title of your report
$reportdata["title"] = “”;

# The description of your report
$reportdata["description"] = “”;

# Header text – this gets displayed above the report table of data
$reportdata["headertext"] = “”;

# Report Table of Data Column Headings – should be an array of values
$reportdata["tableheadings"] = array(“Column 1″,”Column 2″,”Column 3″);

# Report Table Values – one of these lines for each row you want in the table
# should be an array of values to match the column headings
$reportdata["tablevalues"][] = array(“Data 1″,”Data 2″,”Data 3″);
$reportdata["tablevalues"][] = array(“Data 1″,”Data 2″,”Data 3″);
$reportdata["tablevalues"][] = array(“Data 1″,”Data 2″,”Data 3″);

# Report Footer Text – this gets displayed below the report table of data
$data["footertext"] = “”;

?>

Garimpando o fórum oficial da WHMCS você poderá encontrar diversos relatórios prontos que podem te dá uma luz de como adaptar algo para sua necessidade. É necessário conhecimentos básicos de HTML, PHP e Linguagem SQL.

Através do post http://forum.whmcs.com/showthread.php?t=26141 encontrei um relatório bem interessante, ele irá mostrar todas as faturas/invoices independentemente do seu status (pago/aberto/cancelada ) entre duas datas que iremos selecionar. Como o fórum é restrito apenas para assinantes (cadastro é gratuito), baixe aqui o relatório Listagem Faturas (282) e envie para /seuwhmcs/modules/reports/ em seguida acesse http://seuwhmcs.com/seuadmin/reports.php e clique no relatório Invoice Listing ou acesse http://seuwhmcs.com/seuadmin/reports.php?report=invoice_listing

A utilização é bem simples:

Ao clicar em Generate Report ele irá mostrar os seguintes campos (Invoice ID, Status, Client Name, Invoice Date, Date Paid, Subtotal, Credit, Tax, Total ), Além disso será exibido a quantidade de faturas listas + total geral.

Conforme informei é possível você personalizar de acordo com sua necessidade, na imagem abaixo fiz a tradução dos campos.

Nesta abaixo, adicionei/removi campos, criei algumas personalizações, adicionei funcionalidades do tipo clicando no número da invoice ele já abrirá a fatura e etc…

Se divirtam!

O WHMCS por padrão só exibe a última notícia publicada na página principal ( estilo portal, nova versão 4.1 ), essa personalização consiste em mostrar 5 últimas notícias publicadas de uma forma bem interessante… Confira a forma original em que a última notícia aparece:

Acesse a pasta seuwhmcs\templates\portal edite o arquivo homepage.tpl ou baixe o arquivo Notícias Personalizadas (TPL) (262) e envie para pasta.

Localize a linha 52:

{if $announcements}
<h2>{$LANG.latestannouncements}</h2>
<p>{$announcements.0.date} – <a href="{if $seofriendlyurls}announcements/{$announcements.0.id}/{$announcements.0.urlfriendlytitle}.html{else}announcements.php?id={$announcements.0.id}{/if}">{$announcements.0.title}</a><br />{$announcements.0.text|strip_tags|truncate:100:"…"}</p>
{/if}

Substitua por:

{if $announcements}
<h2>{$LANG.latestannouncements}</h2>
{php}
function formata($string, $limit, $break=" ", $pad="Leia mais…", $id=” )
{
if(strlen($string) <= $limit)
return $string;
$string = substr($string, 0, $limit);
if(false !== ($breakpoint = strrpos($string, $break)))
{
$string = substr($string, 0, $breakpoint);
}
$noticiaLink = ‘<a href="announcements.php?id=’ . $id . ‘"’ . ‘class="heading2"> ‘ . $pad . ‘</a>’;
return $string . $noticiaLink;
}
include("/dbconnect.php");
include("/includes/functions.php");
$query = "SELECT * FROM tblannouncements WHERE published=’on’ ORDER BY date DESC LIMIT 0,5";
$result = mysql_query($query);
echo’
<MARQUEE behavior= "scroll" align= "center" direction= "up" height="80"
scrollamount= "2" scrolldelay= "50" onmouseover=\’this.stop()\’ onmouseout=\’this.start()\’>
‘;
while ($data = mysql_fetch_array($result))
{
$id = $data["id"];
$date = $data["date"];
$title = $data["title"];
$ano_atual = substr($date,0,4);
$mes_atual = substr($date,5,2);
$dia_atual = substr($date,8,2);
$announcement = formata($data["announcement"], 50, ‘ ‘,’ – <b>Leia mais…</b>’, $id);
echo("<b>$dia_atual/$mes_atual/$ano_atual – $title</b> <br /> $announcement<br /><br />");
}
echo ‘</MARQUEE>’;
{/php}
{/if}

Após a personalização… será exibido as últimas 5 notícias em um esquema de rolagem automática das notícias. Ao passar o mouse sobre a notícia o rolamento automático para e você pode clicar no link Leia mais… para ler a notícia na integra.

Outras personalizações:

- É possível listar todas as notícias publicadas, basta remover o trecho LIMIT 0,5
- Alterar a velocidade da rolagem automática scrolldelay= "50". A propriedade scrolldelay corresponde à velocidade que você quer que o scroll ande. Se diminuir a velocidade, por exemplo para "50", ele anda mais rápido, se aumentar a velocidade ,por exemplo para "300", ele fica ainda mais lento.
- Alterar o tamanho da caixa height="80".

Espero que tenham gostado!

“Feche os olhos e pense em tudo que você quer… É o que desejamos que você realize em 2010!”.

Para não perder a oportunidade de falar sobre WHMCS, caso você abra seu admin do WHMCS e visualizou um erro na página principal ( barra de gráficos, imagem abaixo ), não se desepere… Esse erro é causado pela ausência de dados (pedidos/orders).

Para que o erro suma você pode gerar um pedido fictício até que um pedido real seja solicitado e pronto!

Outras novidades para WHMCS em 2010:

- Nova versão do WHMCS ( beta no final de janeiro/inicio de fevereiro ) com as seguintes funcionalidades: suporte tri-anual para planos, melhorias de usabilidade para pagamentos/faturas, códigos promocionais, itens faturáveis e etc…
- API de integração KingHost ( permitir comunicação com o painel de revendas da KingHost e o WHMCS );

Primeiro dia do ano, primeira sexta-feira, primeiro feriado nacional e um descanso merecido para todos nós, segunda-feira vem aí, risos.