Usando PHP-Code e $LayoutHTML no CMS bluetronix

Código PHP próprio no CMS bluetronix

Com um acesso de desenvolvedor, você pode usar seu próprio código PHP dentro de uma página do CMS. O código HTML da página e seu código PHP trabalham juntos. A variável $LayoutHTML desempenha um papel central: ela contém o código HTML da página atualmente gerada durante o processo de renderização do site. Com PHP, você pode procurar, modificar e substituir conteúdos.

Para usar código PHP próprio, você precisa de um acesso de desenvolvedor ao CMS bluetronix. Se você ainda não possui um acesso de desenvolvedor, pode solicitá-lo separadamente.

Abrir código PHP de uma página

Abra a página desejada PHP Code para editar o código PHP da página.

Não utilizar tags PHP adicionais

O código PHP já é executado como código PHP pelo CMS. Portanto, você não deve usar tags PHP adicionais no editor de código PHP. Esta forma de escrita não é necessária:

<?php print "Hello World"; ?>

Escreva sua instrução PHP diretamente:

print "Hello World";

Terminar a execução do PHP com exit

Para testar, você pode inserir as seguintes instruções, salvar e, em seguida, recarregar a página:

print "Hello World";
exit();

Neste exemplo, apenas Hello World é exibido. Com exit(); você termina a execução do PHP neste ponto.

Por meio da exit();, o processo de renderização da CMS da página também é interrompido. Cabeçalho, conteúdo real da página, rodapé e etapas de processamento subsequentes não são mais executados.

Saída PHP dentro da página normal

Se você remover exit(); e usar apenas a seguinte instrução, o processo de renderização continuará normalmente:

print "Hello World";

O PHP primeiro exibe Hello World. Em seguida, a própria página CMS é gerada normalmente, incluindo cabeçalho, conteúdo da página e rodapé. Para alterações diretamente dentro da página HTML, você deve trabalhar com $LayoutHTML tanto quanto possível.

Editar HTML e PHP separadamente

No CMS bluetronix, você pode manter o Código HTML e o Código PHP de uma página separadamente. Assim, a estrutura HTML permanece editável no editor, enquanto você armazena a lógica de programação na área PHP.

Definir placeholders próprios em HTML

Defina um espaço reservado no código HTML que seu código PHP substituirá mais tarde. Um exemplo simples é:

__MyText__

Use nomes em inglês para espaços reservados, mesmo em sites em alemão. Assim, a nomenclatura permanece internacionalmente compreensível e consistente.

Outras possíveis designações são:

__CustomerName__
__ProductPrice__
__CurrentDate__

Substituir placeholders por $LayoutHTML

Com str_replace() você pode buscar o espaço reservado no código HTML atual e substituí-lo pelo conteúdo desejado:

$LayoutHTML = str_replace("__MyText__","Mein Text",$LayoutHTML);

O CMS procura em $LayoutHTML por __MyText__ e substitui o espaço reservado por Meu Texto.

Combinar HTML e placeholders

Você pode usar o espaço reservado dentro da sua estrutura normal de HTML. Por exemplo, insira o seguinte código na área HTML:

<h1>__MyText__</h1>

Na área PHP, você complementa a substituição:

$LayoutHTML = str_replace("__MyText__","Meine Überschrift",$LayoutHTML);

Durante o processo de renderização, resulta em:

<h1>Meine Überschrift</h1>

Múltiplos placeholders em uma seção da página

O mesmo princípio funciona em áreas HTML mais extensas. Você pode definir, por exemplo, título e descrição separadamente como espaços reservados:

<section>
   <div class="container">
      <h2>__MyHeadline__</h2>
      <p>__MyDescription__</p>
   </div>
</section>

No código PHP, você define ambos os conteúdos de forma independente:

$LayoutHTML = str_replace("__MyHeadline__","Unsere Leistungen",$LayoutHTML);
$LayoutHTML = str_replace("__MyDescription__","Hier finden Sie eine Übersicht unserer Leistungen.",$LayoutHTML);

O código HTML final contém então os textos inseridos em vez dos dois espaços reservados:

<section>
   <div class="container">
      <h2>Unsere Leistungen</h2>
      <p>Hier finden Sie eine Übersicht unserer Leistungen.</p>
   </div>
</section>

Separar o conteúdo HTML e a lógica PHP tanto quanto possível

Tecnicamente, você pode inserir estruturas HTML completas diretamente com PHP em $LayoutHTML:

$LayoutHTML = str_replace("__MyContent__","<h2>Meine Überschrift</h2><p>Mein Text</p>",$LayoutHTML);

Para conteúdos maiores, no entanto, é sensato manter o HTML como uma estrutura editável na área HTML e trabalhar com espaços reservados. Exemplo do código HTML:

<section>
   <h2>__MyHeadline__</h2>
   <p>__MyText__</p>
</section>

O código PHP correspondente substitui apenas os valores necessários:

$LayoutHTML = str_replace("__MyHeadline__","Meine Überschrift",$LayoutHTML);
$LayoutHTML = str_replace("__MyText__","Mein Text",$LayoutHTML);

O cliente final pode, assim, alterar espaçamentos, editar títulos, mover áreas HTML, ajustar designs e editar seções de página, sem precisar alterar a lógica de programação PHP.

Definir funções PHP próprias

Dentro do código PHP, você pode criar suas próprias funções. Por exemplo:

function MyExampleFunction() {
   return "Hello World";
}

Certifique-se de que uma função não seja definida várias vezes durante uma chamada de página. Isso pode acontecer se o mesmo nome de função existir na página principal, no cabeçalho, em um módulo incluído, em uma seção de página ou no rodapé.

Escolha nomes o mais únicos possível para suas funções PHP. Uma definição de função duplicada resulta em erro no PHP.

Um nome de função específico do projeto poderia ser assim:

function MyProjectCreateCustomerText() {
   return "Customer";
}

Verificar funções existentes antes de definir uma função

Alternativamente, você pode usar function_exists() para verificar se a função relevante já foi definida:

if(!function_exists("MyProjectCreateCustomerText")) {
   function MyProjectCreateCustomerText() {
      return "Customer";
   }
}

Usar funções PHP do bluetronix

Na área de código PHP, você também pode usar as funções PHP fornecidas pelo CMS bluetronix. Um exemplo é o envio de e-mail através do sistema SMTP bluetronix com BlueSMTPMail():

BlueSMTPMail($MailType,$MailAccount,$SMTPType,$From,$To,$NewsletterTo,$Subject,$TextContent,$HTMLContent,$Attachments,$ImageInMail,$MailPlaceholderReplacement,$FormEntry);

Os parâmetros necessários podem ser definidos dentro do seu código PHP, por exemplo:

$From        = "info@example.com";
$To          = "customer@example.com";
$Subject     = "Test E-Mail";
$TextContent = "Hello World";

Em seguida, você pode usar a função central para envio de e-mails. Para uma chamada completa, os outros parâmetros necessários também devem ser ajustados adequadamente. Assim, você não precisa programar novamente funções básicas do CMS, como o envio SMTP.

Resumo

O código PHP próprio é executado diretamente pelo CMS bluetronix; tags PHP adicionais não são necessárias no editor de Código PHP. $LayoutHTML contém o código HTML da página atualmente gerada e permite que você substitua seus espaços reservados por conteúdos dinâmicos.

Crie sua estrutura HTML preferencialmente na área HTML e substitua os espaços reservados via PHP. Assim, o cliente final pode continuar a editar o layout posteriormente com o editor CMS normal, enquanto a lógica do programa permanece separada.