AgentSkillsCN

Wp Plugin Update

Wp 插件更新

SKILL.md

Update WordPress Plugin - Skill

Descripción

Actualiza plugins de WordPress de forma segura: pre-check de compatibilidad, backup automático, rollback si falla.

Cuándo usar

code
"Actualiza el plugin X"
"¿Puedes actualizar todos los plugins?"
"Revisa si hay actualizaciones de plugins"
"El plugin X está haciendo algo raro"

Flujo de Ejecución

Pre-Update Checks

bash
# 1. Verificar estado actual
cd /home/pepe/runart-foundry/wp-content
wp plugin list 2>/dev/null || echo "WP CLI not available"

# 2. Verificar compatibilidad WordPress
# Checar requirements en plugin header
grep -r "Requires: " plugins/*/  | grep -oP '\d+\.\d+' 

# 3. Backup de plugins
tar -czf ../backups/plugins-$(date +%Y%m%d-%H%M%S).tar.gz plugins/

# 4. Verificar dependencias
cat plugins/plugin-name/composer.json 2>/dev/null | jq .require 2>/dev/null || echo "No Composer"

Update Process (WP-CLI)

bash
# Opción 1: Plugin individual
wp plugin update plugin-name --allow-root

# Opción 2: Todos los plugins
wp plugin update --all --allow-root

# Opción 3: Con verificación
wp plugin update plugin-name \
  --allow-root \
  --dry-run  # Primero ver qué cambiaría

Post-Update Validation

bash
# 1. Verificar plugin activación
wp plugin status plugin-name --allow-root

# 2. Chequear errors en PHP
php -l wp-content/plugins/plugin-name/ 2>&1 | grep -i error

# 3. Verificar site sigue funcional
curl -s https://staging.runartfoundry.com/wp-json/wp/v2/posts | jq .errors 2>/dev/null

# 4. Revisar logs de error
tail -20 ../logs/error.log

Decisiones Importantes

Si actualización FALLA:

bash
# 1. Rollback automático
tar -xzf ../backups/plugins-latest.tar.gz
rm -rf plugins/plugin-name
tar -xzf ../backups/plugins-*.tar.gz --strip-components=1

# 2. Reactivar plugins previos
wp plugin activate plugin-name --allow-root

# 3. Verificar site
curl https://staging.runartfoundry.com/health

Conflictos Comunes

  • ❌ Plugin requiere WordPress 6.5, tienes 6.9 → Generalmente OK (forward compatible)
  • ❌ Conflicto con otro plugin → Desactivar temporalmente el otro
  • ❌ Fatal Error after update → Rollback + contact support

Plugins Críticos (tener cuidado)

code
runart-custom/          # Custom plugin runart
rest-api/               # API REST importante
content-manager/        # Gestor de contenido
performance-cache/      # Caché crítico para performance

Salida Esperada

✅ Actualización exitosa

code
Downloading update from https://downloads.wordpress.org/...
Unpacking the update...
Installing the latest version...
Plugin updated successfully.

❌ Error

code
Error: The plugin does not have a valid header.
Warning: Plugin dependency conflict with plugin-x

Documentación

Métricas

  • Tiempo típico: 2-5 minutos
  • Riesgo: BAJO (con estos checks)
  • Rollback tiempo: <1 minuto