Używanie kodu PHP i $LayoutHTML w CMS bluetronix

Własny kod PHP w CMS bluetronix

Dzięki dostępowi dewelopera możesz używać własnego kodu PHP w obrębie strony CMS. Kod HTML strony i twój kod PHP współpracują ze sobą. Kluczową rolę odgrywa zmienna $LayoutHTML: zawiera kod HTML aktualnie generowanej strony w czasie renderowania. Dzięki PHP możesz w niej wyszukiwać, zmieniać i zamieniać zawartość.

Aby używać własnego kodu PHP, potrzebujesz dostępu dewelopera do CMS bluetronix. Jeśli jeszcze nie masz dostępu dewelopera, możesz go załatwić osobno.

Otwórz kod PHP strony

Na wybranej stronie otwórz PHP Code, aby edytować kod PHP strony.

Nie używaj dodatkowych znaczników PHP

Kod PHP jest już wykonywany przez CMS jako kod PHP. Dlatego nie możesz używać dodatkowych znaczników PHP w edytorze kodu PHP. Taki zapis nie jest tam wymagany:

<?php print "Hello World"; ?>

Zamiast tego pisz swoje polecenie PHP bezpośrednio:

print "Hello World";

Zakończ wykonanie PHP z użyciem exit

Do testowania możesz wprowadzić następujące polecenia, zapisać je, a następnie odświeżyć stronę:

print "Hello World";
exit();

W tym przykładzie wyświetlane jest wyłącznie Hello World. Dzięki exit(); kończysz wykonanie PHP w tym miejscu.

Usunięcie exit(); oraz użycie tylko poniższego polecenia spowoduje, że proces renderowania będzie przebiegał normalnie:

Wynik PHP wewnątrz normalnej strony

PHP najpierw wyświetli Hello World. Następnie będzie kontynuowane generowanie rzeczywistej strony CMS, łącznie z nagłówkiem, zawartością strony i stopką. Jednak w przypadku zmian bezpośrednio w obrębie strony HTML warto pracować głównie z $LayoutHTML.

print "Hello World";

W CMS bluetronix możesz oddzielnie zarządzać kodem HTML i kodem PHP strony. Dzięki temu struktura HTML w edytorze jest możliwa do edytowania, podczas gdy logika programowa jest umieszczona w obszarze PHP.

Edytuj HTML i PHP oddzielnie

W systemie bluetronix CMS możesz osobno zarządzać kodem HTML i kodem PHP dla jednej strony. Dzięki temu struktura HTML w edytorze pozostaje edytowalna, podczas gdy logikę programowania umieszczasz w obszarze PHP.

Zdefiniuj własne znaczniki w HTML

Zdefiniuj w kodzie HTML znacznik, który twój kod PHP później zastąpi. Prosty przykład to:

__MyText__

Stosuj angielskie nazwy dla własnych znaczników, nawet na stronach niemieckojęzycznych. Dzięki temu nazewnictwo pozostaje zrozumiałe i jednolite międzynarodowo.

Inne możliwe oznaczenia to:

__CustomerName__
__ProductPrice__
__CurrentDate__

Zamień znaczniki na $LayoutHTML

Za pomocą str_replace() możesz szukać znacznika w bieżącym kodzie HTML i zastąpić go pożądanym zawartością:

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

CMS przeszukuje $LayoutHTML w poszukiwaniu __MyText__ i zastępuje znacznik Moim tekstem.

Kombinuj HTML i znaczniki

Możesz użyć znacznika w ramach swojej normalnej struktury HTML. Na przykład wpisz następujący kod w obszarze HTML:

<h1>__MyText__</h1>

W obszarze PHP dodajesz zastąpienie:

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

Podczas procesu renderowania powstaje:

<h1>Meine Überschrift</h1>

Kilka znaczników w jednym sekcji strony

To samo zasada działa w bardziej rozbudowanych obszarach HTML. Możesz na przykład oddzielnie zdefiniować nagłówek i opis jako znaczniki:

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

W kodzie PHP ustawiasz obie treści niezależnie od siebie:

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

Gotowy kod HTML zawiera wówczas wstawione teksty zamiast obu znaczników:

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

Oddziel papierową strukturę HTML i logikę PHP jak najwięcej

Technicznie możesz bezpośrednio wstawić całe struktury HTML za pomocą PHP do $LayoutHTML:

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

Jednak w przypadku większych treści sensowne jest pozostawienie HTML jako edytowalnej struktury w obszarze HTML i praca z znacznikami. Przykład kodu HTML:

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

Odpowiedni kod PHP zastępuje tylko wymagane wartości:

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

Dzięki temu end-user może zmieniać odstępy, edytować nagłówki, przemieszczać obszary HTML, dostosowywać projekty i edytować sekcje stron za pomocą zwykłego edytora CMS, bez konieczności zmiany logiki programowania PHP.

Zdefiniuj własne funkcje PHP

W obrębie kodu PHP możesz tworzyć własne funkcje. Na przykład:

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

Upewnij się, że funkcja nie jest definiowana kilkakrotnie podczas wywołania strony. Może się zdarzyć, że ta sama nazwa funkcji występuje jednocześnie na stronie głównej, w nagłówku, w załączonym module, w sekcji strony lub w stopce.

Wybieraj możliwie jednoznaczne nazwy dla własnych funkcji PHP. Podwójna definicja funkcji w PHP prowadzi do błędu.

Specyficzna nazwa funkcji dla projektu mogłaby wyglądać tak:

function MyProjectCreateCustomerText() {
   return "Customer";
}

Sprawdź istniejące funkcje przed zdefiniowaniem nowej funkcji

Alternatywnie możesz sprawdzić, czy dana funkcja została już zdefiniowana przy pomocy function_exists():

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

Używaj funkcji PHP bluetronix

W obszarze kodu PHP możesz również korzystać z funkcji PHP udostępnionych przez system CMS bluetronix. Przykładem jest wysyłanie e-maili za pośrednictwem systemu SMTP bluetronix z użyciem BlueSMTPMail():

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

Potrzebne parametry możesz ustawić w swoim kodzie PHP, na przykład:

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

Następnie możesz użyć centralnej funkcji do wysyłania e-maili. Aby w pełni wykonać wywołanie, muszą być również prawidłowo ustawione pozostałe wymagane parametry. Dzięki temu nie musisz ponownie programować podstawowych funkcji CMS, takich jak wysyłka SMTP.

Podsumowanie

Własny kod PHP jest bezpośrednio wykonywany przez system CMS bluetronix; dodatkowe tagi PHP nie są wymagane w edytorze PHP Code. $LayoutHTML zawiera kod HTML aktualnie generowanej strony i pozwala ci zastępować własne znaczniki dynamicznymi treściami.

Utwórz swoją strukturę HTML możliwie w obszarze HTML i zastąp miejsca na tekst przez PHP. Dzięki temu końcowy klient może później nadal edytować układ za pomocą standardowego edytora CMS, podczas gdy logika programistyczna pozostaje oddzielona.