استخدام كود PHP و $LayoutHTML في نظام إدارة المحتوى bluetronix

رمز PHP الخاص في نظام CMS bluetronix

مع وصول المطور، يمكنك استخدام رمز PHP الخاص داخل صفحة نظام CMS. يعمل رمز HTML للصفحة ورمز PHP الخاص بك معًا. تلعب المتغير $LayoutHTML دورًا مركزيًا: يحتوي على رمز HTML للصفحة التي تم إنشاؤها حاليًا أثناء عملية عرض الموقع. يمكنك باستخدام PHP البحث عن محتويات داخلها وتعديلها واستبدالها.

لترميز PHP الخاص، تحتاج إلى وصول مطور إلى نظام CMS bluetronix. إذا لم يكن لديك وصول مطور بعد، يمكنك التقدم بطلب عليه بشكل منفصل.

افتح رمز PHP لصفحة

افتح على الصفحة المطلوبة PHP Code لتحرير رمز PHP الخاص بالصفحة.

لا تستخدم علامات PHP إضافية

يتم تنفيذ رمز PHP من قبل نظام CMS بالفعل كرمز PHP. لذا، لا يجوز لك استخدام علامات 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 bluetronix، يمكنك إدارة رمز HTML ورمز PHP لصفحة بشكل منفصل. لذا تظل الهيكلية HTML قابلة للتحرير في المحرر، بينما تضع منطق البرمجة في منطقة PHP.

حدد عناصر النائب الخاصة في HTML

قم بتعريف عنصر نائب في كود HTML، يجب أن يقوم كود PHP الخاص بك باستبداله لاحقًا. مثال بسيط هو:

__MyText__

استخدم أسماء باللغة الإنجليزية لعناصرك النائبة، حتى في المواقع الناطقة بالألمانية. هذا يبقي التسمية مفهومة دوليًا وموحدة.

تشمل الأسماء الممكنة الأخرى ما يلي:

__CustomerName__
__ProductPrice__
__CurrentDate__

استبدل عناصر النائب بـ $LayoutHTML

باستخدام str_replace() يمكنك البحث عن العنصر النائب في كود HTML الحالي واستبداله بالمحتوى الذي تريده:

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

يعثر نظام إدارة المحتوى على $LayoutHTML على __MyText__ ويستبدل العنصر النائب بـ نصّي.

دمج HTML وعناصر النائب

يمكنك استخدام العنصر النائب داخل بنية HTML العادية الخاصة بك. على سبيل المثال، أدخل الكود التالي في قسم HTML:

<h1>__MyText__</h1>

وفي قسم PHP، أضف الاستبدال:

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

خلال عملية التصيير، يصبح الناتج:

<h1>Meine Überschrift</h1>

عدة عناصر نائب في قسم واحد من الصفحة

يعمل نفس المبدأ في مجالات HTML الأكثر تعقيدًا. يمكنك على سبيل المثال تحديد عنوان ووصف كعناصر نائب بشكل منفصل:

<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، تعديل التصميمات وتحرير أجزاء الصفحات من خلال محرر نظام إدارة المحتوى العادي دون الحاجة إلى تغيير منطق برمجة 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 الخاصة بـ bluetronix

في منطقة كود PHP، يمكنك أيضًا استخدام وظائف PHP التي يوفرها نظام إدارة المحتوى 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";

بعد ذلك، يمكنك استخدام الوظيفة المركزية لإرسال البريد الإلكتروني. لتكون الدعوة كاملة، يجب أيضًا تعيين المعلمات الأخرى المطلوبة بشكل مناسب. لذلك، لا تحتاج إلى برمجة الوظائف الأساسية لنظام إدارة المحتوى مثل إرسال SMTP بنفسك مرة أخرى.

ملخص

يتم تنفيذ كود PHP الخاص بك مباشرةً من قبل نظام إدارة المحتوى bluetronix؛ لا توجد حاجة لعلامات PHP إضافية في محرر PHP Code. $LayoutHTML يحتوي على كود HTML للصفحة التي تم إنشاؤها حاليًا ويسمح لك باستبدال العناصر النائبة بمحتويات ديناميكية.

قم بإنشاء هيكل HTML الخاص بك قدر الإمكان في قسم HTML واستبدل العناصر النائبة عبر PHP. بذلك، يمكن للعميل النهائي تعديل التخطيط لاحقًا باستخدام محرر نظام إدارة المحتوى العادي، بينما يظل منطق البرمجة منفصلًا.