Visão de desenvolvedor e áreas do sistema no CMS bluetronix
Com um acesso de desenvolvedor, você terá acesso a funções adicionais, pastas do sistema, tabelas de banco de dados e áreas de código-fonte do CMS bluetronix. Neste tutorial, você aprenderá quais áreas estão disponíveis e como separar suas próprias extensões atualizáveis dos arquivos do sistema.
Funções adicionais com acesso de desenvolvedor
Com um acesso de desenvolvedor, você terá funções adicionais no CMS bluetronix que não são visíveis na visão normal do usuário.
Isto inclui pastas de desenvolvedor adicionais na gestão de arquivos, acesso ao código PHP das páginas, tabelas de banco de dados adicionais para desenvolvedores, bem como scripts de sistema, modelos de layout e módulos.
Editar código PHP das páginas
Na visualização normal do CMS, você pode editar o código HTML de uma página. Com acesso de desenvolvedor, o botão Código PHP também estará disponível.
Com isso, você pode adicionar seu próprio código PHP a uma página do CMS, por exemplo, para consultas de banco de dados, conteúdos dinâmicos, substituições dentro de $LayoutHTML, funções do CMS ou suas próprias funções PHP.
Tabelas de banco de dados adicionais
Com acesso de desenvolvedor, tabelas de sistema adicionais são exibidas na gestão de banco de dados. Isso inclui, por exemplo, tabelas para layouts, gestão de páginas, configurações de sistema e outras funções internas do CMS.
Estas tabelas de desenvolvedor e de sistema são marcadas em vermelho na gestão de banco de dados.
A estrutura das tabelas de banco de dados de desenvolvedor marcadas em vermelho não deve ser alterada. Você não deve excluir, adicionar ou renomear colunas, alterar tipos de dados ou ajustar estruturas de sistema. Essas tabelas podem ser atualizadas ou substituídas durante uma atualização de sistema.
Pastas de desenvolvedor na gestão de arquivos
Com acesso de desenvolvedor, pastas de sistema adicionais se tornam visíveis na gestão de arquivos. Essas pastas de desenvolvedor são exibidas em vermelho e começam geralmente com bx_.
As pastas mais importantes incluem bx_doc, bx_fonts, bx_Image, bx_Import, bx_Layout, bx_Mod, bx_script e bx_style.
bx_doc
Na pasta bx_doc estão arquivos de exemplo pré-instalados e documentos. Isso pode incluir, por exemplo, documentos PDF que são usados dentro de páginas ou modelos de exemplo.
bx_fonts
Na pasta bx_fonts estão as fontes fornecidas ou instaladas pelo CMS bluetronix. Essas fontes podem ser utilizadas dentro dos vários designs e layouts do CMS.
bx_Img
A pasta bx_Img contém as imagens padrão do conjunto de temas utilizado atualmente.
Como desenvolvedor, você pode escolher um conjunto de imagens de tema diferente. Os diferentes conjuntos de imagens de tema usam os mesmos nomes de arquivo definidos e funcionam, assim, como um molde uniforme. A estrutura HTML não precisa ser alterada ao mudar um conjunto de imagens de tema.
bx_Import
A pasta bx_Import é usada para a importação de sites externos. Por exemplo, sites Bootstrap-5 podem ser preparados para importação e colocados nesta área. Os arquivos são então analisados e incorporados à estrutura do CMS bluetronix.
bx_Layout
Na pasta bx_Layout estão os modelos de páginas e seções do CMS. Esses modelos estarão disponíveis para o usuário, por exemplo, através de Inserir → Seção da página.
Como desenvolvedor, você pode criar seus próprios modelos para seções de herói, áreas de texto, áreas de produtos, áreas de contato, elementos de teaser e outras seções de páginas personalizadas. O cliente final pode então inserir esses elementos através do editor normal, sem precisar programar HTML.
bx_script
Na pasta bx_script estão os arquivos JavaScript fornecidos pelo CMS bluetronix. Isso inclui, entre outros, BxHeadScript.js e BxScript.js.
Dependendo das línguas ativadas, versões dependentes de língua podem ser geradas, por exemplo, BxScript_en.js, BxScript_de.js ou BxScript_fr.js.
Dentro da pasta de scripts, há também um diretório fonte. Ali estão os arquivos fonte individuais ou componentes dos quais os principais arquivos usados posteriormente são gerados.
bx_style
De maneira análoga ao bx_Script, bx_style contém os estilos centrais do CMS bluetronix. A partir disso, são gerados, entre outros, os arquivos de estilo de folha de estilo usados pelo sistema. Também podem existir arquivos fonte a partir dos quais os arquivos CSS finais são montados.
Pastas do sistema e atualizações
As pastas de sistema bx_ marcadas em vermelho fazem parte do CMS bluetronix e podem ser sobrescritas total ou parcialmente em uma atualização de sistema. Portanto, alterações próprias não devem ser salvas diretamente nos arquivos de sistema normais.
Arquivos pessoais dentro das áreas do sistema devem ser marcados com _own. Essa marcação sinaliza ao CMS bluetronix que se trata de um arquivo específico do projeto.
Exemplos incluem config_own.php, MyScript_own.js, MyStyle_own.css ou MyTemplate_own.txt. A extensão do arquivo não é, em princípio, relevante. O que importa é a marcação _own no nome do arquivo.
Portanto, crie sempre suas próprias adaptações dentro das pastas de sistema vermelhas como arquivos _own. Assim, esses arquivos permanecem também após uma atualização do CMS bluetronix.
Não altere arquivos do sistema diretamente
Você não deve editar diretamente um arquivo de sistema existente. Use-o como modelo, se necessário, copie-o, marque a cópia com _own e depois faça suas próprias adaptações nesse arquivo.
bx_Mod
Na pasta bx_Mod estão os módulos do CMS bluetronix. Isso pode incluir, por exemplo, Blog, Loja, Busca, Login e outros módulos do CMS.
Um módulo pode conter diferentes arquivos e áreas, por exemplo, configurações, listas, visualizações detalhadas, scripts PHP e outros arquivos de módulo.
Ajustar arquivos de módulo
Para os arquivos de módulo, o mesmo se aplica: o arquivo de sistema original não deve ser alterado diretamente. Você pode visualizá-lo, lê-lo, usá-lo como base e copiá-lo. Para uma versão própria, você deve criar uma cópia com _own e fazer suas alterações lá.
As principais regras para desenvolvedores
1. Não modificar estruturalmente tabelas de banco de dados destacadas em vermelho.
2. Pastas de sistema destacadas em vermelho bx_ podem ser substituídas durante atualizações.
3. Não alterar diretamente os arquivos de sistema para suas próprias adaptações.
4. Sempre identificar arquivos próprios dentro das áreas de sistema com _own.
5. Os arquivos de sistema podem ser lidos e copiados como modelo.
6. Realizar suas adaptações depois dentro do arquivo _own.
Resumo
O acesso de desenvolvedor expande o CMS bluetronix com funções adicionais e áreas de sistema como código PHP, tabelas de banco de dados para desenvolvedores, pastas de sistema bx_, módulos, scripts, estilos e templates de layout.
É especialmente importante a separação entre arquivos de sistema e suas próprias extensões. Você deve usar os arquivos de sistema originais como modelo, e as suas adaptações devem ser criadas como arquivo _own.
FAQ
o que os clientes nos perguntam frequentemente
Quais funções adicionais eu recebo com um acesso de desenvolvedor?
Entre outras coisas, você terá acesso a pastas adicionais para desenvolvedores, ao código PHP de páginas, tabelas de sistema adicionais e a scripts de sistema, templates de layout e módulos.
Onde posso armazenar meu próprio código PHP para uma página?
Com acesso de desenvolvedor, um botão adicional Código PHP estará disponível em uma página do CMS.
Posso modificar estruturalmente tabelas de banco de dados destacadas em vermelho?
A estrutura dessas tabelas de desenvolvedor e de sistema não deve ser alterada. Você não deve excluir, adicionar ou renomear colunas e não deve ajustar tipos de dados ou estruturas de sistema.
Como posso identificar as pastas de desenvolvedor?
As pastas de desenvolvedor são exibidas em vermelho no gerenciamento de arquivos e sempre começam com bx_.
Qual é a função do bx_Layout?
No bx_Layout, estão armazenados templates de página e seção do CMS. Como desenvolvedor, você pode fornecer seus próprios modelos, que o cliente final poderá selecionar mais tarde através de Inserir → Seção da Página.
Por que eu não deveria alterar diretamente os arquivos de sistema?
Os arquivos de sistema e pastas de sistema podem ser sobrescritos durante uma atualização do CMS bluetronix. Alterações diretas podem ser perdidas.
Como posso criar meus próprios arquivos que sejam compatíveis com atualizações?
Você deve identificar seus próprios arquivos dentro das áreas de sistema no nome do arquivo com _own, por exemplo, MyScript_own.js ou MyStyle_own.css.
Posso usar arquivos de sistema existentes como modelo?
Sim. Você pode visualizar um arquivo de sistema e usá-lo como base. Para suas adaptações, você deve copiá-lo, identificar a cópia com _own e depois editar apenas este arquivo próprio.