# 🛠️ COMANDOS Y TROUBLESHOOTING - MOTORIDER

## 🚀 COMANDOS RÁPIDOS

### XAMPP
```powershell
# Iniciar servicios
cd C:\xampp
.\xampp-control.exe

# Verificar Apache
http://localhost

# Verificar MySQL
http://localhost/phpmyadmin
```

### Navegación
```powershell
# Ir a carpeta del proyecto
cd C:\xampp\htdocs\MOTORIDER

# Listar archivos
dir

# Ver tema
cd wp-content\themes\motorider-custom
dir
```

### WordPress
```
Admin: http://localhost/MOTORIDER/wp-admin
Frontend: http://localhost/MOTORIDER
```

---

## 🔧 SOLUCIÓN DE PROBLEMAS COMUNES

### ❌ Error: "Cannot connect to database"

**Causa:** MySQL no está corriendo o configuración incorrecta

**Solución:**
1. Abrir XAMPP Control Panel
2. Detener Apache
3. Iniciar MySQL primero
4. Luego iniciar Apache
5. Verificar wp-config.php:
```php
define('DB_NAME', 'motorider_db');
define('DB_USER', 'root');
define('DB_PASSWORD', ''); // vacío en XAMPP
define('DB_HOST', 'localhost');
```

---

### ❌ Página en Blanco (White Screen of Death)

**Causa:** Error de PHP no mostrado

**Solución:**
1. Editar wp-config.php:
```php
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', true);
```
2. Refrescar página
3. Ver errores
4. Revisar wp-content/debug.log

---

### ❌ Tema No Aparece en WordPress

**Causa:** Archivos en ubicación incorrecta

**Solución:**
1. Verificar ruta exacta:
```
C:\xampp\htdocs\MOTORIDER\wp-content\themes\motorider-custom\
```
2. Debe contener mínimo:
   - style.css
   - index.php
   - functions.php
3. Refrescar Apariencia → Temas

---

### ❌ CSS No Se Aplica

**Causa:** Caché del navegador o ruta incorrecta

**Solución:**
1. Limpiar caché: Ctrl + Shift + Delete
2. Recargar sin caché: Ctrl + Shift + R
3. Verificar en código fuente que se cargue style.css
4. Verificar permisos de archivo (lectura)

---

### ❌ JavaScript No Funciona

**Causa:** jQuery no cargado o error en script

**Solución:**
1. Abrir consola del navegador (F12)
2. Ver errores en tab "Console"
3. Verificar que jQuery esté cargado
4. Verificar ruta de main.js
5. Comprobar:
```javascript
// En consola del navegador
jQuery
// Debe mostrar función, no error
```

---

### ❌ Imágenes No Se Cargan

**Causa:** Rutas incorrectas o archivos no existen

**Solución:**
1. Verificar que archivos existan en:
```
wp-content\themes\motorider-custom\assets\images\
```
2. Verificar nombres exactos (case-sensitive)
3. Verificar extensiones (.jpg, .png, .jpeg)
4. En código, usar:
```php
<?php echo get_template_directory_uri(); ?>/assets/images/nombre.jpg
```

---

### ❌ Error 404 en Páginas

**Causa:** Permalinks no regenerados

**Solución:**
1. Ir a Ajustes → Enlaces permanentes
2. Hacer click en "Guardar cambios"
3. No cambiar nada, solo guardar
4. Probar página nuevamente

---

### ❌ Productos No Se Muestran

**Causa:** WooCommerce no configurado o sin productos

**Solución:**
1. Verificar WooCommerce instalado y activo
2. Crear al menos 1 producto:
   - Productos → Añadir nuevo
   - Título, precio, publicar
3. Ir a Tienda y refrescar
4. Verificar que producto esté "Publicado" no "Borrador"

---

### ❌ Menú No Aparece

**Causa:** Menú no asignado a ubicación

**Solución:**
1. Ir a Apariencia → Menús
2. Crear menú nuevo si no existe
3. Agregar páginas al menú
4. En "Ubicaciones del menú" marcar "Menú Principal"
5. Guardar menú

---

