docs: actualizar sección 11 PROMPT_IA — sin symlink, sin $cvFile, assets desde wp-content

This commit is contained in:
2026-06-05 11:29:47 -05:00
parent 10222e8838
commit 7aeb93bced
+24 -15
View File
@@ -316,11 +316,16 @@ https://pflores.linkedcorp.net/wp-content/plugins/pflores-cv-fields/populate-dat
### Convenciones obligatorias ### Convenciones obligatorias
1. **Directorio**: Crear en `frontend/NOMBRE-cv-theme/` con subdirectorios `assets/{css,js,images,docs}` e `inc/`. 1. **Directorio**: Crear **directamente** en `backend/wordpress/wp-content/themes/NOMBRE-cv/` con subdirectorios `assets/{css,js,images,docs}` e `inc/`.
2. **Symlink**: `ln -s /ruta/absoluta/frontend/NOMBRE-cv-theme /ruta/wordpress/wp-content/themes/NOMBRE-cv` > ⚠ **No usar symlink** — el tema `apex-cv` demostró que los archivos en `frontend/` desaparecen cuando WordPress activa/desactiva temas. El directorio real dentro de `wp-content/themes/` es la única forma estable.
3. **Text Domain**: usar `nombre` (minúsculas, sin guiones). 2. **Text Domain**: usar `nombre` (minúsculas, sin guiones).
4. **Prefijo de funciones**: `nombre_` (ej: `nova_setup()`, `nova_render_nav()`). 3. **Prefijo de funciones**: `nombre_` (ej: `nova_setup()`, `nova_render_nav()`).
5. **Prefijo CSS**: `nv-` (2-3 letras, sin conflictos con `pn-`, `lm-`, `ax-`, `cv-`). 4. **Prefijo CSS**: `nv-` (2-3 letras, sin conflictos con `pn-`, `lm-`, `ax-`, `cv-`).
5. **Copiar assets**: copiar imágenes y docs desde cualquier tema existente:
```bash
cp frontend/persona-cv-theme/assets/images/* backend/wordpress/wp-content/themes/NOMBRE-cv/assets/images/
cp frontend/persona-cv-theme/assets/docs/* backend/wordpress/wp-content/themes/NOMBRE-cv/assets/docs/
```
### Archivos mínimos requeridos ### Archivos mínimos requeridos
@@ -384,16 +389,16 @@ $competencies = $cv['competencies'];
$volunteer = $cv['volunteer']; $volunteer = $cv['volunteer'];
$additional = $cv['additional']; $additional = $cv['additional'];
// Foto de perfil: ACF primero, si no la imagen local // Foto de perfil: CMB2 primero, si no la imagen local del tema
$acfPhoto = $cv['photo'] ?? ''; $acfPhoto = $cv['photo'] ?? '';
$profileImage = $acfPhoto ?: get_template_directory_uri() . '/assets/images/patricia-flores-profile.jpeg'; $profileImage = $acfPhoto ?: get_template_directory_uri() . '/assets/images/patricia-flores-profile.jpeg';
// Archivos // QR y URL pública
$cvFile = get_template_directory_uri() . '/assets/docs/CV_Patricia_Flores_Sanchez_ES_FINAL.docx'; $qrImage = get_template_directory_uri() . '/assets/images/patricia-flores-qr.png';
$qrImage = get_template_directory_uri() . '/assets/images/patricia-flores-qr.png';
$publicUrl = 'https://pflores.linkedcorp.net'; $publicUrl = 'https://pflores.linkedcorp.net';
// ► NO usar $cvFile para botones de descarga — usar siempre home_url('/?cv_pdf=1')
// Variables de conveniencia // Variables de conveniencia del hero
$heroName = $hero['name']; $heroName = $hero['name'];
$heroRole = $hero['role']; $heroRole = $hero['role'];
$heroEmail = $hero['email']; $heroEmail = $hero['email'];
@@ -444,15 +449,19 @@ Debe contener **todos los datos reales** de Patricia Flores, idénticos a los qu
### Activar el nuevo tema ### Activar el nuevo tema
```bash ```bash
# 1. Crear el symlink # El directorio ya existe en wp-content/themes/NOMBRE-cv/ — solo activar en la BD:
ln -s /ruta/absoluta/frontend/NOMBRE-cv-theme \
/ruta/absoluta/backend/wordpress/wp-content/themes/NOMBRE-cv
# 2. Activar en la BD
mysql -u "paty.wordpress" -p"paty.wordpress" -h 192.168.222.20 "paty.wordpress" --ssl=0 \ mysql -u "paty.wordpress" -p"paty.wordpress" -h 192.168.222.20 "paty.wordpress" --ssl=0 \
-e "UPDATE cv_options SET option_value='NOMBRE-cv' WHERE option_name IN('template','stylesheet');" -e "UPDATE cv_options SET option_value='NOMBRE-cv' WHERE option_name IN('template','stylesheet');"
``` ```
### Versionar el nuevo tema
Al estar en `wp-content/themes/` directamente, añadir al staging explícitamente:
```bash
git add backend/wordpress/wp-content/themes/NOMBRE-cv/
git commit -m "feat: nuevo tema NOMBRE-cv"
```
> ⚠ **Evitar el slug `apex`** (existe un tema comercial con ese nombre en WordPress.org). > ⚠ **Evitar el slug `apex`** (existe un tema comercial con ese nombre en WordPress.org).
> Usar siempre slugs compuestos: `nova-cv`, `slate-cv`, `forma-cv`, etc. > Usar siempre slugs compuestos: `nova-cv`, `slate-cv`, `forma-cv`, etc.