- Description courte
- The purpose of this plugin is to act as a secure modification manager for the original 66biolinks
The purpose of this plugin is to act as a secure modification manager for the original 66biolinks core system.
As the platform owner, you can perform any kind of modification to the original 66biolinks files in an isolated and secure way. This will facilitate the creation of other custom plugins that depend on these core changes and will keep all your modifications organized and safely stored in this plugin's `app-core` folder.
Whenever the plugin is installed, the modifications from `app-core` will be sent to the system files. Whenever it is uninstalled, the system will revert to the files in `app-core-original`.
======================================================
HOW TO INSTALL AND CONFIGURE FOR THE FIRST TIME
======================================================
1. For 66biolinks to recognize the plugin:
- Copy the entire `plugin-hooks` folder (the whole content containing this README.txt) to the `app/public/plugins/` directory of your 66biolinks installation.
2. For 66biolinks to recognize and allow the installation:
- Open the ORIGINAL file of your system located at: `app/includes/plugins.php`
- Add the text `'plugin-hooks',` at the end of the array list. It will look something like this:
Code:
return [
'pwa',
'push-notifications',
// ... other plugins ...
'email-shield',
'plugin-hooks', <-- ADD THIS LINE HERE
];
- Without doing this, the plugin won't even appear on the Plugins page in your Admin panel.
3. Internal Folders Configuration (`app-core` and `app-core-original`):
- The `plugins.php` file MUST also exist inside this plugin's backup folders, and we have already left a ready preview version in them:
- `app-core/app/includes/plugins.php`
- `app-core-original/app/includes/plugins.php`
- IMPORTANT: Whenever you enable additional third-party plugins, remember to keep `'plugin-hooks'` in the array inside these two folders as well. This ensures the manager doesn't accidentally disable itself when restoring files.
4. How to add new code modifications (The Magic):
- The secret of this plugin is to mirror the 66biolinks folder structure. Everything you put inside the `app-core/` folder will be copied to the root of your site when the plugin is activated.
- The original 66biolinks file, BEFORE you make any modifications, MUST be copied inside the `app-core-original/` folder.
VISUAL STRUCTURE EXAMPLE (WHAT YOU CAN DO):
If you want to modify the admin panel header file (`app/views/admin/partials/header.php`) and add a new custom class:
Code:
Your plugin-hooks folder will look like this:
📁 plugin-hooks/
├── 📁 app-core-original/
│ └── 📁 app/
│ └── 📁 views/
│ └── 📁 admin/
│ └── 📁 partials/
│ └── 📄 header.php (The original file, untouched)
│
└── 📁 app-core/
└── 📁 app/
└── 📁 views/
└── 📁 admin/
└── 📁 partials/
└── 📄 header.php (Your modified file, with the new changes)
└── 📁 themes/
└── 📁 altum/
└── 📁 assets/
└── 📁 css/
└── 📄 my-new-style.css (New file, which didn't exist in the original)
LIMITATIONS AND IMPORTANT CARE (READ CAREFULLY):
- GOLDEN BACKUP RULE: If you modify ANY file directly in the 66biolinks core (outside the plugin folder), you MUST MANDATORILY copy the modified version into `app-core/` with its exact path, and also copy the original file (without modifications) into `app-core-original/`. If you don't place the original copy in the `app-core-original/` folder, when you uninstall this plugin, the file in the system WILL NOT be restored to the original, because the system won't have anywhere to pull the backup from.
- SCOPE LIMIT: This plugin COPIES AND REPLACES the entire files. It doesn't just add "lines of code". If there's a 66biolinks update in the `header.php` file, your version in `app-core` will overwrite the update's new features. That's why WinMerge is mandatory when updating!
- DO NOT EDIT THIS FILE DIRECTLY: Never edit files that are inside your `app-core` and `app-core-original` while the plugin is "Activated" through the panel. First disable the plugin, make the edit in the plugin folders, and activate again for it to process the clean copy.
- NEW FILES ARE DELETED ON UNINSTALL: The `my-new-style.css` file (in the example above) didn't exist in the original. When you uninstall this plugin, the system will notice it's not in `app-core-original` and will DELETE IT from your main site to maintain cleanliness. It will remain saved inside the plugin folder.
======================================================
ADVANCED FEATURES IN VERSION 3.2.0
======================================================
1. System Update Detector:
- The system automatically detects if you have updated 66biolinks to a new version.
- A blue information alert will appear in your Admin Panel saying: "System Update Detected!".
- This is a reminder to review your custom modifications (in `app-core`) before they are reapplied, ensuring maximum compatibility.
2. Automatic Integrity Checker:
- Every time you access an administration page, the plugin silently checks if the server still allows writing to the necessary folders.
- If a permission error is found (e.g., after changing servers or hosting plans), a red "Permission Alert" will appear, allowing you to fix the issue (chmod) before it causes problems.
======================================================
HOW TO UPDATE 66BIOLINKS WITH THIS PLUGIN
======================================================
When 66biolinks releases a new version and you want to update your platform, follow EXACTLY this step-by-step so you don't lose your customizations:
1. UNINSTALL THE PLUGIN:
- Before updating 66biolinks, go to the administration panel and uninstall this plugin (Plugin Hooks System).
- This will cause the system to revert the altered files to their original versions (using the backup saved in `app-core-original`).
2. UPDATE THE SYSTEM:
- Perform the normal 66biolinks update process to the latest version.
3. COMPARE THE VERSIONS (app-core-original):
- Download the new 66biolinks version (pure update files) and use a program like **WinMerge** (or Beyond Compare).
- Compare this plugin's `app-core-original` folder with the corresponding files of the NEW pure 66biolinks version.
- Update the files inside `app-core-original` with the new untouched update files. The `app-core-original` folder must always be an exact mirror of the pure 66biolinks files of the current version. Remember to keep `'plugin-hooks'` in `plugins.php`.
4. ADJUST YOUR MODIFICATIONS (app-core):
- Using WinMerge, compare your `app-core` folder (where your custom modifications are) with the newly updated version that is now in `app-core-original`.
- Migrate the new update codes into your modified files inside `app-core`, ensuring your customizations don't overwrite the new features or break the system.
- Make the necessary adjustments in your code to avoid conflicts with the new 66biolinks version.
5. REINSTALL THE PLUGIN:
- After ensuring that `app-core-original` has the clean files from the new version and `app-core` has your modifications properly integrated into the new code, install and activate the plugin again in the administration panel.
- The plugin will apply your modifications cleanly over the new 66biolinks version.
- ⚠️ GOLDEN TIP POST-UPDATE: Always clear your browser cache! If you use Cloudflare, CDN, or server cache plugins, PURGE/CLEAR them all. This ensures that the modified versions of your `.css`, `.js` files, and views are read correctly by all your users.
As the platform owner, you can perform any kind of modification to the original 66biolinks files in an isolated and secure way. This will facilitate the creation of other custom plugins that depend on these core changes and will keep all your modifications organized and safely stored in this plugin's `app-core` folder.
Whenever the plugin is installed, the modifications from `app-core` will be sent to the system files. Whenever it is uninstalled, the system will revert to the files in `app-core-original`.
======================================================
HOW TO INSTALL AND CONFIGURE FOR THE FIRST TIME
======================================================
1. For 66biolinks to recognize the plugin:
- Copy the entire `plugin-hooks` folder (the whole content containing this README.txt) to the `app/public/plugins/` directory of your 66biolinks installation.
2. For 66biolinks to recognize and allow the installation:
- Open the ORIGINAL file of your system located at: `app/includes/plugins.php`
- Add the text `'plugin-hooks',` at the end of the array list. It will look something like this:
Code:
return [
'pwa',
'push-notifications',
// ... other plugins ...
'email-shield',
'plugin-hooks', <-- ADD THIS LINE HERE
];
- Without doing this, the plugin won't even appear on the Plugins page in your Admin panel.
3. Internal Folders Configuration (`app-core` and `app-core-original`):
- The `plugins.php` file MUST also exist inside this plugin's backup folders, and we have already left a ready preview version in them:
- `app-core/app/includes/plugins.php`
- `app-core-original/app/includes/plugins.php`
- IMPORTANT: Whenever you enable additional third-party plugins, remember to keep `'plugin-hooks'` in the array inside these two folders as well. This ensures the manager doesn't accidentally disable itself when restoring files.
4. How to add new code modifications (The Magic):
- The secret of this plugin is to mirror the 66biolinks folder structure. Everything you put inside the `app-core/` folder will be copied to the root of your site when the plugin is activated.
- The original 66biolinks file, BEFORE you make any modifications, MUST be copied inside the `app-core-original/` folder.
VISUAL STRUCTURE EXAMPLE (WHAT YOU CAN DO):
If you want to modify the admin panel header file (`app/views/admin/partials/header.php`) and add a new custom class:
Code:
Your plugin-hooks folder will look like this:
📁 plugin-hooks/
├── 📁 app-core-original/
│ └── 📁 app/
│ └── 📁 views/
│ └── 📁 admin/
│ └── 📁 partials/
│ └── 📄 header.php (The original file, untouched)
│
└── 📁 app-core/
└── 📁 app/
└── 📁 views/
└── 📁 admin/
└── 📁 partials/
└── 📄 header.php (Your modified file, with the new changes)
└── 📁 themes/
└── 📁 altum/
└── 📁 assets/
└── 📁 css/
└── 📄 my-new-style.css (New file, which didn't exist in the original)
LIMITATIONS AND IMPORTANT CARE (READ CAREFULLY):
- GOLDEN BACKUP RULE: If you modify ANY file directly in the 66biolinks core (outside the plugin folder), you MUST MANDATORILY copy the modified version into `app-core/` with its exact path, and also copy the original file (without modifications) into `app-core-original/`. If you don't place the original copy in the `app-core-original/` folder, when you uninstall this plugin, the file in the system WILL NOT be restored to the original, because the system won't have anywhere to pull the backup from.
- SCOPE LIMIT: This plugin COPIES AND REPLACES the entire files. It doesn't just add "lines of code". If there's a 66biolinks update in the `header.php` file, your version in `app-core` will overwrite the update's new features. That's why WinMerge is mandatory when updating!
- DO NOT EDIT THIS FILE DIRECTLY: Never edit files that are inside your `app-core` and `app-core-original` while the plugin is "Activated" through the panel. First disable the plugin, make the edit in the plugin folders, and activate again for it to process the clean copy.
- NEW FILES ARE DELETED ON UNINSTALL: The `my-new-style.css` file (in the example above) didn't exist in the original. When you uninstall this plugin, the system will notice it's not in `app-core-original` and will DELETE IT from your main site to maintain cleanliness. It will remain saved inside the plugin folder.
======================================================
ADVANCED FEATURES IN VERSION 3.2.0
======================================================
1. System Update Detector:
- The system automatically detects if you have updated 66biolinks to a new version.
- A blue information alert will appear in your Admin Panel saying: "System Update Detected!".
- This is a reminder to review your custom modifications (in `app-core`) before they are reapplied, ensuring maximum compatibility.
2. Automatic Integrity Checker:
- Every time you access an administration page, the plugin silently checks if the server still allows writing to the necessary folders.
- If a permission error is found (e.g., after changing servers or hosting plans), a red "Permission Alert" will appear, allowing you to fix the issue (chmod) before it causes problems.
======================================================
HOW TO UPDATE 66BIOLINKS WITH THIS PLUGIN
======================================================
When 66biolinks releases a new version and you want to update your platform, follow EXACTLY this step-by-step so you don't lose your customizations:
1. UNINSTALL THE PLUGIN:
- Before updating 66biolinks, go to the administration panel and uninstall this plugin (Plugin Hooks System).
- This will cause the system to revert the altered files to their original versions (using the backup saved in `app-core-original`).
2. UPDATE THE SYSTEM:
- Perform the normal 66biolinks update process to the latest version.
3. COMPARE THE VERSIONS (app-core-original):
- Download the new 66biolinks version (pure update files) and use a program like **WinMerge** (or Beyond Compare).
- Compare this plugin's `app-core-original` folder with the corresponding files of the NEW pure 66biolinks version.
- Update the files inside `app-core-original` with the new untouched update files. The `app-core-original` folder must always be an exact mirror of the pure 66biolinks files of the current version. Remember to keep `'plugin-hooks'` in `plugins.php`.
4. ADJUST YOUR MODIFICATIONS (app-core):
- Using WinMerge, compare your `app-core` folder (where your custom modifications are) with the newly updated version that is now in `app-core-original`.
- Migrate the new update codes into your modified files inside `app-core`, ensuring your customizations don't overwrite the new features or break the system.
- Make the necessary adjustments in your code to avoid conflicts with the new 66biolinks version.
5. REINSTALL THE PLUGIN:
- After ensuring that `app-core-original` has the clean files from the new version and `app-core` has your modifications properly integrated into the new code, install and activate the plugin again in the administration panel.
- The plugin will apply your modifications cleanly over the new 66biolinks version.
- ⚠️ GOLDEN TIP POST-UPDATE: Always clear your browser cache! If you use Cloudflare, CDN, or server cache plugins, PURGE/CLEAR them all. This ensures that the modified versions of your `.css`, `.js` files, and views are read correctly by all your users.