### ❌ Logo No Se Ve

**Causa:** Logo no subido o ruta incorrecta

**Solución:**
1. Ir a Apariencia → Personalizar
2. Identidad del sitio → Seleccionar logo
3. Subir logo.png
4. O copiar manualmente:
```
De: C:\xampp\htdocs\MOTORIDER\IMG\logo.png
A: C:\xampp\htdocs\MOTORIDER\wp-content\themes\motorider-custom\assets\images\logo.png
```

---

### ❌ WhatsApp Button No Funciona

**Causa:** Número no configurado

**Solución:**
1. Ir a Apariencia → Personalizar
2. Información de Contacto
3. WhatsApp: Ingresar número sin "+"
4. Ejemplo: 56912345678
5. Guardar y publicar

---

### ❌ Slider No Cambia

**Causa:** JavaScript no cargado o error

**Solución:**
1. Verificar consola (F12)
2. Ver si hay errores de JS
3. Verificar que main.js exista en:
```
wp-content\themes\motorider-custom\js\main.js
```
4. Limpiar caché y recargar

---

### ❌ Responsive No Funciona

**Causa:** Viewport meta tag ausente

**Solución:**
1. Verificar en header.php:
```html
<meta name="viewport" content="width=device-width, initial-scale=1.0">
```
2. Si falta, agregarlo
3. Limpiar caché

---

### ❌ Formulario de Contacto No Envía

**Causa:** Funcionalidad de envío no implementada

**Solución:**
1. Instalar Contact Form 7:
   - Plugins → Añadir nuevo
   - Buscar "Contact Form 7"
   - Instalar y activar
2. O configurar SMTP en WordPress
3. O usar plugin WP Mail SMTP

---

## 🔍 VERIFICACIÓN DE INSTALACIÓN

### Checklist de Verificación:

```powershell
# 1. XAMPP corriendo
# Abrir: http://localhost
# Debe mostrar dashboard de XAMPP

# 2. MySQL activo
# Abrir: http://localhost/phpmyadmin
# Debe mostrar phpMyAdmin

# 3. WordPress instalado
# Abrir: http://localhost/MOTORIDER
# Debe mostrar sitio WordPress

# 4. Tema activo
# Ir a: wp-admin → Apariencia → Temas
# "Motorider Custom Theme" debe estar activo

# 5. WooCommerce instalado
# Ir a: wp-admin → Plugins
# "WooCommerce" debe estar activo

# 6. Páginas creadas
# Ir a: wp-admin → Páginas
# Debe haber: Inicio, Nosotros, Contacto, Categorías

# 7. Menú configurado
# Ir a: wp-admin → Apariencia → Menús
# Debe existir "Menú Principal" con páginas

# 8. Productos creados (opcional)
# Ir a: wp-admin → Productos
# Debe haber al menos 1 producto
```

---

## 💡 COMANDOS ÚTILES DE WORDPRESS

### Reiniciar Permalinks:
```
1. Ir a: Ajustes → Enlaces permanentes
2. Guardar (sin cambiar nada)
```

### Limpiar Caché:
```powershell
# Si usas plugin de caché
WP Admin → Caché → Limpiar todo

# Si no:
Ctrl + Shift + Delete (en navegador)
```

### Regenerar Miniaturas:
```
1. Instalar plugin "Regenerate Thumbnails"
2. Herramientas → Regenerate Thumbnails
3. Regenerar todas
```

### Exportar Base de Datos:
```
1. http://localhost/phpmyadmin
2. Click en base "motorider_db"
3. Tab "Exportar"
4. Método: Rápido
5. Formato: SQL
6. Continuar
```

### Importar Base de Datos:
```
1. http://localhost/phpmyadmin
2. Click en base "motorider_db"
3. Tab "Importar"
4. Elegir archivo .sql
5. Continuar
```

---

## 🎨 PERSONALIZACIÓN RÁPIDA

### Cambiar Color Principal:
```css
/* En style.css, línea ~13 */
:root {
    --color-primary: #A27BB3; /* Cambiar este valor */
}
```

