Introducción

vtiger CRM 7.2.0 incluye de serie un módulo llamado Google que permite sincronizar el Calendario de vtiger con Google Calendar. En teoría funciona “out of the box”, pero en la práctica tiene varios problemas que impiden que funcione correctamente en instalaciones reales:

• La API de Google Contacts v2 fue descontinuada en junio de 2022 y su uso causa errores HTTP 500 fatales.
• El sync inicial arranca desde 10 años atrás, lo que genera cientos de eventos históricos innecesarios.
• El botón de sincronización recarga toda la página en lugar de mostrar solo una notificación.
• El syncToken puede quedar fijado en el pasado reciente, dejando el sync sin eventos.
• Bugs en getSyncUsers() que leen la columna incorrecta de la base de datos.

En esta guía documentamos todos los pasos necesarios para tener la integración funcionando de forma bidireccional en vtiger CRM 7.2.0, con Google Calendar API v3 y OAuth2.

Requisitos previos

• vtiger CRM 7.2.0 instalado en servidor Linux con PHP 7.x
• Cuenta de Google con acceso a Google Cloud Console
• Acceso SSH y phpMyAdmin (o acceso directo a MySQL) en el servidor
• El módulo Google activo en vtiger

Paso 1 — Configurar Google Cloud Console

1.1 Activar la Google Calendar API

1. Ve a Google Cloud Console → APIs y servicios → Biblioteca
2. Busca Google Calendar API y actívala
3. No actives Google People API ni Google Contacts API — la API de Contacts v2 está descontinuada y causará errores fatales en vtiger

1.2 Crear credenciales OAuth2

1. Ve a APIs y servicios → Credenciales → Crear credenciales → ID de cliente OAuth 2.0
2. Tipo de aplicación: Aplicación web
3. En URIs de redireccionamiento autorizados agrega la URL de tu instalación vtiger:
   https://tudominio.com/index.php?module=Google&view=Authenticate&service=Google
4. Descarga o copia el Client ID y Client Secret

1.3 Configurar la pantalla de consentimiento OAuth

Este paso es crítico y frecuentemente se omite:

1. Ve a APIs y servicios → Pantalla de consentimiento OAuth
2. Estado de publicación: déjalo en “En pruebas” (Testing) si no necesitas que otros usuarios autoricen la app
3. En Usuarios de prueba, agrega el correo de la cuenta Google que usará vtiger para sincronizar

⚠️ Sin este paso, el flujo OAuth devolverá error 403 access_denied al intentar autorizar.

Paso 2 — Configurar las credenciales en vtiger

Edita el archivo modules/Google/connectors/Config.php:

<?php
Class Google_Config_Connector {
    static $clientId     = 'TU_CLIENT_ID.apps.googleusercontent.com';
    static $clientSecret = 'TU_CLIENT_SECRET';
}

Paso 3 — Correcciones de código necesarias

El módulo Google de vtiger 7.2.0 tiene varios bugs que deben corregirse manualmente.

3.1 Deshabilitar Google Contacts (API descontinuada)

Archivo: modules/Google/views/Sync.php

Busca la línea donde se define el array de módulos a sincronizar y elimina 'Contacts':

// ANTES (causa HTTP 500 — API descontinuada en 2022)
$modules = array('Contacts', 'Calendar');

// DESPUÉS
$modules = array('Calendar');

En el mismo archivo, asegúrate de capturar cualquier excepción PHP 7 correctamente:

try {
    $records = $this->invokeExposedMethod($sourceModule);
    return $records;
} catch (Zend_Gdata_App_HttpException $e) {
    error_log('[GCAL] Zend exception: ' . $e->getMessage());
    return array();
} catch (Throwable $e) {
    error_log('[GCAL] Error en sync: ' . get_class($e) . ' - ' . $e->getMessage());
    return array();
}

3.2 Fix en getSyncUsers() — columna incorrecta

Archivo: modules/Google/helpers/Utils.php

La función getSyncUsers() intentaba leer la columna id cuando el campo correcto es userid:

// ANTES
$userId = $resultrow['id'];

// DESPUÉS
$userId = $resultrow['userid'];

3.3 Cambiar el punto de inicio del sync a -30 días

Archivo: modules/Google/connectors/Vtiger.php

Por defecto, el sync inicial de WSAPP comienza desde 10 años atrás. Con cientos de eventos históricos, el proceso nunca llega a los eventos recientes. El fix es sobrescribir intialSync():

public function intialSync() {
    $registrationDetails = $this->registerWithTracker();
    $syncStateModel = new WSAPP_SyncStateModel();
    $syncStateModel->setSyncTrackerId($registrationDetails['key'])
                   ->setSyncToken(strtotime('-30 days'))
                   ->setType($this->getSynchronizeController()->getSourceType());
    return $syncStateModel;
}

