الإعلانات وسجل التغييرات
هذا هو الجانب اللي تقول فيه لمستخدمينك وش الجديد. ثلاثة أسطح، كلها من نفس المشروع:
- الإعلانات: نوافذ منبثقة موقوتة يوصّلها الودجت، بصورة اختيارية وزرّ إجراء. مكانها بتنقّل المساحة تحت الإعلانات.
- سجل التغييرات: قائمة مدخلات متواصلة (عنوان، ونصّ، ووسم، وتاريخ، وصورة رئيسية اختيارية) تغذّي صفحة عامة مستضافة. مكانه داخل المشروع نفسه، تحت تبويب سجل التغييرات.
- ما الجديد: خلاصة داخل الودجت فيها آخر مدخلات سجل التغييرات والإعلانات الحيّة، وعدّاد «غير مقروء» على زرّها الخاص.
وكل شي يشوفه الزائر يُسلَّم بلا ما يعطّل صفحتك ولا يكسرها، حتى لو كان الخادم بطيئاً أو غير متاح.
الإعلانات
Section titled “الإعلانات”الإعلان نافذة منبثقة قابلة للنشر لمشروع واحد: عنوان، ونصّ غنيّ، وصورة اختيارية، وزرّ إجراء اختياري، ونافذة زمنية، وسقف تكرار. الودجت يعرضه للزوّار المطابقين، ويسجّل مين شافه ومين ضغط.
كيف تكتب واحداً
Section titled “كيف تكتب واحداً”-
روح الإعلانات ← إنشاء، اختر المشروع، واعطه عنواناً (لين 200 محرف)، واختر نوعه:
newsأوfeatureأوimprovementأوfix، وهو اللي يحدّد أيقونة النافذة ونبرتها. يبدأdraft. -
اكتب النصّ بـماركداون آمن (لين 20000 محرف). المحرّر بسيط ومرئي (عريض ومائل وقوائم وروابط)، فما أحد يحتاج يكتب رموز ماركداون.
-
لو تبغى، ضيف صورة:
pngأوjpgأوjpegأوwebpأوgif، لين 1024 كيلوبايت. وSVG غير مقبول. -
ولو تبغى، ضيف زرّ إجراء: تسمية للزرّ (لين 60 محرف) ورابط (لين 2048 محرف). الاثنان مربوطان: إمّا تسمية ورابط معاً، وإلّا لا شي.
-
اضبط النافذة الزمنية وسقف التكرار. وطرفا النافذة الاثنان اختياريان: خلّ
starts_atفاضياً ويصير الإعلان حيّاً أوّل ما تنشره، وخلّends_atفاضياً ويظلّ شغّالاً لين تلغي نشره. ولو حطّيت بداية، فالنهاية لازم تكون بعدها تماماً. ولو تبغى، ضيّق الجمهور، واختر زاوية النافذة وثيمها (autoأوlightأوdark). -
انشر. الإعلان يصير حيّاً للزوّار المطابقين أوّل ما يُنشر ويكون داخل نافذته.
التكرار والنافذة الزمنية
Section titled “التكرار والنافذة الزمنية”الإعلان ما يُعرض إلا وهو published وداخل نافذته الزمنية. وفيه سقفان يحكمان تكرار العرض:
| التكرار | السلوك |
|---|---|
once |
الزائر الواحد يشوفه مرّة وحدة على الأكثر، عبر الجلسات كلها. |
every |
يقدر يظهر ثانية بكل زيارة. |
ووقت نهاية يساوي وقت البداية أو أقدم منها مرفوض: نافذة ما تسع لحظة معناها إعلان يُنشر وما يشوفه أحد، ولا شي على الشاشة يقول لك كذا.
بس هالفحص يحتاج بداية يقارن عليها. لو خلّيت starts_at فاضياً وحطّيت ends_at في الماضي، يُقبَل —
ويصير عندك إعلان منشور، خارج أي نافذة، وما يشوفه أحد، وهي بالضبط الحالة اللي وُجد الفحص عشان يمنعها. فلو
خلّيت البداية فاضية، خلّ النهاية فاضية معها.
وإغلاق الإعلان يوسمه «مشاهَداً» لحساب السقف. وبما إن السقف يُنفَّذ بتخزين متصفّح الزائر، فالتتبّع «بقدر
المستطاع»: زائر مسح تخزينه أو حاجبه يقدر يشوف إعلان once ثانية، بس التسليم ما يخطئ ولا يعطّل الصفحة
أبداً. وتعديل محتوى إعلان حيّ ما يصفّر حالة «مشاهَد» عند الزائر.
الجدولة والاستهداف
Section titled “الجدولة والاستهداف”فوق النافذة الزمنية، ينطبق نفس الاستهداف الخفيف المتاح للاستبيانات:
- الجمهور:
everyone، أوidentifiedوحدهم. - الرابط يحتوي: نصّ لازم يحتويه رابط الصفحة (لين 300 محرف).
وإذا ما فيه قاعدة، يستهدف الإعلان كل زائر مطابق. ولو صار فيه أكثر من إعلان حيّ بنفس الوقت، فينطبق حدّان والترتيب بينهما يفرق: الودجت يوصله أحدث عشرة إعلانات حيّة — والاستهداف ما له دخل بهالقصّة — وبعدين يعرض أوّل واحد منها يطابق هالزائر، نافذة وحدة في كل مرّة. والإعلان الحادي عشر ما يوصل الزائر أصلاً، مهما كان استهدافه مضبوطاً عليه.
عدّادا المشاهدة والنقر
Section titled “عدّادا المشاهدة والنقر”إشارتان من الودجت تغذّيان تفاصيل الإعلان باللوحة:
- عدّاد مشاهدة، يُرسَل أوّل مرّة تُعرض فيها النافذة للزائر، و
- عدّاد نقر، يُرسَل أوّل مرّة يضغط فيها ذاك الزائر زرّ الإجراء.
والإشارتان تُنقَّحان من التكرار لكل زائر ولكل إعلان، بنفس تخزين المتصفّح اللي يستعمله سقف التكرار.
يعني الرقمان «وصول» مو «انطباعات»: إعلان على every شافه زائر واحد خمسين مرّة يُحسب مشاهدة وحدة، ونقرة
ثانية من نفس الشخص ما تزيد شي. ونفس تحفّظ «بقدر المستطاع» ينطبق — زائر مسح تخزينه أو حاجبه يُحسب من جديد.
والإشارات ما تُحسب إلا لإعلان الخلاصة أصلاً تقدّمه. يعني إعلان draft أو ملغي النشر أو خارج نافذته ما
يلوّث هالأرقام أبداً.
والعدّادان يظهران بقائمة الإعلانات وبالإعلان نفسه، على كل باقة فيها الإعلانات. ويتجمّعان كمان — على كل الإعلانات — بـلوحة الرؤى، بس هالصفحة ميزة منفصلة تبدأ من باقة احترافي، فحساب على البداية يقرأ أرقامه إعلاناً إعلاناً.
سجل التغييرات
Section titled “سجل التغييرات”مدخل سجل التغييرات ملاحظة دائمة وقابلة للربط عن تغيير صار. وعكس الإعلان، ما يحتاج السنيبت: الصفحة المستضافة اللي تحت تشتغل بلا ما تلصق شي بموقعك، وحتى ومفتاح السنيبت مطفي. بس يحتاج المشروع يكون منشوراً، وهذا بدوره يحتاج نطاقاً مسموحاً واحداً على الأقل — شوف تركيب سنيبت الموقع.
افتح المشروع واختر تبويب سجل التغييرات. كل مدخل له عنوان (لين 200 محرف)، ونصّ بماركداون آمن
(لين 20000 محرف)، ووسم، وتاريخ مدخل، وصورة رئيسية اختيارية (بنفس الصيغ وسقف 1024 كيلوبايت).
وجنب المحرّر معاينة حيّة تعرض المدخل زي ما بترسمه الصفحة العامة. والمدخلات draft لين تنشرها، وإلغاء
النشر يرجّع المدخل draft.
والوسم واحد من:
newimprovedfixed
وحقل التاريخ يجيك معبّى بيومك أنت، بالمنطقة الزمنية اللي بملفّك الشخصي — مو بـUTC، اللي كانت بتؤرّخ
مدخلاً كُتب الساعة وحدة فجراً بالرياض لليوم اللي قبله. بس فيه تحفّظ واحد: ملفّ شخصي ما فيه منطقة زمنية
محفوظة يرجع ليوم متصفّحك أنت. نموذج الملف الشخصي يعرض Asia/Riyadh مختارة أصلاً، بس ما ينحفظ شي
لين تضغط «حفظ» — فاضبطها مرّة وحدة من الملف الشخصي ← المنطقة الزمنية. وعلى كل حال الحقل
منتقي تاريخ عادي تقدر تغيّره قبل ما تحفظ.
الصفحة العامة المستضافة
Section titled “الصفحة العامة المستضافة”كل مشروع منشور، على باقة فيها الإعلانات، له صفحة سجل تغييرات عامة على رابط ثابت مفتاحه مفتاح الودجت العام:
https://api.umarker.com/changelog/<public_key>الصفحة بلا مصادقة: أي أحد معه الرابط يقرأها. وتسرد مدخلات ذاك المشروع published وحدها، الأحدث أوّلاً
بتاريخ المدخل، عشرين بالصفحة، وما تكشف مسوّدات ولا بيانات أي مستأجر ثاني أبداً. ومشروع بلا مدخلات منشورة
يعرض حالة فاضية مصمّمة، مو خطأ.
والرابط يرجّع «غير موجود» نظيفاً — ومو سجلّ أحد ثاني أبداً — لو كان المفتاح مجهولاً، أو المشروع رجع مسوّدة، أو الحساب معلَّق، أو الباقة ما عاد فيها الإعلانات.
والصفحة تتكلّم لغة علامتك (اللغة اللي كُتبت فيها المدخلات) مو لغة متصفّح القارئ، لأن إطاراً إنجليزياً حول نصّ عربي يُقرأ منتجاً نصّ خلصان. وتحتها تذييل «مدعوم بـuMarker» إلّا إذا كانت باقتك تشيل علامة uMarker.
تلقى <public_key> بتبويب الودجت ← السنيبت بالمشروع، وهو نفس المفتاح اللي يستعمله سنيبت الودجت.
وتدوير المفتاح أو سحبه يغيّر هالرابط أو يعطّله كمان. وuMarker ما تطبع لك الرابط مركّباً بأي مكان باللوحة
— انسخ المفتاح وحطّه بعد /changelog/ بنفسك.
«ما الجديد» داخل الودجت
Section titled “«ما الجديد» داخل الودجت”الودجت يحمل كمان عرض ما الجديد: آخر مدخلات سجل التغييرات المنشورة للمشروع، تُقرأ في سياقها. وله زرّ خاص فيه، منفصل عن زرّ الملاحظات: مثبَّت أسفل يسار الصفحة، مو بالزاوية اللي اخترتها للمُشغِّل، وما يُرسَم إلّا لمّا يصير للمشروع مدخل منشور واحد على الأقل.
وهالزرّ يحمل شارة حمراء تعدّ مدخلات الخلاصة اللي أُنشئت بعد أحدث مدخل شافه هالزائر. وفتحها يمسح الشارة ويوسم كل شي مشاهَداً. والمقارنة بترتيب الإنشاء مو بوقت النشر، فمدخل كتبته مسوّدةً قبل آخر زيارة للزائر ونشرته بعدها ما يحرّك الشارة. والعدّاد هو كامل التمييز — جوّا اللوحة المفتوحة كل مدخل يُرسَم بنفس الشكل، فالزائر ما يقدر يعرف أي واحد فيها الجديد.
وخلاصة الودجت تقدّم الإعلانات الحيّة (الأحدث أوّلاً، لين 10) وآخر مدخلات سجل التغييرات المنشورة (لين 20). وهذا هو السطح اللي يقفل الحلقة لزائر راجع لمّا تعلن إصلاحاً.
الكتابة بماركداون آمن
Section titled “الكتابة بماركداون آمن”نصوص الإعلانات وسجل التغييرات تُكتب بمجموعة ماركداون صغيرة بقصد، مختارة عشان المحتوى المكتوب ما يقدر
يحقن سكربتاً ولا أنماطاً في صفحة العميل ولا في الصفحة العامة. النصّ يُهرَّب HTML أوّلاً، فأي HTML خام
أو <script> أو style أو معالج حدث تكتبه ينعدم مفعوله قبل ما يُفسَّر أي ماركداون.
- فقرات مفصولة بسطر فاضي
- قوائم نقطية بـ
- **عريض***مائل*`كود`[نصّ الرابط](https://example.com)(http/httpsفقط)
- أي وسوم HTML خام
- الأنماط السطرية وخاصيّة
class - العناوين والاقتباسات والخطوط الفاصلة
javascript:أو أي مخطّط رابط غير http (النصّ يبقى، والرابط يُسقَط)- أي شي بعد حدّ الـ20000 محرف
والروابط تُرسم بـrel="noopener nofollow" وتفتح بتبويب جديد. ما فيه تمرير HTML خام ولا دعم للخصائص.
وقائمة السماح بعد التهريب هي كامل سطح الرسم.
اكتبه بلغتين
Section titled “اكتبه بلغتين”العناوين والنصوص بالسطحين لها تبويب عربي وتبويب إنجليزي. الزائر يقرأ لغة الصفحة اللي هو عليها، وصفحة سجل التغييرات المستضافة تتبع لغة علامتك. تملأ لغة وحدة؟ هذي اللي بتوصل كل قارئ.
مين يقدر يسوي وش
Section titled “مين يقدر يسوي وش”السطحان يتشاركان مجموعة صلاحيات وحدة، ودور المشروع يقدر يتجاوز دور المساحة:
| الأكشن | الصلاحية |
|---|---|
| يشوف القائمة ويفتح مدخلاً أو إعلاناً | content.view |
| ينشئ واحداً | content.create |
| يعدّله | content.update |
| ينشر أو يلغي النشر | content.publish |
| يحذفه | content.delete |