### Cambiar Tipografía:
```css
/* En style.css, línea ~33 */
body {
    font-family: 'TuFuente', sans-serif; /* Cambiar aquí */
}
```

### Velocidad del Slider:
```javascript
/* En main.js, línea ~32 */
setInterval(() => {
    currentSlide = (currentSlide + 1) % slides.length;
    showSlide(currentSlide);
}, 5000); /* Cambiar 5000 = 5 segundos */
```

---

## 🐛 DEBUGGING

### Activar Modo Debug:
```php
/* En wp-config.php */
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', true);
define('SCRIPT_DEBUG', true);
```

### Ver Errores PHP:
```php
/* Temporal en index.php del tema */
<?php
error_reporting(E_ALL);
ini_set('display_errors', 1);
?>
```

### Ver Consultas SQL:
```php
/* En wp-config.php */
define('SAVEQUERIES', true);

/* En footer.php temporal */
<?php
if (current_user_can('administrator')) {
    global $wpdb;
    echo "<pre>";
    print_r($wpdb->queries);
    echo "</pre>";
}
?>
```

---

## 📊 OPTIMIZACIÓN

### Limpiar Base de Datos:
```sql
-- En phpMyAdmin, ejecutar:
DELETE FROM wp_posts WHERE post_type = 'revision';
DELETE FROM wp_postmeta WHERE post_id NOT IN (SELECT id FROM wp_posts);
OPTIMIZE TABLE wp_posts;
OPTIMIZE TABLE wp_postmeta;
```

### Comprimir Imágenes:
```
Herramientas online:
- TinyPNG.com
- Squoosh.app
- Compressor.io

O plugin WordPress:
- Smush
- Imagify
- ShortPixel
```

### Cache del Navegador:
```apache
# En .htaccess (raíz WordPress)
<IfModule mod_expires.c>
ExpiresActive On
ExpiresByType image/jpg "access plus 1 year"
ExpiresByType image/jpeg "access plus 1 year"
ExpiresByType image/png "access plus 1 year"
ExpiresByType text/css "access plus 1 month"
ExpiresByType application/javascript "access plus 1 month"
</IfModule>
```

---

## 🔐 SEGURIDAD

### Cambiar Prefijo de Tablas:
```php
/* En wp-config.php (al instalar) */
$table_prefix = 'wp_'; // Cambiar a algo único como 'mtr_'
```

### Ocultar Versión de WordPress:
```php
/* En functions.php del tema */
remove_action('wp_head', 'wp_generator');
```

### Deshabilitar Edición de Archivos:
```php
/* En wp-config.php */
define('DISALLOW_FILE_EDIT', true);
```

---

## 📞 RECURSOS ADICIONALES

### Documentación:
- WordPress: https://wordpress.org/support/
- WooCommerce: https://woocommerce.com/documentation/
- PHP: https://www.php.net/manual/es/

### Comunidad:
- WordPress.org Forums
- Stack Overflow
- Reddit: r/WordPress

### Herramientas:
- phpMyAdmin: http://localhost/phpmyadmin
- WordPress Dashboard: http://localhost/MOTORIDER/wp-admin

---

## ✅ TESTING CHECKLIST

Antes de lanzar, verificar:

- [ ] Todas las páginas cargan sin errores
- [ ] Menú funciona en desktop y móvil
- [ ] Slider del hero cambia automáticamente
- [ ] Productos se pueden agregar al carrito
- [ ] Formulario de contacto funciona
- [ ] WhatsApp button abre conversación
- [ ] Imágenes cargan correctamente
- [ ] Responsive funciona en móvil
- [ ] No hay errores en consola (F12)
- [ ] Links internos funcionan
- [ ] Búsqueda funciona
- [ ] Footer muestra información correcta
- [ ] Redes sociales enlazan correctamente

---

**Si el problema persiste:**
1. Revisar console del navegador (F12)
2. Revisar wp-content/debug.log
3. Consultar documentación específica
4. Contactar soporte: contacto@quieroventas.cl

---

**Desarrollado por QuieroVentas.cl** 🛠️  
**Actualizado:** Noviembre 2025