3.4 Filtro de fechas en el connector de Calendar

Archivo: modules/Google/connectors/Calendar.php — función transformToTargetRecord()

Agrega un filtro para ignorar eventos con más de 30 días de antigüedad:

$cutoffTimestamp = strtotime('-30 days');
foreach ($vtEvents as $vtEvent) {
    if ($vtEvent->getMode() != WSAPP_SyncRecordModel::WSAPP_DELETE_MODE) {
        $startDate = $vtEvent->get('date_start');
        $dueDate   = $vtEvent->get('due_date');
        $eventDate = !empty($dueDate) ? $dueDate : $startDate;
        if (!empty($eventDate) && strtotime($eventDate) < $cutoffTimestamp) {
            continue; // Ignorar eventos históricos
        }
    }
    // ... resto del procesamiento
}

Paso 4 — Autorizar OAuth2 en vtiger

1. Inicia sesión en vtiger con el usuario que usará la sincronización
2. Ve a Configuración → Extensiones → Google
3. Haz clic en Autenticar con Google — se abrirá un popup OAuth
4. Autoriza con la cuenta Google que agregaste como usuario de prueba en Cloud Console
5. En la tabla de módulos, fila Calendario:
   • Google Datos: selecciona el calendario de Google destino
   • Habilitar sincronización: actívalo
   • Dirección: “Sincroniza en ambas direcciones”
6. Guarda la configuración

Paso 5 — Tablas de base de datos relevantes

Estas son las tablas que gestiona la integración, útiles para diagnóstico:

Paso 6 — Reset del sync (cuando no sincroniza nada)

Si el botón de sincronización no envía eventos a Google, el problema más común es que el syncToken en vtiger_wsapp_sync_state tiene una fecha muy reciente. Al arrancar, WSAPP busca eventos modificados después de ese timestamp y no encuentra nada nuevo.

Para diagnosticarlo, ejecuta en phpMyAdmin:

SELECT
  JSON_EXTRACT(stateencodedvalues, '$.synctoken') AS synctoken,
  FROM_UNIXTIME(JSON_EXTRACT(stateencodedvalues, '$.synctoken')) AS fecha_sync
FROM vtiger_wsapp_sync_state
WHERE name = 'Vtiger_GoogleCalendar';

Si la fecha_sync corresponde a hoy o a un momento muy reciente y no hay eventos nuevos desde entonces, ejecuta el reset:

DELETE FROM vtiger_wsapp_sync_state WHERE name = 'Vtiger_GoogleCalendar';
DELETE FROM vtiger_google_event_calendar_mapping;
DELETE FROM vtiger_google_sync WHERE googlemodule = 'Calendar';

Después del reset, al presionar Sincronizar con Google, el sistema ejecutará intialSync() fijando el punto de partida en -30 días y procesará todos los eventos del último mes.

Diagnóstico por logs del servidor

En servidores con Plesk, los logs de PHP van al error log de Apache vía proxy_fcgi. Para filtrar solo los mensajes del módulo Google:

grep "DVA_GCAL\|DVA_WSAPP\|DVA_SYNC" /var/www/vhosts/tudominio.com/logs/tucrm/error_log | tail -50

Los mensajes de debug más útiles son:

• [DVA_WSAPP_PULL] sourceRecords from vtiger: 0 → el sync token está fijado en un momento muy reciente, hacer reset
• [DVA_GCAL_PUSH] inserted OK, google_id: ... → evento insertado correctamente en Google Calendar
• [DVA_GCAL_PUSH] EXCEPTION → error al insertar, revisar permisos OAuth o calendarId

Conclusión

La integración de vtiger CRM 7.2.0 con Google Calendar es funcional una vez aplicadas las correcciones descritas. Los puntos clave a recordar son:

• ⛔ Deshabilitar Google Contacts — la API v2 está descontinuada desde 2022
• 🔄 Limitar el sync inicial a -30 días para evitar procesar historia innecesaria
• 🔑 La pantalla de consentimiento OAuth debe tener el correo del usuario como “usuario de prueba”
• 🗄️ Si el sync deja de funcionar, el primer diagnóstico es revisar el syncToken en vtiger_wsapp_sync_state

Esta configuración fue implementada y documentada en abril de 2026 sobre vtiger CRM 7.2.0. Si tienes dudas o encuentras cambios en versiones posteriores, puedes contactarnos en dvaweb.mx.

The post Guía de Integración: vtiger CRM 7.2.0 y Google Calendar appeared first on DVA Web.

PHP Fatal error:  Duplicate declaration of static variable $mod_query_details
in modules/Reports/ReportRun.php on line XXXX

