Saltar al contenido principal

Guía de Instalación Rápida

Instalación en 3 Pasos​

Paso 1: Copiar el Plugin​

Copia la carpeta completa a tu instalación de WordPress:

# Opción A: Linux/Mac
cp -r "SISTEMA DE REPARACIONES" /ruta/a/wordpress/wp-content/plugins/sistema-reparaciones

# Opción B: Windows (PowerShell)
Copy-Item -Path "SISTEMA DE REPARACIONES" -Destination "C:\xampp\htdocs\wordpress\wp-content\plugins\sistema-reparaciones" -Recurse

# Opción C: Windows (CMD)
xcopy "SISTEMA DE REPARACIONES" "C:\xampp\htdocs\wordpress\wp-content\plugins\sistema-reparaciones" /E /I

Paso 2: Ejecutar el Verificador de Requisitos​

Antes de activar el plugin, abre en tu navegador:

http://tu-sitio.com/wp-content/plugins/sistema-reparaciones/install.php

Este instalador automático verificará:

  • ✅ Versión de PHP (>= 7.4)
  • ✅ Versión de WordPress (>= 6.0)
  • ✅ Extensiones PHP requeridas
  • ✅ Conexión a base de datos
  • ✅ Permisos de archivos
  • ✅ Archivos del plugin

Si todo está OK, continúa al paso 3. Si hay errores, corrígelos antes de continuar.

Paso 3: Activar el Plugin​

  1. Ve a WordPress Admin → Plugins → Plugins instalados
  2. Busca "Sistema de Gestión de Reparaciones"
  3. Haz clic en "Activar"

La activación creará automáticamente:

  • 11 tablas en la base de datos
  • 5 roles personalizados
  • Configuración por defecto
  • Capabilities para administradores

Configuración Inicial (5 minutos)​

1. Crear Tu Primera Tienda​

-- Opción A: Insertar directamente en la BD (temporal)
INSERT INTO wp_sr_shops (name, code, email, phone, status, created_at)
VALUES (
    'Mi Taller de Reparaciones',
    'taller-principal',
    'info@mitaller.com',
    '+34 600 123 456',
    'active',
    NOW()
);

O espera a que se implemente la interfaz de administración de tiendas.

2. Asignar Rol al Usuario Principal​

  1. Ve a Usuarios → Todos los usuarios
  2. Edita tu usuario
  3. Cambia el rol a "Propietario de Taller" o mantén "Administrator"
  4. Guarda los cambios

3. Configurar Notificaciones (Opcional)​

  1. Ve a Reparaciones → Configuración → Notificaciones
  2. Configura SMTP o usa wp_mail() por defecto
  3. Personaliza plantillas de email
  4. Activa notificaciones automáticas

Verificar que Todo Funciona​

Verificación de Tablas​

-- Conectar a MySQL
mysql -u usuario -p nombre_base_datos

-- Verificar tablas creadas
SHOW TABLES LIKE 'wp_sr_%';

-- Deberías ver 11 tablas:
-- wp_sr_budgets
-- wp_sr_customers
-- wp_sr_devices
-- wp_sr_invoices
-- wp_sr_notifications
-- wp_sr_order_parts
-- wp_sr_parts
-- wp_sr_repair_orders
-- wp_sr_shops
-- wp_sr_status_history
-- wp_sr_stock_movements

Verificación de Roles​

-- Ver roles creados
SELECT option_value FROM wp_options WHERE option_name = 'wp_user_roles';

O desde PHP:

// En wp-admin/admin-ajax.php o Functions
$roles = wp_roles()->roles;
print_r( array_keys( $roles ) );

// Deberías ver:
// sr_shop_owner
// sr_manager
// sr_technician
// sr_receptionist
// sr_customer

Verificación del Menú​

Después de activar, deberías ver en el admin:

  • ✅ Menú "Reparaciones" en la barra lateral
  • ✅ Submenús: Dashboard, Órdenes, Clientes, Inventario, Presupuestos, Facturas, Reportes, Configuración

Seguridad Post-Instalación​

IMPORTANTE: Eliminar el Instalador​

Por seguridad, ELIMINA el archivo install.php después de la instalación:

# Linux/Mac
rm /ruta/a/wordpress/wp-content/plugins/sistema-reparaciones/install.php

# Windows
del C:\xampp\htdocs\wordpress\wp-content\plugins\sistema-reparaciones\install.php

Habilitar WP_DEBUG (Solo Desarrollo)​

Para desarrollo, edita wp-config.php:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
define( 'SCRIPT_DEBUG', true );

Los logs aparecerán en /wp-content/debug.log.

Checklist de Instalación​

  • Plugin copiado a wp-content/plugins/sistema-reparaciones/
  • Ejecutado install.php y todas las verificaciones en verde
  • Plugin activado desde WordPress admin
  • Menú "Reparaciones" visible en el admin
  • 11 tablas creadas en la base de datos
  • 5 roles creados
  • Primera tienda creada
  • Usuario principal con rol asignado
  • Archivo install.php eliminado por seguridad
  • Configuración de notificaciones (opcional)
  • Backup de la base de datos realizado

Solución de Problemas​

El plugin no aparece en el listado​

Causa: Carpeta mal colocada o nombre incorrecto

Solución:

  • Verifica que esté en wp-content/plugins/sistema-reparaciones/
  • El archivo principal debe ser sistema-reparaciones.php
  • Permisos: chmod 755 en la carpeta

Error al activar el plugin​

Causa: Requisitos no cumplidos

Solución:

  • Ejecuta install.php para ver qué falta
  • Verifica PHP >= 7.4 con php -v
  • Verifica WordPress >= 6.0 en Dashboard → Actualizaciones

Las tablas no se crean​

Causa: Error en la base de datos

Solución:

// Ejecutar manualmente desde wp-admin/admin-ajax.php
require_once WP_PLUGIN_DIR . '/sistema-reparaciones/includes/database/class-database.php';
SR_Database::create_tables();

Los roles no aparecen​

Causa: Error en la activación

Solución:

// Ejecutar manualmente
require_once WP_PLUGIN_DIR . '/sistema-reparaciones/includes/class-activator.php';
SR_Activator::activate();

No aparece el menú "Reparaciones"​

Causa: Usuario sin permisos o error en class-menu.php

Solución:

  • Verifica que tu usuario sea Administrator o tenga rol sr_shop_owner
  • Revisa errores en wp-content/debug.log

Siguiente Paso​

Una vez instalado correctamente:

  1. Lee la Introduccion para uso completo
  2. Lee la Arquitectura del Sistema si vas a desarrollar
  3. Empieza a crear órdenes de reparación

¡Listo!​

El plugin está instalado y funcionando. Ahora puedes:

  • ✅ Crear órdenes de reparación
  • ✅ Gestionar clientes
  • ✅ Controlar inventario
  • ✅ Emitir presupuestos y facturas
  • ✅ Ver reportes y estadísticas

¡Bienvenido al Sistema de Gestión de Reparaciones! 🔧