Override Sistema do Core - Plugin 66biolinks 3.2.0

O propósito deste plugin é atuar como gerenciador de modificações seguras para o sistema original 66biolinks core. Como dono do plataforma, você pode realizar qualquer tipo de modificação nos arquivos originais do 66biolinks em um modo isolado e seguro. Isso facilitará a criação de outros plugins personalizados que dependem dessas mudanças no sistema original e manterá todas as suas modificações organizadas e armazenadas adequadamente neste diretório `app-core` do plugin. Cada vez que o plugin for instalado, as modificações em `app-core` serão enviadas para os arquivos do sistema. Quando ele for desinstalado, o sistema retornará aos arquivos originais em `app-core-original`.======================================================
Instruções de Instalação e Configuração para Primeira Utilização
======================================================1. Para que o plugin reconheça o 66biolinks:
- Copie todo o diretório `plugin-hooks` (o conteúdo inteiro contendo este README.txt) para o diretório `app/public/plugins/` da instalação do 66biolinks.2. Para que o 66biolinks reconheça e permita a instalação deste plugin:
- Abra o arquivo original de seu sistema localizado em: `app/includes/plugins.php`
- Adicione as palavras-chave `'plugin-hooks'` no final da lista do array. Elas devem parecer algo assim:Code:
return [
'pwa',
'push-notifications',
// ... outros plugins ...
'email-shield',
'plugin-hooks', <-- ADICIONE ESTA LINHA AQUI
];- Sem fazer isso, o plugin não aparecerá na página de Plugins no painel administrativo.3. Configuração Interna dos Folders (`app-core` e `app-core-original`):
- O arquivo `plugins.php` também deve existir nestes folders de backup do plugin, e já deixamos uma versão prévia pronta para você:
- `app-core/app/includes/plugins.php`
- `app-core-original/app/includes/plugins.php`
- IMPORTANTE: Quando você habilitar outros plugins terceiros adicionais, lembre-se de manter `'plugin-hooks'` na lista dentro desses dois folders também. Isso garante que o gerenciador não desabilite por acidente a si mesmo ao restaurar os arquivos.4. Como adicionar novas modificações de código (O Mágico):
- O segredo deste plugin é refletir a estrutura do diretório 66biolinks. Tudo que você colocar dentro do `app-core/` será copiado para o raio do seu site quando o plugin for ativado.
- O arquivo original do 66biolinks, antes de qualquer modificação, deve ser copiado dentro do diretório `app-core-original/`.VISUALIZAÇÃO DA ESTRUTURA DE FOLDERS (O QUE VOCÊ PODE FAZER):Se você deseja modificar o arquivo de cabeçalho da área administrativa (`app/views/admin/partials/header.php`) e adicionar uma nova classe personalizada:Code:
Seu diretório plugin-hooks ficará assim:
📁 plugin-hooks/
├── 📁 app-core-original/
│ └── 📁 app/
│ └── 📁 views/
│ └── 📁 admin/
│ └── 📁 partials/
│ └── 📄 header.php (O arquivo original, sem modificações)
│
└── 📁 app-core/
└── 📁 app/
└── 📁 views/
└── 📁 admin/
└── 📁 partials/
└── 📄 header.php (Seu arquivo modificado, com as novas alterações)
└── 📁 themes/
└── 📁 altum/
└── 📁 assets/
└── 📁 css/
└── 📄 my-new-style.css (Novo arquivo que não existia no original)LIMITAÇÕES E ATENÇÃO IMPORTANTE (LER COM CUIDADO):
- REGRA DE BACKUP CRÍTICA: Se você modificar qualquer arquivo diretamente no núcleo do 66biolinks (fora da pasta plugin), deve MANDATARIAMENTE copiar a versão modificada para `app-core/` com sua exata estrutura de caminhos, e também copiar o arquivo original (sem modificações) para `app-core-original/`. Se você não colocar a cópia original na pasta `app-core-original`, quando você desativar este plugin, o arquivo no sistema NÃO SERÁ restaurado ao original, pois o sistema não terá onde buscar a backup.
- ESCOPO LIMITADO: Este plugin COPIA E REEMPLAZA os arquivos completos. Ele não adiciona apenas "linhas de código". Se houver uma atualização do 66biolinks no arquivo `header.php`, sua versão em `app-core` sobrescreverá as novas funcionalidades da atualização. Por isso, o WinMerge é MANDATÁRIO quando você atualizar!
- NÃO MODIFIQUE ESSE ARQUIVO: Nunca edite arquivos que estão dentro de seu `app-core` e `app-core-original` enquanto este plugin está "ativado" através do painel. Primeiro desative o plugin, faça a edição nos folders do plugin, e ative novamente para processar a cópia limpa.
- NOVOS ARQUIVOS SÃO APAGADOS NA DESATIVAÇÃO: O arquivo `my-new-style.css` (no exemplo acima) não existia no original. Quando você desativar este plugin, o sistema notará que ele não está em `app-core-original` e DELETARÁ-O da sua página principal para manter a limpeza. Ele permanecerá salvo dentro da pasta do plugin.
AVANÇADAS FUNÇÕES NA VERSÃO 3.2.0
======================================================
1. Detector de Atualização do Sistema:
- O sistema detecta automaticamente se você atualizou o 66biolinks para uma nova versão.
- Apresentará um alerta azul de informação no painel administrativo dizendo: "Detecção de Atualização do Sistema!".
- Isso é uma lembrança para revisar as modificações personalizadas (em `app-core`) antes que sejam aplicadas novamente, garantindo a máxima compatibilidade.
2. Verificador de Integridade Automática:
- Cada vez que você acessar uma página administrativa, o plugin faz um check silencioso para verificar se ainda é permitido escrever nos diretórios necessários.
- Se encontrar um erro de permissão (por exemplo, após mudar servidores ou planos de hospedagem), aparecerá um alerta vermelho "Alerta de Permissões", permitindo que você corrija o problema (chmod) antes que ele cause problemas.
======================================================
COMO ATUALIZAR O 66BIOLINKS COM ESTE PLUGIN
======================================================
Quando o 66biolinks lançar uma nova versão e você desejar atualizar seu plataforma, siga EXATAMENTE este passo a passo para não perder suas personalizações:
1. DESATIVE O PLUGIN:
- Antes de atualizar o 66biolinks, vá ao painel administrativo e desative este plugin (Plugin Hooks System).
- Isso causará que o sistema reverta os arquivos alterados para suas versões originais (usando a backup salva em `app-core-original`).
2. ATUALIZE O SISTEMA:
- Faça o processo normal de atualização do 66biolinks para a versão mais recente.
3. COMPARE AS VERSÕES (app-core-original):
- Baixe as novas versões puras do 66biolinks e use um programa como **WinMerge** (ou Beyond Compare).
- Compare este plugin's `app-core-original` pasta com os arquivos correspondentes da nova versão pura do 66biolinks.
- Atualize os arquivos dentro de `app-core-original` com as novas versões inalteradas. A pasta `app-core-original` deve sempre ser uma cópia exata dos arquivos do 66biolinks atuais da versão. Lembre-se de manter `'plugin-hooks'` em `plugins.php`.
4. ADJUSTE SUAS MODIFICAÇÕES (app-core):
- Usando o WinMerge, compare sua pasta `app-core` (onde suas personalizações são) com a nova versão atualizada que agora está em `app-core-original`.
- Migrar as novas versões de código para seus arquivos modificados dentro de `app-core`, garantindo que suas personalizações não sobrescrevam as novas funcionalidades ou causem problemas no sistema.
- Faça os ajustes necessários na sua codificação para evitar conflitos com a nova versão do 66biolinks.
5. REATIVE O PLUGIN:
- Após garantir que `app-core-original` tenha os arquivos limpos da nova versão e `app-core` tenha suas modificações corretamente integradas ao novo código, instale e ative o plugin novamente no painel administrativo.
- O plugin aplicará suas modificações limpas sobre a nova versão do 66biolinks.
- ⚠️ DICA CRÍTICA POST-ATUALIZAÇÃO: Sempre limpe seu cache de navegador! Se você usar Cloudflare, CDN ou plugins de cache de servidor, PURGE/CLEAR todos eles. Isso garante que as versões modificadas dos seus arquivos `.css`, `.js` e visuais sejam lidos corretamente por todos os seus usuários.