Integrar e ajustar o módulo do CMS
Neste tutorial, você ajustará o módulo de blog do CMS bluetronix: desde a ativação e integração da lista de blogs até arquivos de módulo próprios, valores de configuração e arquivos de idioma.
Pré-requisitos e objetivo do tutorial
Para este tutorial, você precisará de um acesso de desenvolvedor ao CMS bluetronix. Você já deve saber como funcionam as pastas de desenvolvedor e por que arquivos próprios nos diretórios do sistema são marcados com _own.
Usaremos o módulo existente News - Blog como exemplo. Você ativará o módulo, integrará sua visualização de lista em uma página do CMS e, em seguida, ajustará um arquivo de módulo próprio e a configuração. Os arquivos originais permanecerão inalterados.
1. Ativar o módulo de blog
Abra em CMS Módulos e selecione News - Blog.
Ative a opção Ativar módulo de blog e confirme a solicitação de segurança com OK.
Em seguida, o configurador de módulo estará disponível. À esquerda estão as configurações técnicas, à direita os textos de módulo dependentes do idioma.
2. Integrar lista de blogs em uma página do CMS
Abra a página /Blog/index.html e selecione Código HTML. A página do blog é integrada através de uma breve marcação do CMS.
<!--bx_Mod/Blog/Modul-Blog-List-->
A marcação se refere ao módulo de blog e sua visualização de lista. O CMS insere a saída gerada do módulo nesse ponto ao renderizar.
3. Abrir arquivos principais do módulo no gerenciador de arquivos
A lógica real de PHP e HTML dos módulos não está diretamente no HTML das páginas, mas centralmente na pasta do sistema bx_Mod. Abra primeiro essa pasta no gerenciador de arquivos e depois a subpasta Blog.
Na pasta Blog, você encontrará por exemplo Modul-Blog-List.php, Modul-Blog-ShowCase.php, config.php, outros arquivos de módulo e a subpasta languages.
4. Visualizar arquivo padrão da lista de blogs
Selecione Modul-Blog-List.php e abra-a através de Editar.
O arquivo padrão contém a lógica do programa para a visão da lista. No código mostrado, são incluídas, entre outras coisas, a configuração do módulo e, se disponível, o arquivo específico do projeto config_own.php.
Assim, uma única inclusão de módulo pode usar a mesma lógica central do programa em diferentes páginas. Para projetos que utilizam o módulo padrão, atualizações futuras do CMS podem fornecer alterações neste arquivo.
Não edite diretamente o Modul-Blog-List.php original. Ele faz parte do sistema e pode ser sobrescrito durante uma atualização do CMS.
5. Criar sua própria visualização de lista com _own
Para alterar a saída, copie o arquivo padrão. A cópia própria recebe a marcação adequada _own:
Modul-Blog-List.php
↓ kopieren
Modul-Blog-List_own.php
Abra o novo arquivo Modul-Blog-List_own.php. Nesta versão específica do projeto, você pode alterar a lógica PHP e a saída HTML sem tocar no arquivo padrão.
Em nosso teste, acrescentamos ao título a sequência de caracteres visíveis NEW!!!!. O restante da visão da lista permanece inalterado.
Salve o seu arquivo de módulo e recarregue a página do blog. O CMS usará a variante _own adequada, enquanto o espaço reservado em /Blog/index.html permanece inalterado. Você reconhecerá o arquivo próprio ativo pelo título alterado NEW!!!! NOVOS ARTIGOS.
6. Configurações do módulo e configuração própria
Além da saída HTML, você também pode alterar a configuração do módulo. A captura de tela mostra, no configurador, por exemplo, para Modul-Blog-ShowCase o valor DS Repeats = 3.
Altere o valor para 2 e salve a configuração. Assim, será definida a quantidade desejada para esta área do ShowCase. A configuração refere-se a Modul-Blog-ShowCase e não deve ser igualada automaticamente ao número total de artigos da visão da lista do blog.
A configuração própria está em bx_Mod/Blog/config_own.php. Selecione este arquivo no gerenciador de arquivos.
O config_own.php mostrado sobrescreve o valor apenas quando a área do módulo Modul-Blog-ShowCase é carregada:
if($ModulNameGB == "Modul-Blog-ShowCase") {
$CF_DS_Repeats = 2;
}
Os valores padrão continuam a vir de config.php. Portanto, um arquivo de configuração própria não precisa repetir todos os valores padrão, mas pode conter apenas as variações desejadas.
7. Definir tabela de banco de dados e páginas do módulo
Na configuração padrão bx_Mod/Blog/config.php, você encontra, entre outras coisas, a tabela de banco de dados utilizada e os caminhos para a visão detalhada e a lista. No exemplo mostrado, os valores são:
$CF_DatabaseTable = "Blog";
$CF_DetailPage = "/Blog/Detail.html";
$CF_ListPage = "/Blog/index.html";
Se você desenvolver uma variante própria com base no módulo do blog para outro propósito, pode definir uma tabela de banco de dados diferente em sua própria configuração. Verifique se a nova tabela contém os campos esperados pelo seu arquivo de módulo e se as páginas de lista e detalhadas se adequam à nova variante.
8. Arquivos de linguagem do módulo
Em bx_Mod/Blog/languages estão os arquivos de idioma do módulo do blog. Para os idiomas existentes, há arquivos PHP separados, como de.php, en.php e fr.php.
Aqui são gerenciados os textos do módulo dependentes do idioma. Use para alterações específicas do projeto o formato de arquivo próprio suportado pela sua versão do módulo, em vez de sobrescrever diretamente os arquivos de idioma originais.
9. Distinguir entre módulo padrão e versão própria
A regra _own protege suas adaptações contra sobrescritas por atualizações regulares. Ao mesmo tempo, você é responsável pela manutenção dessa versão individual. Verifique em atualizações futuras do CMS se alterações importantes no arquivo padrão também são relevantes para seu próprio arquivo.
10. Resumo
Você ativa o módulo do blog em Módulos → Notícias - Blog, integra a visão da lista por meio de uma marcação do CMS e gerencia a lógica central do programa em bx_Mod/Blog. Para suas próprias alterações, copie Modul-Blog-List.php para Modul-Blog-List_own.php. As configurações que diferem do padrão devem ser registradas, se necessário, em config_own.php.
CMS-Seite /Blog/index.html
↓ Modul-Markierung
bx_Mod/Blog/Modul-Blog-List.php
↓ passende _own-Datei vorhanden?
Modul-Blog-List_own.php
↓ Konfiguration und Datenbank
HTML-Ausgabe innerhalb der CMS-SeiteDessa forma, é possível expandir um módulo existente de forma direcionada, sem alterar os arquivos originais do sistema.
FAQ
o que os clientes nos perguntam frequentemente
Que tipo de acesso preciso para ajustar módulos do CMS?
Você precisa de um acesso de desenvolvedor ao CMS bluetronix. Além disso, você deve conhecer as pastas de desenvolvedor e a regra _own.
Onde ativo o módulo de blog?
Abra Módulos, selecione Notícias - Blog e ative Ativar módulo de blog. Confirme a pergunta de segurança.
Como incorporo a lista de blogs em uma página do CMS?
Abra o código HTML da página desejada e adicione a marcação do módulo <!--bx_Mod/Blog/Modul-Blog-List-->.
Preciso copiar o código PHP completo da lista de blogs na página?
Não. A página contém apenas a marcação do módulo. A lógica correspondente é carregada centralmente a partir do módulo de blog.
Onde está o arquivo padrão da lista de blogs?
Você o encontrará em bx_Mod/Blog/Modul-Blog-List.php na área de desenvolvedor do gerenciador de arquivos.
Como ajusto um arquivo de módulo para ser atualizável?
Copie o arquivo padrão e marque a cópia com _own, por exemplo, Modul-Blog-List_own.php. Depois, edite apenas esse arquivo próprio.
A marcação do módulo precisa ser alterada ao criar um arquivo _own?
Não. Para um arquivo de módulo suportado pelo CMS, a variante _own apropriada pode ser usada automaticamente, sem alterar a ligação existente do módulo.
Para que serve o config_own.php?
Através de bx_Mod/Blog/config_own.php, você pode sobrescrever valores individuais da configuração padrão de forma específica ao projeto.
O que a configuração DS Repeats faz neste exemplo?
No exemplo mostrado, a configuração para Modul-Blog-ShowCase é alterada de 3 para 2. Ela define o número de repetições dessa área de módulo.
Onde está especificado qual tabela do banco de dados o módulo de blog utiliza?
Na configuração bx_Mod/Blog/config.php, está no exemplo $CF_DatabaseTable = "Blog";. A atribuição pode ser ajustada para uma variante própria do módulo.
Onde encontro os arquivos de língua do módulo de blog?
Os arquivos PHP dependentes do idioma estão localizados em bx_Mod/Blog/languages, por exemplo, de.php e en.php.
Quem se encarrega da manutenção de um arquivo de módulo próprio?
O arquivo _own permanece nos updates regulares do CMS. O desenvolvedor deve verificar se novas correções de erros ou funções do arquivo padrão devem ser incorporadas.