# FICHAJES FOR <a href="https://www.dolibarr.org">DOLIBARR ERP CRM</a>

## Features
¿Necesitas un control horario para fichar?
 
Este es tu módulo para Dolibarr ERP
 
(ESPAÑA) Dada la reciente aceptación de la ley Real Decreto-ley 8/2019, de 8 de marzo: https://www.boe.es/boe/dias/2019/03/12/pdfs/BOE-A-2019-3481.pdf  especialmente en su página 23176
 
Se requiere la obligatoriedad de fichaje de todos los empleados de un empresa y la necesidad de un sistema de control de presencia, que con este módulo "FICHAJES" se puede integrar fácilmente, ya que permite usar el mismo login de acceso a Dolibarr como control de entradas y salidas, ahorrando cientos de euros en aparatos y costosas instalaciones.
Con este módulo cumples la Legalidad, al guardar durante años los registros, mostrar los resumenes al trabajador y evitar horas extras a la empresa. 
 
El módulo FICHAJES es una SOLUCIÓN completa para llevar un control de las horas trabajadas por empleados/usuarios de Dolibarr y de una forma sencilla y automatizada, puede realizar las siguientes operaciones:
 
ENTRADA, PAUSA, SALIDA.
 
Se utilizará la geolocalización del móvil o navegador para guardar donde haces el login (latitud y longitud del gps de google maps) que se realiza en cada operación de ENTRADA.
 
Así mismo crea un menú nuevo llamado FICHAJES que el propio trabajador/usuario puede visualizar sus horarios, ordenado por días con un histórico de sus entradas/pausas/salidas y por supuesto poder ejecutar acciones MANUALES como ENTRAR, SALIR o PAUSA, (si no está en modo automático en la configuración del módulo.)
En esta misma opción de menú, se muestra un Registro mensual por día totalizando las horas trabajadas.
 
La CONFIGURACIÓN del módulo, es muy sencilla:
 
-La Configuración de horarios son las horas de entradas mínimas y de salida máximas de la Empresa de Lunes a Domingo.
-Activa Fichar entrada automáticamente al iniciar sesión, si se desea que fichar una ENTRADA al hacer un login en Dolibarr 
-Activa Fichar salida automáticamente según el horario de salida configurado, si se desea fichar una SALIDA al hacer un logout (salir) de Dolibarr.
-Geolocalización, Si está Activa entonces grabará la posición del dispositivo que haga un login, geoposicionamiento.
-Permitir pausas, te crea un botón para realizar PAUSAS y sus descripciones (solicita siempre un comentario).
    Si está activado Permitir pausas:
 - Cada pausa requiere de una entrada previa, te exige que en cada pausa tengas que hacer una entrada.
-No computar entradas antes del horario labora, si lo activa tomará la hora de entrada configurada globalmente para la empresa.

-TEST Geolocalización, realiza una prueba de la correcta configuración del navegador. (Recuerde dar permisos al navegador para que permita la geolocalización)
 
En la propia configuración del módulo, pestaña REGISTROS permite ver todos los movimientos de todos los trabajadores y exportarlos a .CSV para un tratamiento con un Excel, analítica, etc.

El formato del fichero .CSV de todos los registros, es el siguiente:

- ID del registro
- Nombre del usuario
- Tipo de fichaje (Entrada, Salida, Pausa)
- Si ha sido fichaje automático (1) o manual (0)
- Descripción del fichaje (cuando es pausa)
- Coordenadas (cuando esté activado el geoposicionamiento)
- Hora con formato dd-MM-aaaa hh:mm:ss

- Dispone un listado de todos los Usuarios y la suma de horas de cada mes.

Como medida de seguridad, esta opción de exportar, solamente es accesible desde la configuración del módulo, ya que son datos sensibles.

Nota: Para el correcto funcionamiento del geoposicionamiento, es necesario que su Dolibarr disponga de https con certificado SSL muy recomendable usarlo, en general con Dolibarr, ver más en información en: https://www.genbeta.com/a-fondo/por-que-es-importante-https-y-que-implica-no-usarlo
 
Versión del Módulo: autoreador/Licencia: Asier Garcia Asenjo / AGPL
Idioma interfaz usuario: Inglés / Español
Ayuda/Soporte: No / mail a info@cdm.guru
Prerrequisitos:
Versión min Dolibarr: 6.0.X
Versión max Dolibarr: 9.0.X
Para instalar este módulo:
Descargar el archivo del módulo (module_fichajes-X.X.zip) desde la web DoliStore.com
Puede cargar el .zip en la propia gestión de módulos desde configuración o 
Descomprima el zip archivo, por ejemplo usando el comando en la carpeta /custom/
unzip module_fichajes-XX.XX.zip
El módulo está listo para ser activado. Recuerde dar permisos a los usuarios de su aplicación, como a cualquier otro módulo.

Si existe algún desfase horario, se recuerda que en la configuración del PHP, /etc/php.ini tambien tienes una directiva que dice en que zona horaria te encuentras, debe estar en:
date.timezone = "Europe/Madrid" 



<!--
![Screenshot fichajes](img/screenshot_fichajes.png?raw=true "Fichajes"){imgmd}
-->

Other modules are available on <a href="https://www.dolistore.com" target="_new">Dolistore.com</a>.



### Translations

Translations can be define manually by editing files into directories *langs*. 

<!--
This module contains also a sample configuration for Transifex, under the hidden directory [.tx](.tx), so it is possible to manage translation using this service. 

For more informations, see the [translator's documentation](https://wiki.dolibarr.org/index.php/Translator_documentation).

There is a [Transifex project](https://transifex.com/projects/p/dolibarr-module-template) for this module.
-->


<!--

Install
-------

### From the ZIP file and GUI interface

- If you get the module in a zip file (like when downloading it from the market place [Dolistore](https://www.dolistore.com)), go into
menu ```Home - Setup - Modules - Deploy external module``` and upload the zip file.


Note: If this screen tell you there is no custom directory, check your setup is correct: 

- In your Dolibarr installation directory, edit the ```htdocs/conf/conf.php``` file and check that following lines are not commented:

    ```php
    //$dolibarr_main_url_root_alt ...
    //$dolibarr_main_document_root_alt ...
    ```

- Uncomment them if necessary (delete the leading ```//```) and assign a sensible value according to your Dolibarr installation

    For example :

    - UNIX:
        ```php
        $dolibarr_main_url_root_alt = '/custom';
        $dolibarr_main_document_root_alt = '/var/www/Dolibarr/htdocs/custom';
        ```

    - Windows:
        ```php
        $dolibarr_main_url_root_alt = '/custom';
        $dolibarr_main_document_root_alt = 'C:/My Web Sites/Dolibarr/htdocs/custom';
        ```
        
### From a GIT repository

- Clone the repository in ```$dolibarr_main_document_root_alt/fichajes```

```sh
cd ....../custom
git clone git@github.com:gitlogin/fichajes.git fichajes
```

### <a name="final_steps"></a>Final steps

From your browser:

  - Log into Dolibarr as a super-administrator
  - Go to "Setup" -> "Modules"
  - You should now be able to find and enable the module



-->


Licenses
--------

### Main code

![GPLv3 logo](img/gplv3.png)

GPLv3 or (at your option) any later version.

See file COPYING for more information.

#### Documentation 

Support: info@cdm.guru +34 902 010 814


![GFDL logo](img/gfdl.png)
