File: README.es

README FILE componentefilecounter
.................................
 
filecounter es un componente de uso general como contador de
clicks, ya sea de ficheros o de url's.

El soporte para este contador es sobre MySQL.
La estructura de la tabla necesaria se encuentra en el
fichero filecounter.sql.

INSTALACION
...........

1. Descomprimir el tgz donde queramos dentro de la estructura
de directorios del apache.

2. Editar el fichero filecounter.php y cambiar segun sea necesario
los datos de conexion a MySQL asi como la ruta desde la cual vamos
a incluir el componente.

3. Donde queramos meter el componente en nuestro web site hacer un 
simple include del fichero filecounter.php.

El modo de uso se encuentra explicado dentro del test funcional que
acompaña, aunque de todos modos paso a explicar un poco el como hacerlo...

USO
...

Lo primero que hemos de hacer  antes de nada es crear una instancia de filecounter:
  
  $FileCounter = new filecounter();
  
Como parametros podemos pasarle el file que queremos subir el contador, y el modo
en que este tratara el fichero cuando suba su cuenta.
Por defecto no es necesario decirle el fichero, y el modo por defecto es el de
abrir en nueva ventana.

Los unicos metodos que hemos de usar son los siguientes:

  $FileCounter->CambiaFile ("http://www.yahoo.com");
  
  - Cambiamos el fichero que vamos a tratar.
  Si no existe en la base de datos el lo creara.
  
  $YahooHref   = "<a href=".$FileCounter->DameHref().">Click aqui para subir YAHOO</a>";
  
  - Nos da el href completo que debemos printear en pantalla.
  
  $Puntos = $FileCounter->DameDatos ("counter");
  
  - Recogemos los puntos actuales.
  
Con estos tres metodos no deberiamos tener la necesidad de nada mas.
Un ejemplo mas detallado lo tienes dentro de testfuncional.php.

MODOS
.....

Los modos en los que filecounter trata los ficheros una vez ha realizado el
aumento de su cuenta pueden variarse.
Para ello tan solo debemos crear un nuevo metodo con el nombre ModoNombrenuevomodo(),
y ponerlo dentro del array ModosValidos...

Ver ModoOpen dentro del codigo de la clase para mas detalles.

PRECAUCIONES
............

En esta primera version al tratar del mismo modo tanto ficheros como url como
cualquier cosa que se le pase, ten cuidado cuando le des una url...
Esta debes darsela con el http:// completo (http://www.loquesea.com)...

Y los ficheros con la ruta completa o realtiva, eso como quieras....



TODO
....

Paso del identificador en lugar del file.
Deteccion del tipo de file (url, file..).


Para cualquier duda o aclaracion mailme: contacto@markitos.net

;. markitos.net
:. mArKitos 2oo2