المدونة الهندسية
التحقق من التغيير قبل الكتابة في WordPress
الخلاصة
عندما يختار صاحب الموقع تطبيق اقتراح، نجلب محتوى WordPress الحالي ونتحقق من موضع التعديل. نكتب التغيير عندما يكون الهدف واضحًا، ونقدّم الصياغة للنسخ عندما يحتاج التعديل إلى تنفيذ يدوي.
تقييد الاتصال والهدف
نخزّن كلمة مرور تطبيق WordPress مشفرة، ونستخدمها لاستدعاء REST API عبر HTTPS على المضيف المسجّل فقط. وعند التطبيق، نتحقق من حالة الاشتراك ومن أن صفحة الاقتراح تنتمي إلى ذلك الموقع.
نطابق عنوان URL الذي يعيده WordPress للمقالات والصفحات. أما الصفحة الرئيسية فنقرأ إعداد الصفحة الأمامية في WordPress.
التخطيط انطلاقًا من القيمة الحالية
في العناوين والأوصاف، يجب أن يطابق النص الأصلي قيمة حالية. وفي تعديل محتوى المقالة، نحلل HTML ونبحث عن تطابق واحد مؤهل داخل عقدة نصية ظاهرة، ونقارن عدد العقد غير النصية قبل التغيير وبعده.
تتطلب الكتابة في المحتوى أيضًا صلاحية الحفاظ على HTML. وإذا احتوى HTML المنشور على علامة معروفة لأداة بناء صفحات، أو ظهر النص الأصلي في موضعين مؤهلين، نقدّم الصياغة لينسخها صاحب الموقع إلى محرره.
التحقق من الاستجابة وحدود التراجع
نسجّل التغيير المخطط له قبل الكتابة، ونقارن القيمة المحفوظة المُعادة بالقيمة المتوقعة. وإذا اختلفتا، نحاول استعادة القيمة السابقة ونبلغ عن الفشل، وقد تفشل الاستعادة نفسها. كما أن هذه الاستعادة لا تمنع تمامًا الكتابة فوق تعديل حدث في الأثناء.
يقارن التراجع بصمة (hash) الحقل المستهدف بأكمله، ولا يكتب فوقه إذا تغيّر منذ الكتابة. ومع ذلك قد يتعارض تعديل يقع بين القراءة والكتابة مع هذه العملية. والمحتوى المطبَّق يدويًا من نسخة خارج مسار التراجع هذا.
تتبّع تعديلًا افتراضيًا في النص
لنفترض أن المحتوى المخزّن لصفحة صيانة افتراضية هو «<p>نصلح الدراجات الهوائية.</p>»، والنص الأصلي المقترح «نصلح الدراجات الهوائية.» والبديل «نقدم خدمة صيانة الدراجات الهوائية.». إذا تطابق عنوان URL، وظهر النص الأصلي في عقدة نصية ظاهرة مؤهلة واحدة، واجتازت الشروط الأخرى، يخطط النظام لهذا الاستبدال. والخطة ليست ضمانًا لنجاح الكتابة.
إذا ظهرت الجملة الأصلية مرتين، لا يستطيع النظام الاختيار بينهما ويقدّم النص للنسخ اليدوي. وقد يمنع التطبيق التلقائي أيضًا تغيّرُ القيمة الحالية، أو تعذّر قراءة وصف SEO مدعوم، أو غياب صلاحية الحفاظ على HTML. قارن الاقتراح بمحرر WordPress واختر الموضع المقصود.
افحص الصفحة واستعد بتأنٍّ
قبل التطبيق، افحص عنوان URL والنسختين. وبعد التطبيق، افتح الصفحة المنشورة وافحص الجملة المعدّلة والتنسيق المحيط بها. قد تؤخر ذاكرة التخزين المؤقت ما يراه الزوار، لذا افحص القيمة المحفوظة والعرض العام كلًّا على حدة.
إذا أبلغ التراجع عن قيمة متغيرة أو فشل، فلا تكتب فوق التعديلات اللاحقة دون تفكير. قارن حقل WordPress الحالي بالمراجعات المتاحة، وقرر مع المسؤول عن الموقع ما تجب استعادته. فقد تفشل الاستعادة التلقائية نفسها، والتغييرات الملصقة يدويًا خارج مسار التراجع في هذه الخدمة.