Custom Cursor WP

Un plugin de WordPress que te permite cambiar el cursor del sitio web por imágenes personalizadas de ovni.

🚀 Características

• Cursor personalizado: Cambia el cursor normal por una imagen de ovni
• Cursor para enlaces: Cursor especial cuando pasas el mouse sobre enlaces y botones
• Panel de administración: Configura fácilmente las imágenes del cursor
• Compatibilidad: Funciona con todos los temas de WordPress
• Responsivo: Se adapta a dispositivos móviles
• Accesibilidad: Respeta las preferencias de accesibilidad del usuario

🖼️ Vista Previa

Cursor Normal (Default)

Cursor para Enlaces (Pointer)

📦 Instalación

Método 1: Instalación manual (Recomendado para desarrollo)

1. Descarga o clona este repositorio
2. Sube la carpeta custom-cursor-wp a tu directorio /wp-content/plugins/
3. Activa el plugin desde el panel de administración de WordPress
4. Ve a Ajustes > Custom Cursor para configurar

Método 2: Instalación desde ZIP

1. Comprime la carpeta del plugin en un archivo ZIP
2. Ve a Plugins > Añadir nuevo > Subir plugin en WordPress
3. Sube el archivo ZIP
4. Activa el plugin
5. Configura desde Ajustes > Custom Cursor

⚙️ Configuración

Configuración básica

1. Activa el plugin
2. Ve a Ajustes > Custom Cursor
3. Configura las URLs de las imágenes:
   • Cursor Normal: Imagen para el cursor general (recomendado: 32x32px)
   • Cursor para Enlaces: Imagen para enlaces y botones

Imágenes incluidas

El plugin incluye dos imágenes de ovni:

• cursor-default.png - Para el cursor normal
• cursor-pointer.png - Para enlaces y botones

🎨 Personalización

Cambiar imágenes del cursor

Puedes reemplazar las imágenes incluidas o usar URLs externas:

1. Sube tus propias imágenes al directorio del plugin
2. Actualiza las URLs en la configuración
3. Las imágenes se aplicarán automáticamente

Estilos CSS personalizados

El plugin incluye estilos CSS que puedes personalizar en assets/css/custom-cursor.css.

JavaScript personalizado

Puedes extender la funcionalidad modificando assets/js/custom-cursor.js.

🔧 Desarrollo

Estructura del plugin

custom-cursor-wp/
├── custom-cursor-wp.php      # Archivo principal del plugin
├── assets/
│   ├── css/
│   │   └── custom-cursor.css # Estilos CSS
│   └── js/
│       └── custom-cursor.js  # Funcionalidades JavaScript
├── cursor-default.png        # Imagen del cursor normal
├── cursor-pointer.png        # Imagen del cursor para enlaces
├── ejemplo-default.png       # Imagen de ejemplo para cursor normal
├── ejemplo-pointer.png       # Imagen de ejemplo para cursor de enlaces
└── README.md                # Este archivo

Hooks disponibles

El plugin incluye varios hooks para desarrolladores:

• custom_cursor_wp_before_css - Antes de generar el CSS
• custom_cursor_wp_after_css - Después de generar el CSS
• custom_cursor_wp_settings_saved - Cuando se guardan las configuraciones

Ejemplo de uso de hooks

// Agregar CSS personalizado
add_action('custom_cursor_wp_after_css', function() {
    echo '<style>.mi-clase { cursor: url("mi-imagen.png"), auto; }</style>';
});

// Modificar configuraciones antes de guardar
add_filter('custom_cursor_wp_settings', function($settings) {
    // Modificar $settings aquí
    return $settings;
});

🧪 Modo Debug

Para activar el modo debug y probar los cursores:

1. Agrega ?debug_cursor=true a cualquier URL de tu sitio
2. Usa las teclas:
   • 1 - Cambiar a cursor normal
   • 2 - Cambiar a cursor de enlace

📱 Compatibilidad

• WordPress: 5.0+
• PHP: 7.4+
• Navegadores: Chrome, Firefox, Safari, Edge (versiones modernas)
• Temas: Compatible con todos los temas de WordPress
• Plugins: Compatible con la mayoría de plugins

🐛 Solución de problemas

El cursor no cambia

1. Verifica que el plugin esté activado
2. Limpia la caché del navegador
3. Verifica que las URLs de las imágenes sean correctas
4. Comprueba la consola del navegador para errores

Problemas con temas específicos

Algunos temas pueden tener CSS que sobrescribe el cursor. En estos casos:

1. Usa !important en el CSS del plugin
2. Contacta al desarrollador del tema
3. Usa el hook custom_cursor_wp_after_css para CSS adicional

Problemas de rendimiento

Si experimentas problemas de rendimiento:

1. Optimiza las imágenes del cursor (formato PNG, tamaño apropiado)
2. Considera usar imágenes WebP para navegadores modernos
3. Verifica que no haya conflictos con otros plugins

🤝 Contribuciones

¡Las contribuciones son bienvenidas! Para contribuir:

1. Haz un fork del repositorio
2. Crea una rama para tu feature (git checkout -b feature/nueva-funcionalidad)
3. Haz commit de tus cambios (git commit -am 'Agregar nueva funcionalidad')
4. Haz push a la rama (git push origin feature/nueva-funcionalidad)
5. Abre un Pull Request

📄 Licencia

Este plugin está licenciado bajo la GPL v2 o posterior.

🙏 Agradecimientos

• Imágenes de ovni creadas para este plugin
• Comunidad de WordPress por el soporte
• Contribuidores y testers

📞 Soporte

Para soporte técnico:

• Abre un issue en GitHub
• Contacta al desarrollador
• Consulta la documentación de WordPress

---

Custom Cursor WP - Hace que tu sitio web sea más divertido con cursores de ovni personalizados! 🛸