- Description courte
- 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.
L'objectif de ce plugin est d'être un gestionnaire sécurisé pour les modifications du système de base 66biolinks. En tant que propriétaire du site, vous pouvez effectuer n'importe quelle modification aux fichiers de base 66biolinks dans un environnement isolé et sécurisé. Cela facilitera la création de plugins personnalisés qui dépendent de ces modifications de base et gardera toutes vos modifications organisées et stockées dans le dossier `app-core` du plugin. Chaque fois que le plugin est installé, les modifications de `app-core` seront envoyées aux fichiers système. Chaque fois qu'il sera désinstallé, le système retournera aux fichiers de base `app-core-original`.======================================================
HOW TO INSTALL AND CONFIGURE FOR THE FIRST TIME
======================================================1. Pour que 66biolinks reconnaît ce plugin :
- Copiez entièrement le dossier `plugin-hooks` (contenant tout le contenu incluant cette README.txt) dans le répertoire `app/public/plugins/` de votre installation de 66biolinks.2. Pour que 66biolinks reconnaît et permette l'installation du plugin :
- Ouvrez le fichier ORIGINAL de votre système situé à : `app/includes/plugins.php`
- Ajoutez la phrase `'plugin-hooks',` en fin d'ensemble des éléments dans l'array. Il devrait ressembler quelque chose comme ça:Code:
return [
'pwa',
'push-notifications',
// ... autres plugins ...
'email-shield',
'plugin-hooks', <-- AJOUTEZ CETTE LIGNE ICI
];- Sans cela, le plugin ne sera même pas visible sur la page des Plugins dans votre panneau d'administration.3. Configuration des répertoires internes (`app-core` et `app-core-original`) :
- Le fichier `plugins.php` DOIT également exister dans ces dossiers de sauvegarde du plugin, nous avons déjà la version prévisualisée prête pour eux:
- `app-core/app/includes/plugins.php`
- `app-core-original/app/includes/plugins.php`
- IMPORTANT : Chaque fois que vous activez des plugins tiers supplémentaires, gardez `'plugin-hooks'` dans l'array de ces deux dossiers. Cela garantit que le gestionnaire ne s'éteindra pas accidentellement lorsqu'il restaure les fichiers.4. Comment ajouter de nouvelles modifications de code (Le Magique) :
- Le secret de ce plugin est de refléter la structure des répertoires de 66biolinks. Toutes les choses que vous mettez dans le dossier `app-core/` seront copiées au niveau racine de votre site lorsque le plugin sera activé.
- Le fichier original de 66biolinks, AVANT d'avoir effectué toute modification, DOIT être copié dans le répertoire `app-core-original/`.STRUCTURE VISUELLE DE L'EXEMPLE (CE QUE VOUS POUVEZ FAIRE)Si vous voulez modifier le fichier du en-tête de la barre d'administration (`app/views/admin/partials/header.php`) et ajouter une nouvelle classe personnalisée:Code:
Votre dossier plugin-hooks devrait ressembler à ça :
📁 plugin-hooks/
├── 📁 app-core-original/
│ └── 📁 app/
│ └── 📁 views/
│ └── 📁 admin/
│ └── 📁 partials/
│ └── 📄 header.php (Le fichier original, non modifié)
│
└── 📁 app-core/
└── 📁 app/
└── 📁 views/
└── 📁 admin/
└── 📁 partials/
└── 📄 header.php (Votre fichier modifié avec les nouvelles modifications)
└── 📁 themes/
└── 📁 altum/
└── 📁 assets/
└── 📁 css/
└── 📄 my-new-style.css (Nouveau fichier qui n'existait pas dans l'original)LIMITATIONS ET IMPORTANTES SOINS (LIRE ATTENTIVEMENT):
- RÈGLE DE SÉCURITÉ: Si vous modifiez n'importe quel fichier directement dans le cœur de 66biolinks (hors du dossier plugin), vous devez MANDATAIREMENT copier la version modifiée vers `app-core/` avec son chemin exact, et aussi copier le fichier original (sans modifications) vers `app-core-original/`. Si vous ne placez pas la version originale dans le dossier `app-core-original/`, lorsque vous désinstallez ce plugin, le fichier dans l'ensemble SYSTEME NE SERA PAS restauré à l'original car le système n'aura nulle part d'où récupérer la sauvegarde.
- SCOPÉE: Ce plugin COPIE ET REMPLACE les fichiers entiers. Il ne s'agit pas de simplement ajouter "des lignes de code". Si il y a une mise à jour 66biolinks dans le fichier `header.php`, votre version dans `app-core` va écraser les nouvelles fonctionnalités de la mise à jour. C'est pourquoi WinMerge est obligatoire lorsqu'on met à jour!
- NE PAS MODIFIER CE FICHIER DIRECTEMENT: Ne pas modifier les fichiers qui se trouvent dans vos `app-core` et `app-core-original` pendant que le plugin est "Activé" via l'onglet. Avant de faire des modifications, désactivez d'abord le plugin, faites-les dans les dossiers du plugin, puis réactivez pour qu'il procède à la copie propre.
- NOUVEAUX FICHIERS SONT SUPPRIMÉS LORS DE LA DÉSINSTALATION: Le fichier `my-new-style.css` (comme dans l'exemple ci-dessus) n'existait pas dans l'original. Quand vous désinstallez ce plugin, le système remarquera qu'il ne se trouve plus dans `app-core-original` et supprimera le fichier de votre site principal pour maintenir la propreté. Il restera sauvegardé à l'intérieur du dossier plugin.
======================================================
AVANTAGES AVANCÉS DANS LA VERSION 3.2.0
======================================================
1. Détektor de Mise à Jour Système:
- Le système détecte automatiquement si vous avez mis à jour 66biolinks vers une nouvelle version.
- Une alerte d'information bleue apparaîtra dans votre Onglet Administrateur disant: "Mise à jour du Système détectée!".
- C'est un rappel pour vérifier vos modifications personnalisées (dans `app-core`) avant qu'ils ne soient réappliqués, garantissant la compatibilité maximale.
2. Contrôleur d'Intégrité Automatique:
- Chaque fois que vous accéderez à une page de gestionnaire, le plugin vérifiera silencieusement si le serveur permet toujours l'écriture dans les répertoires nécessaires.
- Si un problème de permission est trouvé (par exemple, après avoir changé de serveurs ou d'accords de hébergement), une alerte rouge "Alerte de Permission" apparaîtra, vous permettant de corriger le problème (chmod) avant qu'il ne cause des problèmes.
======================================================
COMMENT METTRE À JOUR 66BIOLINKS AVEC CE PLUGIN
======================================================
Lorsque 66biolinks sort une nouvelle version et que vous voulez mettre à jour votre plateforme, suivez EXACTEMENT ces étapes étape par étape pour ne pas perdre vos customisations:1. DÉSINSTALLEZ LE PLUGIN:
- Avant de mettre à jour 66biolinks, allez dans l'onglet administrateur et désinstallez ce plugin (Plugin Hooks System).
- Cela fera revenir les fichiers modifiés vers leurs versions originales (utilisant la sauvegarde enregistrée dans `app-core-original`).2. METTRE À JOUR LE Système:
- Effectuez le processus normal de mise à jour de 66biolinks jusqu'à la dernière version.3. COMPARER LES VERSIONS (app-core-original):
- Téléchargez la nouvelle version de 66biolinks (seulement les fichiers d'actualisation) et utilisez un programme comme **WinMerge** (ou Beyond Compare).
- Comparez ce dossier `app-core-original` du plugin avec les fichiers correspondants de la VERSION NEUVE pure de 66biolinks.
- Mettez à jour les fichiers dans `app-core-original` avec les nouveaux fichiers d'actualisation non modifiés. Le dossier `app-core-original` doit toujours être un miroir exact des fichiers de la version actuelle de 66biolinks. N'oubliez pas de conserver `'plugin-hooks'` dans `plugins.php`.4. ADAPTER VOS MODIFICATIONS (app-core):
- Utilisez WinMerge pour comparer votre dossier `app-core` (où vos modifications personnalisées se trouvent) avec la version mise à jour qui est maintenant dans `app-core-original`.
- Transfert les nouvelles commandes d'actualisation dans vos fichiers modifiés dans `app-core`, en veillant à ce que vos customisations ne remettent pas à niveau les nouvelles fonctionnalités ou cassent le système.
- Faites les ajustements nécessaires dans votre code pour éviter tout conflit avec la nouvelle version de 66biolinks.5. RÉINSTALLEZ LE PLUGIN:
- Après avoir vérifié que `app-core-original` a des fichiers propres de la nouvelle version et que `app-core` a intégré correctement vos modifications dans le nouveau code, installez et activez à nouveau le plugin via l'onglet administrateur.
- Le plugin appliquera vos modifications proprement sur la nouvelle version de 66biolinks.
- ⚠️ TIP DÉCOUPLAGE POST-MISE À JOUR: N'oubliez pas de nettoyer votre cache de navigateur! Si vous utilisez Cloudflare, CDN ou des plugins de cache serveur, purgez/clevez-les tous. Cela garantit que les versions modifiées de vos fichiers `.css`, `.js` et vue sont lues correctement par tous vos utilisateurs.
HOW TO INSTALL AND CONFIGURE FOR THE FIRST TIME
======================================================1. Pour que 66biolinks reconnaît ce plugin :
- Copiez entièrement le dossier `plugin-hooks` (contenant tout le contenu incluant cette README.txt) dans le répertoire `app/public/plugins/` de votre installation de 66biolinks.2. Pour que 66biolinks reconnaît et permette l'installation du plugin :
- Ouvrez le fichier ORIGINAL de votre système situé à : `app/includes/plugins.php`
- Ajoutez la phrase `'plugin-hooks',` en fin d'ensemble des éléments dans l'array. Il devrait ressembler quelque chose comme ça:Code:
return [
'pwa',
'push-notifications',
// ... autres plugins ...
'email-shield',
'plugin-hooks', <-- AJOUTEZ CETTE LIGNE ICI
];- Sans cela, le plugin ne sera même pas visible sur la page des Plugins dans votre panneau d'administration.3. Configuration des répertoires internes (`app-core` et `app-core-original`) :
- Le fichier `plugins.php` DOIT également exister dans ces dossiers de sauvegarde du plugin, nous avons déjà la version prévisualisée prête pour eux:
- `app-core/app/includes/plugins.php`
- `app-core-original/app/includes/plugins.php`
- IMPORTANT : Chaque fois que vous activez des plugins tiers supplémentaires, gardez `'plugin-hooks'` dans l'array de ces deux dossiers. Cela garantit que le gestionnaire ne s'éteindra pas accidentellement lorsqu'il restaure les fichiers.4. Comment ajouter de nouvelles modifications de code (Le Magique) :
- Le secret de ce plugin est de refléter la structure des répertoires de 66biolinks. Toutes les choses que vous mettez dans le dossier `app-core/` seront copiées au niveau racine de votre site lorsque le plugin sera activé.
- Le fichier original de 66biolinks, AVANT d'avoir effectué toute modification, DOIT être copié dans le répertoire `app-core-original/`.STRUCTURE VISUELLE DE L'EXEMPLE (CE QUE VOUS POUVEZ FAIRE)Si vous voulez modifier le fichier du en-tête de la barre d'administration (`app/views/admin/partials/header.php`) et ajouter une nouvelle classe personnalisée:Code:
Votre dossier plugin-hooks devrait ressembler à ça :
📁 plugin-hooks/
├── 📁 app-core-original/
│ └── 📁 app/
│ └── 📁 views/
│ └── 📁 admin/
│ └── 📁 partials/
│ └── 📄 header.php (Le fichier original, non modifié)
│
└── 📁 app-core/
└── 📁 app/
└── 📁 views/
└── 📁 admin/
└── 📁 partials/
└── 📄 header.php (Votre fichier modifié avec les nouvelles modifications)
└── 📁 themes/
└── 📁 altum/
└── 📁 assets/
└── 📁 css/
└── 📄 my-new-style.css (Nouveau fichier qui n'existait pas dans l'original)LIMITATIONS ET IMPORTANTES SOINS (LIRE ATTENTIVEMENT):
- RÈGLE DE SÉCURITÉ: Si vous modifiez n'importe quel fichier directement dans le cœur de 66biolinks (hors du dossier plugin), vous devez MANDATAIREMENT copier la version modifiée vers `app-core/` avec son chemin exact, et aussi copier le fichier original (sans modifications) vers `app-core-original/`. Si vous ne placez pas la version originale dans le dossier `app-core-original/`, lorsque vous désinstallez ce plugin, le fichier dans l'ensemble SYSTEME NE SERA PAS restauré à l'original car le système n'aura nulle part d'où récupérer la sauvegarde.
- SCOPÉE: Ce plugin COPIE ET REMPLACE les fichiers entiers. Il ne s'agit pas de simplement ajouter "des lignes de code". Si il y a une mise à jour 66biolinks dans le fichier `header.php`, votre version dans `app-core` va écraser les nouvelles fonctionnalités de la mise à jour. C'est pourquoi WinMerge est obligatoire lorsqu'on met à jour!
- NE PAS MODIFIER CE FICHIER DIRECTEMENT: Ne pas modifier les fichiers qui se trouvent dans vos `app-core` et `app-core-original` pendant que le plugin est "Activé" via l'onglet. Avant de faire des modifications, désactivez d'abord le plugin, faites-les dans les dossiers du plugin, puis réactivez pour qu'il procède à la copie propre.
- NOUVEAUX FICHIERS SONT SUPPRIMÉS LORS DE LA DÉSINSTALATION: Le fichier `my-new-style.css` (comme dans l'exemple ci-dessus) n'existait pas dans l'original. Quand vous désinstallez ce plugin, le système remarquera qu'il ne se trouve plus dans `app-core-original` et supprimera le fichier de votre site principal pour maintenir la propreté. Il restera sauvegardé à l'intérieur du dossier plugin.
======================================================
AVANTAGES AVANCÉS DANS LA VERSION 3.2.0
======================================================
1. Détektor de Mise à Jour Système:
- Le système détecte automatiquement si vous avez mis à jour 66biolinks vers une nouvelle version.
- Une alerte d'information bleue apparaîtra dans votre Onglet Administrateur disant: "Mise à jour du Système détectée!".
- C'est un rappel pour vérifier vos modifications personnalisées (dans `app-core`) avant qu'ils ne soient réappliqués, garantissant la compatibilité maximale.
2. Contrôleur d'Intégrité Automatique:
- Chaque fois que vous accéderez à une page de gestionnaire, le plugin vérifiera silencieusement si le serveur permet toujours l'écriture dans les répertoires nécessaires.
- Si un problème de permission est trouvé (par exemple, après avoir changé de serveurs ou d'accords de hébergement), une alerte rouge "Alerte de Permission" apparaîtra, vous permettant de corriger le problème (chmod) avant qu'il ne cause des problèmes.
======================================================
COMMENT METTRE À JOUR 66BIOLINKS AVEC CE PLUGIN
======================================================
Lorsque 66biolinks sort une nouvelle version et que vous voulez mettre à jour votre plateforme, suivez EXACTEMENT ces étapes étape par étape pour ne pas perdre vos customisations:1. DÉSINSTALLEZ LE PLUGIN:
- Avant de mettre à jour 66biolinks, allez dans l'onglet administrateur et désinstallez ce plugin (Plugin Hooks System).
- Cela fera revenir les fichiers modifiés vers leurs versions originales (utilisant la sauvegarde enregistrée dans `app-core-original`).2. METTRE À JOUR LE Système:
- Effectuez le processus normal de mise à jour de 66biolinks jusqu'à la dernière version.3. COMPARER LES VERSIONS (app-core-original):
- Téléchargez la nouvelle version de 66biolinks (seulement les fichiers d'actualisation) et utilisez un programme comme **WinMerge** (ou Beyond Compare).
- Comparez ce dossier `app-core-original` du plugin avec les fichiers correspondants de la VERSION NEUVE pure de 66biolinks.
- Mettez à jour les fichiers dans `app-core-original` avec les nouveaux fichiers d'actualisation non modifiés. Le dossier `app-core-original` doit toujours être un miroir exact des fichiers de la version actuelle de 66biolinks. N'oubliez pas de conserver `'plugin-hooks'` dans `plugins.php`.4. ADAPTER VOS MODIFICATIONS (app-core):
- Utilisez WinMerge pour comparer votre dossier `app-core` (où vos modifications personnalisées se trouvent) avec la version mise à jour qui est maintenant dans `app-core-original`.
- Transfert les nouvelles commandes d'actualisation dans vos fichiers modifiés dans `app-core`, en veillant à ce que vos customisations ne remettent pas à niveau les nouvelles fonctionnalités ou cassent le système.
- Faites les ajustements nécessaires dans votre code pour éviter tout conflit avec la nouvelle version de 66biolinks.5. RÉINSTALLEZ LE PLUGIN:
- Après avoir vérifié que `app-core-original` a des fichiers propres de la nouvelle version et que `app-core` a intégré correctement vos modifications dans le nouveau code, installez et activez à nouveau le plugin via l'onglet administrateur.
- Le plugin appliquera vos modifications proprement sur la nouvelle version de 66biolinks.
- ⚠️ TIP DÉCOUPLAGE POST-MISE À JOUR: N'oubliez pas de nettoyer votre cache de navigateur! Si vous utilisez Cloudflare, CDN ou des plugins de cache serveur, purgez/clevez-les tous. Cela garantit que les versions modifiées de vos fichiers `.css`, `.js` et vue sont lues correctement par tous vos utilisateurs.
