Recursos: Contador de Acessos
[ Versão para impressão ]

O contador de acesso é um programa que é executado no servidor web do WebCIP e que retorna para o browser uma imagem GIF contendo o número de acessos à pagina que referencia a imagem. O número de acessos é calculado pelo número de vezes que o programa contador foi executado.

INÍCIO RÁPIDO
Inclua na sua página, onde quer que a imagem do contador apareça, o seguinte código HTML:

<img src="/cgi-bin/Count.cgi?df=<login>.1&dd=A">

Obs: Não esqueça de trocar <login> pelo seu login!

ÍNDICE:

• Parâmetros para o contador
  • display
  • timezone
  • tformat
  • dformat
  • ft
  • frgb
  • tr
  • trgb
  • md
  • pad
  • dd
  • comma
  • srgb, prgb
  • chcolor
  • sh
  • df
  • incr
  • lit
  • negate
  • degrees
• FAQ

PARÂMETROS PARA O CONTADOR
Você pode especificar diversos parâmetros para alterar o comportamento padrão do contador. Opções como a cor "transparente", troca automática de cores em tempo de execução, o layout dos números, etc.

Definindo parâmetros para scripts CGI
Ao referenciar um script CGI, passa-se parâmetros na própria sequência que chama o programa. No exemplo:

<img src="/cgi-bin/Count.cgi?df=silva.1&display=time&ft=7">

Tem-se o script, referenciado por "/cgi-bin/Count.cgi", um "?" (ponto de interrogação) separador e as atribuições de valores aos parâmetros.

Atribuições de valores são na forma nome=valor. Havendo mais de uma atribuição, as mesmas devem estar separadas por "&" ("E comercial").

Espaços no valor devem ser substituídos por "+" (sinal de mais) como em "hoje=dezoito+de+julho+de+1996".

No exemplo dado, atribui-se o valor "silva.1" ao parâmetro "df", "time" ao "display" e "7" a "ft".

Parâmetros são dependentes e particulares ao script usado.

Segue abaixo a lista de parâmetros e valores aceitos pelo contador.

~ display
Especifique o que o programa deve mostrar. Os valores possíveis são:

counter

Para mostrar o contador

clock

Para mostrar a hora corrente^*

date

Para mostrar a data corrente^*

Você não precisa especificar o valor counter pois este já é assumido, por default, caso o parâmetro display não seja usado.

~ timezone
Especifica a diferença entre a data/hora mostrada e o horário padrão de Greenwich (GMT).

O valor deve ser especificado como "GMT+nnnn" ou "GMT-nnnn" onde "nnnn" é a diferença (ou o excesso), em minutos.

Este parâmetro não é necessário se o programa for usado apenas para se mostrar o contador.

~ tformat
Se o contador estiver sendo usado para apresentar a hora, este parâmetro pode ser usado para se especificar se a mesma deve ser mostrada no formato 12 ou 24 horas.

Caso se use o formato de 12 horas, o programa mostrará um indicador am ou pm.

O default é 12.

~ dformat
Se o contador estiver sendo usado para apresentar a data, este parâmetro pode ser usado para se especificar o formato da mesma.

O valor deste parâmetro pode ser qualquer combinação de MM (mês), DD (dia) e YY (ano). Por exemplo, dformat=ddmmyy mostraria a data como dia-mês-ano; já dformat=yymmdd a mostraria como ano-mês-dia.

O default é mmddyy.

~ ft
Este parâmetro especifica a largura da borda (em pixels ou pontos) ao redor da imagem apresentada pelo programa. Especificar um valor 0 faz com que nenhuma borda seja apresentada. Valores maiores ou iguais a 5 fazem que a borda sejam apresentada com efeito 3D.

Caso o parâmetro ft não seja especificado, uma borda de largura 6 será desenhada - você terá que especificar explicitamente ft=0 para que nenhuma borda seja adicionada.

~ frgb
Especifica a cor da borda em RGB (red/green/blue - vermelho, verde e azul). Os valores podem ser especificados como números decimais separados por ";" (ponto-e-vírgula, como em "frgb=128;192;128") ou pela sequência em hexadecimal ("frgb=80C080").

Caso use a forma em hexadecimal, não use prefixos ou sufixos no número, como em "#80C080", "0x80C080" ou "80C080h".

O default é (em decimal) frgb=100;139;216 ou (em hexa) frgb=648bd8.

~ tr
Especifica se a imagem terá uma cor transparente.

Você pode especificar a cor transparente com o parâmetro trgb. Caso trgb não seja especificado, a cor preta será transparente na imagem gerada.