A continuación te explico síntomas, causa y solución (con snippet listo para copiar/pegar).

Síntomas

• Al entrar a Reportes: pantalla en blanco o HTTP ERROR 500.
• En el log de PHP (/var/www/html/logs/php_error.log) aparece Duplicate declaration of static variable $mod_query_details.

Si aún no tienes logs, activa en config.inc.php:

ini_set(‘display_errors’, 0);
ini_set(‘log_errors’, 1);
ini_set(‘error_log’, __DIR__ . ‘/logs/php_error.log’);

Causa

Dentro de la función GenerateReport() (archivo modules/Reports/ReportRun.php) se dejó más de una línea con:

static $mod_query_details = array(); // o []

En PHP 8.x, declarar dos veces la misma variable estática dentro de la misma función es fatal.

Solución (2–3 minutos)

1. Respalda el archivo

cp modules/Reports/ReportRun.php modules/Reports/ReportRun.php.bak

1. Edita modules/Reports/ReportRun.php y ve a la función GenerateReport().
2. Deja una sola línea de inicialización estática y elimina las repetidas.
   Debe quedar solamente la primera:

// dentro de GenerateReport()
static $mod_query_details = [];
// … resto del código …

Si encuentras otras variables estáticas duplicadas dentro de la misma función

(por ejemplo $mod_fields, $modules_query, etc.), aplica el mismo criterio:

una sola declaración static por variable y por función.

1. Guarda y reinicia el servicio web (o el contenedor).

service apache2 restart
# o
docker restart <nombre_del_contenedor_web>

1. Verifica

• Abre Reportes de nuevo.
• Revisa el log: tail -n 50 logs/php_error.log.
  No debería reaparecer el fatal.

Snippet orientativo (cómo debe verse)

function GenerateReport(/* … */) {
    // ✔ Solo una declaración estática
    static $mod_query_details = [];

// Lógica de armado de queries…
    // $mod_query_details[‘Accounts’] = ‘SELECT …’;
    // …
}

Buenas prácticas relacionadas

• Mantén los logs activos (sin mostrarlos en pantalla) para detectar rápido errores en PHP 8.x.
• Si usas Monolog 2.x y tu wrapper de logger llama métodos antiguos (getLogLevel()), actualiza a isHandling()/getLevel() para evitar fatales.
• Antes de actualizar de PHP 7.x a 8.x, corre un grep para detectar posibles duplicados:
  
  grep -nE “static\s+\$[a-zA-Z0-9_]+\s*=” modules/Reports/ReportRun.php

Conclusión

Este fix es simple pero crítico: una única declaración static por variable dentro de la función. Con eso el módulo Reportes vuelve a funcionar en Vtiger 8.2 bajo PHP 8.x y evitas caídas 500 difíciles de rastrear.

The post Vtiger 8.2: fix del error 500 en Reportes por variable estática duplicada en ReportRun.php appeared first on DVA Web.

Convención de nomenclatura

La convención de nomenclatura es una de las prácticas más importantes para el desarrollo de código Java y una buena convención de nomenclatura ayuda a que el código sea más legible y fácil de entender.

Algunos consejos para la convención de nomenclatura son:

• Utilizar nombres descriptivos que reflejen la función del elemento de código.
• Utilizar nombres consistentes a lo largo del código.
• Evitar el uso de abreviaturas y acrónimos.

Organización del código

Es por eso que la organización del código es otra práctica importante para el desarrollo de código Java. Un código bien organizado es más fácil de entender y mantener, es entonces cuando te podrías ver beneficiado si todo el equipo de trabajo programa bajo una misma convención.

Algunos consejos para la organización del código son:

• Utilizar un diseño modular que divida el código en unidades más pequeñas y manejables.
• Utilizar un estilo de codificación consistente.
• Documentar el código adecuadamente.

Ejemplos de buenas prácticas

A continuación se presentan algunos ejemplos de buenas prácticas para el desarrollo de código Java:

• Utilizar comentarios para explicar el propósito del código.
• Evitar el uso de código duplicado.
• Utilizar un lenguaje claro y conciso.
• Probar el código adecuadamente.

Conclusión

Las buenas prácticas para el desarrollo de código Java son una herramienta valiosa para los desarrolladores. Al seguir estas prácticas, los desarrolladores pueden escribir código más limpio, legible y mantenible.

Recursos adicionales

• Guía de estilo de codificación Java: https://google.github.io/styleguide/javaguide.html
• Effective Java: https://www.amazon.com/Effective-Java-3rd-Joshua-Bloch/dp/0134685997
• Clean Code: https://www.amazon.com/Clean-Code-Handbook-Software-Craftsmanship/dp/0132350882

The post Buenas prácticas para el desarrollo de código Java appeared first on DVA Web.