השתמש בקוד PHP ו-$LayoutHTML ב-CMS של bluetronix

קוד PHP אישי במערכת ה-CMS של בלוטרוניקס

עם גישה כמפתח, ניתן להשתמש בקוד PHP אישי בתוך עמוד CMS. קוד ה-HTML של העמוד וקוד ה-PHP שלך פועלים יחד. המשתנה המרכזי הוא $LayoutHTML: הוא מכיל במהלך תהליך רינדור האתר את קוד ה-HTML של העמוד המיוצר כעת. עם PHP ניתן לחפש, לשנות ולהחליף תוכן.

כדי להשתמש בקוד PHP אישי, דרושה לך גישה כמפתח למערכת ה-CMS של בלוטרוניקס. אם עדיין אין לך גישה כזו, ניתן לבקש אותה בנפרד.

פתח קוד PHP של עמוד

פתח בעמוד הרצוי את קוד PHP כדי לערוך את קוד ה-PHP של העמוד.

אין להשתמש בתגי PHP נוספים

קוד ה-PHP כבר מופעל על ידי ה-CMS. לכן אינך יכול להשתמש בתגי PHP נוספים בעורך קוד ה-PHP. כתיבה בצורה זו אינה נדרשת שם:

<?php print "Hello World"; ?>

כתוב את פקודת ה-PHP שלך ישירות:

print "Hello World";

סיים ביצוע PHP עם exit

לבדיקה, תוכל להזין את ההוראות הבאות, לשמור ואז לטעון מחדש את העמוד:

print "Hello World";
exit();

בדוגמה זו מוצג רק Hello World. עם exit(); תסיים את ביצוע ה-PHP בשלב זה.

באמצעות exit(); גם תהליך רינדור האתר ב-CMS יסתיים. כותרות, תוכן העמוד, כותרת תחתונה של העמוד ושלבים נוספים לא יבוצעו.

פלט PHP בתוך העמוד הרגיל

אם תסיר את exit(); ותשתמש רק בהוראה הבאה, תהליך הרינדור יימשך כרגיל:

print "Hello World";

PHP יוציא קודם כל Hello World. לאחר מכן ימשך ייצור עמוד ה-CMS, כולל כותרות, תוכן עמוד וכותרת תחתונה. עם זאת, לשינויים ישירות בתוך עמוד ה-HTML, כדאי לפעול עם $LayoutHTML.

ערוך HTML ו-PHP בנפרד

במערכת ה-CMS של בלוטרוניקס, תוכל לשמור בנפרד את קוד ה-HTML ואת קוד ה-PHP של עמוד. כך מבנה ה-HTML נשאר ניתן לעריכה בעורך, בעוד שאתה מגדיר את הלוגיקה התוכניתית בתחום ה-PHP.

הגדר מחזיקים אישיים ב-HTML

הגדר בקוד HTML מתחם ש- PHP שלך יחליף מאוחר יותר. דוגמה פשוטה היא:

__MyText__

שימוש בשמות באנגלית עבור מתחמים משמכם, גם באתרים דוברי גרמנית. כך השמות נשארים מובנים ואחידים ברמה בינלאומית.

שמות נוספים אפשריים הם:

__CustomerName__
__ProductPrice__
__CurrentDate__

החלף מחזיקים עם $LayoutHTML

עם str_replace() אתה יכול לחפש את המתחם בקוד ה- HTML הנוכחי ולהחליף אותו בתוכן שרצית:

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

ה-CMS מחפש בתוך $LayoutHTML את __MyText__ ומחליף את המתחם עם הטקסט שלי.

שלב HTML ומחזיקים

את המתחם אתה יכול להשתמש בו בתוך מבנה ה-HTML הרגיל שלך. לדוגמה, הכנס את הקוד הבא בחלק ה- HTML:

<h1>__MyText__</h1>

בחלק ה- PHP אתה מוסיף את ההחלפה:

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

במהלך תהליך הרינדור נוצר:

<h1>Meine Überschrift</h1>

מספר מחזיקים בחלק עמוד אחד

אותו עיקרון עובד גם בתחומי HTML רחבים יותר. אתה יכול להגדיר, לדוגמה, כותרת ותיאור בנפרד as placeholders:

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

בקוד ה- PHP אתה ממקם את שני התכנים באופן עצמאי:

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

הקוד HTML הגמור כולל אז את הטקסטים המושקעים במקום שני המתחמים:

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

ניסי להפריד בין מבנה HTML ללוגיקת PHP

טכנית אתה יכול להכניס מבני HTML שלמים ישירות עם PHP ב- $LayoutHTML:

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

עם זאת, עבור תכנים גדולים יותר זה הגיוני להשאיר את ה-HTML כמבנה שניתן לעריכה בחלק ה-HTML ולעבוד עם מתחמים. דוגמה לקוד HTML:

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

הקוד PHP המתאים מחליף רק את הערכים הנדרשים:

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

הלקוח הסופי יכול כך לשנות רווחים, לערוך כותרות, להזיז אזורי HTML, להתאים עיצובים ולערוך חלקי דפים דרך עורך ה-CMS הרגיל מבלי לשנות את ההגיון התכנותי של ה-PHP.

הגדר פונקציות PHP אישיות

בתוך קוד ה-PHP אתה יכול ליצור פונקציות אישיות. לדוגמה:

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

שימו לב, שלא להגדיר פונקציה במהלך קריאה לדף מספר פעמים. זה יכול לקרות כאשר שם הפונקציה הוא גם עשוי להיות בחלון הראשי, בכותרת, במודול כלול, בחלק דף או בהנחיות.

בחר עבור פונקציות PHP אישיות שמות חד משמעיים ככל האפשר. הגדרת פונקציה כפולה ב-PHP תגרום לשגיאה.

שם פונקציה ספציפית לפרויקט יכול להיראות כך:

function MyProjectCreateCustomerText() {
   return "Customer";
}

בדוק פונקציות קיימות לפני הגדרת פונקציה

חלופית, אתה יכול לבדוק עם function_exists() אם הפונקציה הרלוונטית הוגדרה כבר:

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

השתמש בפונקציות PHP של בלוטרוניקס

בחלון קוד ה- PHP אתה יכול גם להשתמש בפונקציות PHP שמסופקות על ידי ה-CMS bluetronix. דוגמה היא שליחת דוא"ל דרך מערכת ה-SMTP של bluetronix עם BlueSMTPMail():

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

את הפרמטרים הדרושים אתה יכול להגדיר בתוך קוד ה-PHP שלך, לדוגמה:

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

לאחר מכן, אתה יכול להשתמש בפונקציה המרכזית לשליחת דוא"ל. כדי לבצע קריאה מלאה, יש להגדיר גם את שאר הפרמטרים הנדרשים כראוי. כך אתה לא צריך לתכנת מחדש פונקציות CMS בסיסיות כמו שליחת SMTP.

סיכום

קוד PHP אישי מבוצע ישירות על ידי ה-CMS bluetronix; תגי PHP נוספים אינם דרושים בעורך PHP Code. $LayoutHTML כולל את קוד ה-HTML של הדף שנוצר כרגע ומאפשר לך להחליף מתחמים אישיים בתוכן דינמי.

צור את מבנה ה-HTML שלך ככל האפשר בתחום ה-HTML והחלף את המתחמים דרך PHP. זה מאפשר ללקוח הסופי לערוך את הפריסה מאוחר יותר עם עורך ה-CMS הרגיל, בעוד ההגיון התכנותי נשאר מופרד.