- Descripción breve
- The Plugin Hooks System securely manages modifications for the original 66biolinks core system. As a platform owner, you can safely make any changes in an isolated folder, facilitating the creation of custom plugins and keeping your modifications organized. Easily install and configure via `app/public/plugins/` directory integration and ensure all changes are mirrored with `app-core`. For updates, uninstall the plugin first to prevent loss of customizations.
Instrucciones críticas:
1. Sólo output el texto traducido. No quotes, ni guiones altos, ni marcos de formato.
2. Nunca añadas notas, explicaciones o frase inicial.
3. No envuelvas el resultado en <>, "", o cualquier otro marcador.
4. Mantén los nombres propios (nombres de marca, productos) en su forma original cuando sea apropiado.
El propósito de este plugin es actuar como un gestor seguro de modificaciones para el sistema core original 66biolinks. Como dueño del plataforma, puedes realizar cualquier tipo de modificación a los archivos originales de 66biolinks de manera aislada y segura. Esto facilitará la creación de otros plugins personalizados que dependan de estas modificaciones core y mantendrá todas tus modificaciones organizadas y almacenadas de forma segura en el folder `app-core` del plugin. Cualquier vez que se instale el plugin, las modificaciones desde `app-core` serán enviadas al sistema. Cada vez que se desinstale, el sistema volverá a los archivos originales en `app-core-original`.
CÓMO INSTALAR Y CONFIGURAR PARA LA PRIMERA VEZ
======================================================
1. Para que 66biolinks reconozca el plugin:
- Copie la carpeta completa `plugin-hooks` (el contenido entero conteniendo este README.txt) a la carpeta `app/public/plugins/` de tu instalación de 66biolinks.
2. Para que 66biolinks reconozca y permita la instalación:
- Abra el archivo ORIGINAL de tu sistema ubicado en: `app/includes/plugins.php`
- Agregue el texto `'plugin-hooks',` al final de la lista del array. Esto verá algo así: Código:
return [
'pwa',
'push-notifications',
// ... otros plugins ...
'email-shield',
'plugin-hooks', <-- AÑADA ESTA LINEA AQUÍ
];
- Sin hacer esto, el plugin no aparecerá en la página de Plugins en tu panel de administración.
3. Configuración de carpetas internas (`app-core` y `app-core-original`):
- El archivo `plugins.php` también debe existir dentro de estas carpetas de copia de seguridad del plugin, y hemos dejado una versión previa listada para ti:
- `app-core/app/includes/plugins.php`
- `app-core-original/app/includes/plugins.php`
- IMPORTANTE: Cualquier vez que habilites plugins tercero adicionalmente, recuerda mantener `'plugin-hooks'` en la lista dentro de estas dos carpetas. Esto asegura que el gestor no se desactive accidentalmente al restaurar archivos.
4. Cómo añadir nuevas modificaciones de código (El Mágico):
- El secreto de este plugin es reflejar la estructura de carpeta de 66biolinks. Todo lo que pongas dentro de la carpeta `app-core/` será copiado al nivel raíz de tu sitio cuando el plugin esté activado.
- El archivo original de 66biolinks, antes de hacer cualquier modificación, debe ser copiado dentro de la carpeta `app-core-original/`.
EJEMPLO DE ESTRUCTURA VISUAL (¿QUE PUEDES HACER):
Si quieres modificar el archivo de encabezado del panel administrador (`app/views/admin/partials/header.php`) y añadir una nueva clase personalizada: Código:
Tu carpeta plugin-hooks verá así:
📁 plugin-hooks/
├── 📁 app-core-original/
│ └── 📁 app/
│ └── 📁 views/
│ └── 📁 admin/
│ └── 📁 partials/
│ └── 📄 header.php (El archivo original, sin tocar)
│
└── 📁 app-core/
└── 📁 app/
└── 📁 views/
└── 📁 admin/
└── 📁 partials/
└── 📄 header.php (Tu archivo modificado con las nuevas modificaciones)
└── 📁 themes/
└── 📁 altum/
└── 📁 assets/
└── 📁 css/
└── 📄 my-new-style.css (Nuevo archivo, que no existía en el original)LIMITACIONES Y ATENCIÓN IMPORTANTE (LEER ATENTAMENTE):
- REGLA DE CARGA ESPECIAL: Si modificas cualquier archivo directamente en el núcleo de 66biolinks fuera del folder de plugin, debes copiar la versión modificada al `app-core/` con su exacta ruta y también copiar el archivo original (sin modificaciones) al `app-core-original/`. No colocar el archivo original en el `app-core-original/`, cuando desinstales este plugin, el archivo en el sistema NO será restaurado a la versión original porque no habrá dónde recuperarlo.
- ÁMBITO LIMITADO: Este plugin COPIA Y REEMPLAZA los archivos completos. No solo añade "líneas de código". Si hay una actualización 66biolinks en el `header.php`, tu versión en `app-core` sobrescribirá las nuevas características del nuevo sistema. Esa es la razón por la que WinMerge es obligatorio cuando se actualiza!
- NO MODIFICAR DIRECTAMENTE ESTE ARCHIVO: Nunca edites archivos dentro de tus `app-core` y `app-core-original` mientras el plugin está "Activo" a través del panel. Primero deshabilita el plugin, realiza la edición en los folders del plugin, y luego activa nuevamente para que procese la copia limpia.
- ARCHIVOS NUEVOS SE BORRARÁN CUANDO DESINSTALES: El archivo `my-new-style.css` (en el ejemplo anterior) no existía originalmente. Cuando desinstales este plugin, el sistema notificará que no está en `app-core-original` y lo ELIMINARÁ de tu sitio principal para mantener limpieza. Se mantendrá guardado dentro del folder del plugin.
AVANCES EN LA VERSIÓN 3.2.0
======================================================
- Detector de Actualizaciones del Sistema: El sistema detecta automáticamente si has actualizado 66biolinks a una nueva versión.
- Apertura de Alerta de Información en el Panel Administrativo que dice: "Sistema Detectado para Actualización!".
- Este es un recordatorio para revisar tus modificaciones personalizadas (en `app-core`) antes de que se apliquen, asegurando la máxima compatibilidad.
- Verificador de Integridad Automática: Cada vez que accedes a una página administrativa, el plugin hace un seguimiento silencioso si el servidor aún permite escribir en los directorios necesarios.
- Si se encuentra un error de permiso (por ejemplo, después de cambiar de servidores o planes de alojamiento), aparecerá una alerta roja "Alerta de Permiso" que te permite solucionar el problema (chmod) antes de que cause problemas.
======================================================
CÓMO ACTUALIZAR 66BIOLINKS CON ESTE PLUGIN
======================================================
Cuando 66biolinks libere una nueva versión y quieres actualizar tu plataforma, sigue EXACTAMENTE este paso a paso para no perder tus personalizaciones:
1. DESINSTALA EL PLUGIN:
- Antes de actualizar 66biolinks, ve al panel administrativo y desinstala este plugin (Panel de Hooks).
- Esto causará que el sistema revertirá los archivos alterados a sus versiones originales (usando la copia de seguridad guardada en `app-core-original`).
2. ACTUALIZA EL SISTEMA:
- Realiza el proceso normal de actualización de 66biolinks hasta la versión más reciente.
3. COMPARA LAS VERSIONES (app-core-original):
- Descarga la nueva versión de 66biolinks (archivos de actualización pura) y usa un programa como **WinMerge** (o Beyond Compare).
- Compára este folder del plugin `app-core-original` con los archivos correspondientes de la nueva versión pura de 66biolinks.
- Actualiza los archivos dentro de `app-core-original` con los nuevos archivos sin modificaciones de actualización. El folder `app-core-original` debe ser siempre una copia exacta de los archivos puros de 66biolinks del versión actual. Recuerda mantener `'plugin-hooks'` en `plugins.php`.
4. AJUSTA TUS MODIFICACIONES (app-core):
- Usando WinMerge, compara tu folder `app-core` (donde están tus modificaciones personalizadas) con la nueva versión que ahora está en `app-core-original`.
- Migrar los nuevos códigos de actualización a tus archivos modificados dentro de `app-core`, asegurándose de que tus personalizaciones no sobrescriban las nuevas características ni rompan el sistema.
- Hacer los ajustes necesarios en tu código para evitar conflictos con la nueva versión de 66biolinks.
5. REINSTALA EL PLUGIN:
- Después de asegurarte de que `app-core-original` tenga los archivos limpios de la nueva versión y `app-core` tenga tus modificaciones correctamente integradas en el nuevo código, instala e activa nuevamente el plugin en el panel administrativo.
- El plugin aplicará tus modificaciones limpiamente sobre la nueva versión de 66biolinks.
- ⚠️ TIP ESPECIAL POST-UPDATE: Siempre limpia tu caché del navegador! Si usas Cloudflare, plugins CDN o plugins de caché de servidor, PURGE/CLEAR todos. Esto asegura que las versiones modificadas de tus archivos `.css`, `.js` y vistas se leen correctamente a todos tus usuarios.
1. Sólo output el texto traducido. No quotes, ni guiones altos, ni marcos de formato.
2. Nunca añadas notas, explicaciones o frase inicial.
3. No envuelvas el resultado en <>, "", o cualquier otro marcador.
4. Mantén los nombres propios (nombres de marca, productos) en su forma original cuando sea apropiado.
El propósito de este plugin es actuar como un gestor seguro de modificaciones para el sistema core original 66biolinks. Como dueño del plataforma, puedes realizar cualquier tipo de modificación a los archivos originales de 66biolinks de manera aislada y segura. Esto facilitará la creación de otros plugins personalizados que dependan de estas modificaciones core y mantendrá todas tus modificaciones organizadas y almacenadas de forma segura en el folder `app-core` del plugin. Cualquier vez que se instale el plugin, las modificaciones desde `app-core` serán enviadas al sistema. Cada vez que se desinstale, el sistema volverá a los archivos originales en `app-core-original`.
CÓMO INSTALAR Y CONFIGURAR PARA LA PRIMERA VEZ
======================================================
1. Para que 66biolinks reconozca el plugin:
- Copie la carpeta completa `plugin-hooks` (el contenido entero conteniendo este README.txt) a la carpeta `app/public/plugins/` de tu instalación de 66biolinks.
2. Para que 66biolinks reconozca y permita la instalación:
- Abra el archivo ORIGINAL de tu sistema ubicado en: `app/includes/plugins.php`
- Agregue el texto `'plugin-hooks',` al final de la lista del array. Esto verá algo así: Código:
return [
'pwa',
'push-notifications',
// ... otros plugins ...
'email-shield',
'plugin-hooks', <-- AÑADA ESTA LINEA AQUÍ
];
- Sin hacer esto, el plugin no aparecerá en la página de Plugins en tu panel de administración.
3. Configuración de carpetas internas (`app-core` y `app-core-original`):
- El archivo `plugins.php` también debe existir dentro de estas carpetas de copia de seguridad del plugin, y hemos dejado una versión previa listada para ti:
- `app-core/app/includes/plugins.php`
- `app-core-original/app/includes/plugins.php`
- IMPORTANTE: Cualquier vez que habilites plugins tercero adicionalmente, recuerda mantener `'plugin-hooks'` en la lista dentro de estas dos carpetas. Esto asegura que el gestor no se desactive accidentalmente al restaurar archivos.
4. Cómo añadir nuevas modificaciones de código (El Mágico):
- El secreto de este plugin es reflejar la estructura de carpeta de 66biolinks. Todo lo que pongas dentro de la carpeta `app-core/` será copiado al nivel raíz de tu sitio cuando el plugin esté activado.
- El archivo original de 66biolinks, antes de hacer cualquier modificación, debe ser copiado dentro de la carpeta `app-core-original/`.
EJEMPLO DE ESTRUCTURA VISUAL (¿QUE PUEDES HACER):
Si quieres modificar el archivo de encabezado del panel administrador (`app/views/admin/partials/header.php`) y añadir una nueva clase personalizada: Código:
Tu carpeta plugin-hooks verá así:
📁 plugin-hooks/
├── 📁 app-core-original/
│ └── 📁 app/
│ └── 📁 views/
│ └── 📁 admin/
│ └── 📁 partials/
│ └── 📄 header.php (El archivo original, sin tocar)
│
└── 📁 app-core/
└── 📁 app/
└── 📁 views/
└── 📁 admin/
└── 📁 partials/
└── 📄 header.php (Tu archivo modificado con las nuevas modificaciones)
└── 📁 themes/
└── 📁 altum/
└── 📁 assets/
└── 📁 css/
└── 📄 my-new-style.css (Nuevo archivo, que no existía en el original)LIMITACIONES Y ATENCIÓN IMPORTANTE (LEER ATENTAMENTE):
- REGLA DE CARGA ESPECIAL: Si modificas cualquier archivo directamente en el núcleo de 66biolinks fuera del folder de plugin, debes copiar la versión modificada al `app-core/` con su exacta ruta y también copiar el archivo original (sin modificaciones) al `app-core-original/`. No colocar el archivo original en el `app-core-original/`, cuando desinstales este plugin, el archivo en el sistema NO será restaurado a la versión original porque no habrá dónde recuperarlo.
- ÁMBITO LIMITADO: Este plugin COPIA Y REEMPLAZA los archivos completos. No solo añade "líneas de código". Si hay una actualización 66biolinks en el `header.php`, tu versión en `app-core` sobrescribirá las nuevas características del nuevo sistema. Esa es la razón por la que WinMerge es obligatorio cuando se actualiza!
- NO MODIFICAR DIRECTAMENTE ESTE ARCHIVO: Nunca edites archivos dentro de tus `app-core` y `app-core-original` mientras el plugin está "Activo" a través del panel. Primero deshabilita el plugin, realiza la edición en los folders del plugin, y luego activa nuevamente para que procese la copia limpia.
- ARCHIVOS NUEVOS SE BORRARÁN CUANDO DESINSTALES: El archivo `my-new-style.css` (en el ejemplo anterior) no existía originalmente. Cuando desinstales este plugin, el sistema notificará que no está en `app-core-original` y lo ELIMINARÁ de tu sitio principal para mantener limpieza. Se mantendrá guardado dentro del folder del plugin.
AVANCES EN LA VERSIÓN 3.2.0
======================================================
- Detector de Actualizaciones del Sistema: El sistema detecta automáticamente si has actualizado 66biolinks a una nueva versión.
- Apertura de Alerta de Información en el Panel Administrativo que dice: "Sistema Detectado para Actualización!".
- Este es un recordatorio para revisar tus modificaciones personalizadas (en `app-core`) antes de que se apliquen, asegurando la máxima compatibilidad.
- Verificador de Integridad Automática: Cada vez que accedes a una página administrativa, el plugin hace un seguimiento silencioso si el servidor aún permite escribir en los directorios necesarios.
- Si se encuentra un error de permiso (por ejemplo, después de cambiar de servidores o planes de alojamiento), aparecerá una alerta roja "Alerta de Permiso" que te permite solucionar el problema (chmod) antes de que cause problemas.
======================================================
CÓMO ACTUALIZAR 66BIOLINKS CON ESTE PLUGIN
======================================================
Cuando 66biolinks libere una nueva versión y quieres actualizar tu plataforma, sigue EXACTAMENTE este paso a paso para no perder tus personalizaciones:
1. DESINSTALA EL PLUGIN:
- Antes de actualizar 66biolinks, ve al panel administrativo y desinstala este plugin (Panel de Hooks).
- Esto causará que el sistema revertirá los archivos alterados a sus versiones originales (usando la copia de seguridad guardada en `app-core-original`).
2. ACTUALIZA EL SISTEMA:
- Realiza el proceso normal de actualización de 66biolinks hasta la versión más reciente.
3. COMPARA LAS VERSIONES (app-core-original):
- Descarga la nueva versión de 66biolinks (archivos de actualización pura) y usa un programa como **WinMerge** (o Beyond Compare).
- Compára este folder del plugin `app-core-original` con los archivos correspondientes de la nueva versión pura de 66biolinks.
- Actualiza los archivos dentro de `app-core-original` con los nuevos archivos sin modificaciones de actualización. El folder `app-core-original` debe ser siempre una copia exacta de los archivos puros de 66biolinks del versión actual. Recuerda mantener `'plugin-hooks'` en `plugins.php`.
4. AJUSTA TUS MODIFICACIONES (app-core):
- Usando WinMerge, compara tu folder `app-core` (donde están tus modificaciones personalizadas) con la nueva versión que ahora está en `app-core-original`.
- Migrar los nuevos códigos de actualización a tus archivos modificados dentro de `app-core`, asegurándose de que tus personalizaciones no sobrescriban las nuevas características ni rompan el sistema.
- Hacer los ajustes necesarios en tu código para evitar conflictos con la nueva versión de 66biolinks.
5. REINSTALA EL PLUGIN:
- Después de asegurarte de que `app-core-original` tenga los archivos limpios de la nueva versión y `app-core` tenga tus modificaciones correctamente integradas en el nuevo código, instala e activa nuevamente el plugin en el panel administrativo.
- El plugin aplicará tus modificaciones limpiamente sobre la nueva versión de 66biolinks.
- ⚠️ TIP ESPECIAL POST-UPDATE: Siempre limpia tu caché del navegador! Si usas Cloudflare, plugins CDN o plugins de caché de servidor, PURGE/CLEAR todos. Esto asegura que las versiones modificadas de tus archivos `.css`, `.js` y vistas se leen correctamente a todos tus usuarios.