Possíveis valores para tr são "Y" (sim) ou "N" (não, o default).

~ trgb
Especifica a cor da imagem (no formato especificado pelo parâmetro frgb) a ser "transformada" em transparente. Veja o parâmetro tr.

Se você usar trgb não será necessário especificar tr.

~ md
Especifica o número máximo de dígitos a serem apresentados. Qualquer valor entre 5 e 10, inclusive, são permitidos.

Números mais curtos que o valor deste parâmetro terão zeros adicionados à esquerda e mais longos serão truncados. O default para este parâmetro é 6.

~ pad
Especifica se os dígitos apresentados devem receber zeros à esquerda, de acordo com md.

Valores possíveis são "Y" (sim) ou "N" (não).

O default é "Y" se você usar md, "N" se não usar.

~ dd
Especifica o estilo - o desenho - dos dígitos a serem apresentados. Os valores válidos são:

A	(default)
B
C
D
E
F

Atenção: o valor deste parâmetro tem que estar em maiúsculas!

~ comma
Especifica se deve ser apresentada o sinal "," (vírgula) separando os milhares na imagem apresentada. Pode ser "Y" ou "N". "N" é o default.

Estamos encaminhando ao autor do programa a sugestão de poder-se usar, como opção, o "." (ponto) como separador de milhares, que é padrão no nosso país.

~ srgb_prgb
Use srgb para especificar uma cor da imagem (no formato especificado no parâmetro frgb) que você quer que seja alterada para a cor especificado em prgb.

O uso de prgb é obrigatório, se se usar srgb e vice-versa.

~ chcolor
Especifica se uma cor da imagem gerada deve ser trocada para outra cor.

Os valores possíveis para este parâmetro são "Y" (sim) ou "N" (não). Se "Y" for usado e não forem especificados srgb e prgb, o programa trocará o verde (0;255;0) pelo ciano (0;255;255).

O default é "N".

~ sh
Com este parâmetro você pode especificar se os dígitos serão mostrados ("Y") ou não ("N"). Em qualquer caso, o contador é incrementado.

Esta opção pode ser útil quando se quer contar o acesso a uma página sem mostrar a imagem do contador.

Se for usado sh=N, o programa retornará - e será apresentada na tela - uma imagem GIF 1x1 transparente.

~ df
Especifica a identificação do contador. No WebCIP, a identificação do contador é "<login>.1".

Pode-se usar random como valor, o que faz com que o programa retorne uma imagem com uma sequencia aleatória de números. Se df não for especificado, random será assumido.

~ incr
Este parâmetro torna possível a apresentação do contador sem que o mesmo seja incrementado.

Valores válidos são "Y" (incrementa, o default) ou "N" (não incrementa).

~ lit
Faz com que o programa mostre o valor deste parâmetro como uma imagem GIF. Por exemplo:

Eu tenho <img src="/cgi-bin/Count.cgi?lit=25" alt="alguns"border=0> anos!

Seria apresentado como:

Eu tenho anos!

~ negate
Mostra o "negativo" da imagem. Valores possíveis são "Y" (sim - mostar o "negativo") ou "N" (não, o default).

Este parâmetro não afeta a borda da imagem.

~ degrees
Possibilita mostrar a imagem com uma rotação de n graus. O valor de n deve ser 90, 180, 270 ou 360. Note que 360 não precisa ser usado, pois trás a imagem para sua posição normal.

FAQ

Ao invés de aparecer a imagem do contador, aparece uma mensagem em inglês. O que há de errado?

Cheque a sintaxe do comando do contador e seus parâmetros. Cheque se você não esqueceu o "?" separador do comando e dos parâmetros. Cheque se há caracteres "&" separando os parâmetros.

Tudo checado e ainda não funciona.

Salve a imagem apresentada e envie uma mensagem para webmaster@webcip.com.br. Anexe a imagem à mensagem.

É possível resetar o contador?

Envie uma mensagem para webmaster@webcip.com.br. Inclua na primeira linha da mensagem o texto "RESETAR CONTADOR".

É possível então alterar o meu contador para 3.892.878?

Não. O procedimento descrito na última questão é automático e reseta o contador para 1.

Incluí um relógio na minha página mas a hora está errada...

Muito provavelmente é o seu relógio é que está com a hora errada. O servidor do WebCIP tem sua hora acertada a cada 2 horas, usando como base alguns "servidores de hora" padrão na Internet, que por sua vez têm suas horas meticulosamente reguladas de acordo com os padrões internacionais.

Obviamente, não estamos levando em consideração neste caso uma falha de hardware, dos "servidores de hora" ou da própria Internet em si.