دليل المستخدم

مجلة مباشر لادارة المحتوى الاخبارى

فى البداية نشكرك على استعمال مجلة مباشرة الاخبارية عليك الاتصال بنا اذا واجهت أي مشاكل أو طلبات أو حتى إذا كنت ترغب فقط في التحدث معنا ، البريد الالكتروني : sales@mubashier.com


تابع الشروحات دائما

عليك مراجعة دليل المستخدم بين كل فترة واخرى لمتابعة جديد الشروحات وطريقة استخدام الاضافات الاجديدة

بيئة التثبيت

السيرفر الخاص بك يجب توافر به هذه الاشياء لضمان جودة اكثر للبرنامج

Apache

يفضل ان يكون النظام الذى يعمل به السيرفر هو suphp لان البرنامج يقوم بعمل مجلدات وملفات على السيرفر ولابد من وجود تصريح له لعمل ذلك

PHP

الاسكربت يحتاج ان يكون اصدار PHP على الاقل 5.2 او 5.3 ويجب توافر هذه الاشياء بها

  • PDO MySQL وان لم تكن يسيتخدم MYSQLI ثم MYSQL
  • iconv + mbstring
  • CURL
  • GD
  • ionCube
  • TIDY

خطوات التثبيت

رفع الملفات عن طريق الـftp او الـfile manager الخاص بالـcpanel

  • عليك اولا الحصول على ملفات البرنامج من المختصين
  • عليك رفع الملف المضغوط الى السيرفر الخاص بك
  • بعد ذلك قم بفك ضغط الملف المضغوط
  • قم بالدخول الى الموقع الخاص بك من المتصفح
  • سيتم تحويلك الى صفحة التثبيت

صفحة فحص النظام

عند الدخول الى صفحة التثبيت سيظهر لك صفحة التاكد من اعدادت النظام والمتطلبات

  • ان كانت مسارات المجلدات تعطى اشارة حمراء ، عليك اعطائها تصريح 755 او 777 او تغيير النظام ككل على اساس الانسب لك

بعد التاكد من ان كل شىء على ما يرام اضغط استمرار

صفحة ادخال بيانات السيرفر

بعد عمل قاعدة بيانات واسم مستخدم من النظام الخاص بك وربطهم عليك ادخال البيانات الخاصه بهم كما هو موضح

حيث ان user_ هو اسم المستخدم الخاص بالاستضافة الخاصة بك وهو ليس قيمة ثابته

صفحة ادخال بيانات الموقع

تاكد بانك قمت بنسخ كلمة المرور ثم اضغط على قمت بنسخ كلمة المرور لدى واضغط استمرار

وضع أمر الكرون

اذا كان السيرفر الخاص بك cpanel

  • قم بالدخول الى رابط الموقع الخاص بك مكتوب بعده /cpanel او :2082
  • قم بكتابة اسم المستخدم وكلمة المرور الخاصين بالاستضافة
  • قم بالبحث عن ايقونة Cron Jobs
  • قم بوضع الامر الموجود فى الصورة واختيار تنفيذه كل دقيقة (هل التنفيذ كل دقيقة يأثر على الموارد؟)

كيفيه اضافه قسم

كيفيه اضافه قسم مع جعل القسم غير مرئي

كيفيه اضافه قسم مع جعل القسم كا قسم فرعي

  • قم بدخول لوحه الاداره وبعدها اختر الاقسام ثم اختر قسم جديد


  • سوف تظهر الصفحه التاليه

    • 1 - اكتب اسم القسم مثلا اخبار العالم

    • 2 - البرفكس وهو اسم القسم بالغه الانجلزيه ويظهر في الرابط مثلا world

    • 3 - القسم الاب اخترها لايوجد اب اذا كان هذا القسم رئيسي اما اذا كان قسم فرعي منسدل من احد الاقسام فرجاء اختيار القسم الاب الذي سوف يظهر هذا القسم اسفله

    • 4 - اذ ارت ان يظهر هذا القسم في الرئسيه اختر نعم او لا اذا اردت اخفائه

    • 5 - وصف مختصر للقسم

    • 6 - الكلمات الدلائليه التي تظهر عند البحث عن القسم في محركات البحث

كيفيه تعدل او حذف او ترتيب الاقسام

  • ادخل الاداره واضغط علي الاقسام واختر تصفح الاقسام

    • 1 - لتعديل القسم

    • 2 - حذف القسم نهائيا

    • 3 - اضغط علي القسم اذا كان يحتوي علي اقسام فرعيه

    • 4 - اختر ترتيب العرض في الرئسيه اذا اردت ترتيب ظهور الاقسام في الرئسيه

كيفيه اضافه مصدر

  • ادخل لوحه الاداره ومنها اضغط علي المصادر واختر مصدر جديد


  • ستم تحويلك لصفحه اضافه المصدر

  • اسم المصدر : اختيار اسم للمصدر لتميزه من المصادر الاخري

  • شعار المصدر : صوره شعار المصدر تستخدم كاصوره للخبر اذا لم يكن موجود صوره داخل الخبر

  • نوع العرض

    • عرض المحتوي في موقعك : يتم عرض المحتوي كامل في موقعك كانك انت الكاتب

    • عرض المصدر في (iframe) : يتم عرض الخبر داخل اي فريم في موقعك

  • حاله الادراج

    • الادارج المباشر : يتم ادراجل الخبر مباشره في موقعك عند جلبه دون انتظار المراجعه

    • ينتظر المراجعه :لن يتم نشر الخبر الا بعد مراجعته والموافقه عليه من قبل الادمن

  • يعمل ؟ : اختر نعم اذا اردت ان يعمل الموقع مباشره بعد اضافه الروابط او لا لتشغيله لاحقا

  • يعد الانتهاء من هذه الحقول اضغط حفظ


  • بعد الضغط علي حفظ سيتم تحويلك لصفحه اضافه الروابط

هنا يتم وضع روابط التغذيات التى سوف يتم الجلب منها ومن الانواع الذى يقبلها البرنامج

  • تغذية RSS: وهى رابط التغذية المباشر الذى يقدمها الموقع المواد الجلب منه
  • تاج YouTube: كلمة او تاج لجلب الفيديوهات التى بها هذه الكلمة من اليوتيوب
  • قناة YouTube: قناة اليوتيوب الذى تريد جلب الفيديوهات منها

(يوجد انواع تغذيات اخرى)

القسم المقترح: القسم الذى سوف تدرج به العناصر المجلوبة من هذه التغذية
نوعية العرض: هل يتم ادارج العنصر المجلوب على هيئة خبر او فيديو او صورة او مقالة وفى بعض الحالات يتم اجبار العنصر على ان نوع عرض معين مثل حالات اليوتيوب اذا لم يتم اختيار النوع فيديو سيتم ادراجه كفيديو


بعد الضغط على حفظ سيظهر لك زر "معاينة" امام كل تغذية قمت بإضافتها عليك الضغط عليه ليظهر لك صفحة معاينة التغذية وهذه الصفحة من اهم الاشياء التى تمكنك من معرفة كيف يستطيع البرنامج رؤية المحتوى الخاص بالتغذية لان ليس دائما يقوم محدد الجلب الالى بتحديد المحتوى لذلك عليك فتح المعاينة والتأكد من جلب المحتوى دون شوائب والصورة الاساسية للخبر والفرعية ايضا

عند فتح صفحة المعاينة ستجد شريط فى اعلى الصفحة مثل هذا

أولا عليك اختيار الموضوع المراد تطبيق المعاينة عليه بعد ذلك اختيار نوع عرض المعاينة ولديك 4 انواع لذلك وهم

  • بعد الجلب: تظهر الشكل النهائى للعنصر بعد الجلب من حيث الصور والمحتوى
  • فحص النتيجة: تفيدك فى معرفة ما يجرى بالتحديد عند محاولة الجلب وتستخدم لمعرفة الاخطاء فى حالة عدم القدرة على تحديد المحتوى او الصورة
  • رؤية البرنامج: تظهر اليك كيف يرى محرك الجلب الصفحة فى الاساس لان فى بعض الاحيان يظهر فى المحتوى صور او اشياء لا تنفذ الا عن طريق الجافا سكربت والمحرك لا يستطيع ترجمة الجافا سكربت لذلك يظهر لك كيف يرى هو الصفحة لكى تضع الحل الامثل لجلب المحتوى ام تحديد الصورة
  • فى المصدر: تظهر لك صفحة العنصر فى موقع كما هو عن طريق اى فريم وتستخدم احيانا لتحديد المحتوى عن طريق اضافات المتصفح مثل الـfirebug

خطوات تحديد المحتوى

عند فتح المعاينة عليك اولا النظر على "بعد الجلب" اذا كان الامر على مايرام لن تحتاج الى اعدادات اخرى لتحديد المحتوى اما اذا كان هناك شوائب او ليس هناك محتوى من الاساس او فشل المحدد الالى فى تحديد المحتوى عليك الانتقال الى "رؤية البرنامج"

يجب ان يكون لديك خبرة ولو ضعيفة فى الـHTML

1. فتح رؤية البرنامج

ستظهر الصفحة لديك دون تصميم لان هذا ما يراه البرنامج ودون اى جافا سكربت ايضا ، عليك البحث بعينيك عن المحتوى والصورة المراد جلبهم (وهذه العملية يتم وضعها مرة واحدة لكل هيكل صفحة للتغذية)

2. تحديد العناصر التى تمثل ما تريد تحديده

(يجب ان يكون لديك إضافة الـFIREBUG ان كنت تستعمل متصفح الـMozilla Firefox القديم او يمكنك الاعتماد على الاضافة الداخلية له ان كان يدعم ذلك وان كنت تستعمل Google Chrome فلديه اضافة فحص داخلية سوف نستعملها فى الامثلة)

قم بضغط الزر الايمن من الماوس لديك على نص الخبر او الصورة المرد الوصول الى مسار تحديده ثم قم بإختيار Inspect Element ستظهر لك شاشة عرض المصدر الخاصة بالمتصفح وهذا مثال بسيط جدا لما يمكن ان تراه

ترى ان محتوى الخبر الاساسى موجود فى عنصر من نوع div له id يسمى "article_body" وفى هذه الحالة وصلنا لشىء نميز بيه المحتوى وهو الاى دى الخاص بعنصر الخبر وترى ان صورة الخبر الاساسية موجودة داخل نفس العنصر ، ان لم يقوم البرنامج بتحديدها تلقائيا ستقوم باستعمال الـid الخاص بها ايضا

3. وضع اعدادات التحديد اليدوى

قم بفتح المصدر من قسم المصادر فى لوحة التحكم وقم بالضغط على تاب "المحتوى" ثم تغيير تحديد المحتوى الى تحديد يدوى والذهاب الى العناصر كما موضح فى الصورة السابقة والضغط على العنصر نفسه واختيار Copy XPath

سيعطيك المسار //*[@id="article_body"] قم بوضعه فى إحدى احتمالات تحديد المحتوى

لتحديد الصورة سنفعل نفس الخطوات ونضع النتيجة فى احدى احتمالات تحديد الصور

احيانا يكون هناك مواقع لها لكل نوع من الاخبار لديها صفحة بهيكل مختلف اى فى حالة المقالات هيكل مختلف تماما عن الاخبار فى هذه الحالة ان كانت هذه الصفحات موجودة فى تغذيات مختلفة يمكنك وضع كل نوع تغذية فى مصدر منفرد باعدادات منفردة او يمكنك استخدام الاحتمالات ان كانت الهياكل مختلفة فى نفس التغذية اى تضع تحديد محتوى الهيكل الاول فى احتمال المسار الاول والثانى فى الثانى وهاكذا وعندما يحاول البرنامج ان يجلب سيقوم بتجربة الاحتمال رقم 1 للمسار وان فشل سيحاول فى الاحتمال 2 وهاكذا حتى ياتى به ونفسه فى حالات تحديد الصور يوجد فى مواقع كثيرة احتمالات كثيرة فى صفحة واحدة لظهور الصور بها ربما يظهر صورة واحدة ربما يظهر معرض صور فنقوم بوضع احتمال تحديد الصورة الواحدة ثم احتمال معرض الصور فى اعدادات المصدر الواحد

ماهو XPath

هو مسار تحديد العناصر وإحتمالاته ليس لها نهاية وله دوال كثيرة جدا حيث يمكنك تحديد العناصر عن طريق اى من خصائصها او موقعها فى ملف الـhtml

صيغته المبسطة

//*[@attr="value"]

  • // البدء من اول الملف
  • * تعنى عنصر بأى نوع مثل div او span الخ ، ان اردت تحديد عنصر بعينه اكتب اسمه //table[@attr="value"]
  • attr هى الخاصية المراد التحديد بها مثل الـid او الـclass او rel او اى شىء
  • value قيمة الخاصية ، يمكن ان تكون كلاس او اى دى اى اسم او اى شىء

أمثلة مختصرة

  • p[@class and @id] تحدد عناصر p الذى لها class و id
  • li[position()=last()] تحديد عنصر li الاخير
  • li[position()>1] تحدد جميع عناصر li التى تقع بعد li الاول
  • .. تقوم بتحديد الاب الخاص بالعنصر الحالى

طرق متنوعة للتحديد

سنقوم بشرح طرق يمكنك استعمالها فى تحديد محتوى الخبر او الصورة

1.تحديد عن طريق الـID للعنصر

انظر الى هذا المثال


<html>

    <head></head>

    <body>

        <div id="main_content">

            <div class="post_content">

                <img src="article_image.jpg" />

                محتوى الخبر هنا

            </div>

        </div>

        <div id="side_bar">

            هنا محتوى القائمة الجانبية

        </div>

    

    </body>

</html>

لتحديد المحتوى فى هذه الحالة يمكن استعمال اكثر من طريقة منهم طريقة التمييز بالـid الاساسى هاكذا

//div[@id="main_content"]/div[0]

او

//div[@class="post_content"]

معنى div[0] تحديد اول عنصر إبن من نوع div وفى المثال الثانى قام بتحديده بشكل مباشر عن طريق الكلاس

فى الحالتين سيتم تحديد


<html>

    <head></head>

    <body>

        <div id="main_content">

            <div class="post_content">

                <img src="article_image.jpg" />

                محتوى الخبر هنا

            </div>

        </div>

        <div id="side_bar">

            هنا محتوى القائمة الجانبية

        </div>

    

    </body>

</html>

2.التحديد عن طريق الـCLASS للعنصر

ان كان خاصية الكلاس فى العنصر ليس بها الا كلاس واحد مثل

<div class="post_content"></div>

يتم تحديده هاكذا //div[@class="post_content"]

ان كان خاصية الكلاس فى العنصر لها اكثر من قيمة

<div class="post_content post-99 no-ad"></div>

حيث ان الكلاس post-99 يتغير فى كل خبر ولا يمكنك استعمال //div[@class="post_content post-99 no-ad"]

يتم تحديده عن طريق دالة contains

//div[contains(@class,'post_content')]

تحديد الصور

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

1 - أخذ الصورة التى يستعملها الموقع للنشر على الفيسبوك وهى (og:image)

//meta[@property="og:image"]/@content

ان كانت الصورة تقليدية وتمتلك اى دى او كلاس او اى خاصية يمكن تميزها بها ولو حتى الـtitle قم بتحديدها بالطريقة العادية

1. اذا كانت الصورة معروضة داخل Lightbox

فى هذه الحالة تكون صورة مصغرة هى التى تم عرضها واذا تم الضغط عليها سيتم فتح الصورة الاصلية بشكل كامل فى Lightbox وغالبا يكون رابط الصورة الاصلية موجود فى وسم من نوع a وليس img لذلك يكون رابط الصورة موجود داخل الخاصية href وليس src ، فى هذه الحالة يتم استعمال رمز @ لاستدعاء الخاصية من العنصر

<a class="lightbox" href="http://domain.com/full_image.jpg">

    <img id="article_image" src="http://domain.com/thumb_image.jpg"/>

</a>

سنقوم باستعمال

//img[@id="article_image"]/../a@href

شرح المسار بالتفصيل

//img[@id="article_image"]

تقوم بتحديد

<a class="lightbox" href="http://domain.com/full_image.jpg">

    <img id="article_image" src="http://domain.com/thumb_image.jpg"/>

</a>

بعد ذلك نستعمل ..

//img[@id="article_image"]/..

تقوم بتحديد

<a class="lightbox" href="http://domain.com/full_image.jpg">

    <img id="article_image" src="http://domain.com/thumb_image.jpg"/>

</a>

بعد ذلك نستعمل a@href

//img[@id="article_image"]/../a@href

تقوم بتحديد

<a class="lightbox" href="http://domain.com/full_image.jpg">

    <img id="article_image" src="http://domain.com/thumb_image.jpg"/>

</a>

دوال مساعدة

1.دالة contains : معناها "تحتوى" اى هل هذا العنصر يحتوى على شىء معين؟

مثال للاستعمال

//img[contains(@class,'post_main_img')]
(تعنى اختيار اى صورة يوجد فى الكلاس الخاص بها كلمة post_main_img)


2. دالة not : وهى دالة عكس ناتج دالة اخرى او التاكد انه ليس يساوى

مثال للاستعمال

//img[not(contains(@class,'banner'))]
(تعنى اختيار اى صورة لا يوجد فى الكلاس الخاص بها كلمة banner)

كيف تقوم باضافة مكان إعلانى جديد

يمكنك اضافة أعلانات فى اى مكان فى الموقع الخاص بك بكل سهولة ، عن طريق الدالة adframe

مثال:(اضافة اعلان فى صفحة عرض الخبر)

من برنامج الـFTP

  • قم بالدخول على خدمه الـFTP الخاصة بموقعك باستعمال اى برنامج كمثال FileZilla
  • قم بالدخول الى الثيم الذى تريد التعديل عليه من المسار /themes/
  • قم بالدخول الى مجلد views
  • قم بالدخول الى مجلد view الخاص بعرض الاخبار
  • قم باختيار " خبر (news.tpl) "
  • اختار تعديل
  • قم بوضع دالة الاعلان فى اى مكان تريده مثل التالى

من لوحة التحكم

  • قم بالدخول الى لوحة تحكم المدير
  • قم بالدخول الى " محرر القوالب & الاستيل"
  • قم باختيار " خبر (news.tpl) "
  • سيظهر لك محرر القوالب
  • قم بوضع دالة الاعلان فى اى مكان تريده مثل التالى

    {adframe width=300 height=250}

مثال لوضع اعلان تحت عنوان الخبر فى قالب مجازينى

  • قم بالدخول على خدمه الـFTP الخاصة بموقعك باستعمال اى برنامج كمثال FileZilla
  • قم بالدخول الى الثيم الذى تريد التعديل عليه من المسار /themes/jmagz
  • قم بالدخول الى مجلد views
  • قم بالدخول الى مجلد view الخاص بعرض الاخبار
  • قم بالتعديل على الملف header.tpl
  • قم بالبحث عن هذا الكود (موجود غالبا فى السطر رقم 19)
    <h1 class="post-title" itemprop="name">
    			{$row._title}
    </h1>
        

    وضع بعده هذا الكود

    {adframe width=970 height=90}

    ويفضل استعمال اكواد الاعلانات المتجاوبة من جوجل ادسنس حتى تتجاوب مع جميع احجام الشاشات

    يمكنك الاختيار من بين ظهور كود الاعلانات بشكل مباشر فى السورس كود او ظهورها فى iframe من اعدادات العرض

الاحجام المتاحه

160x600

120x600

180x600

200x200

250x250

300x250

336x280

728x90

468x60

300x600

320x50

320x75

180x227

780x40

970x90

ملحوظة: انتا مقيد بوضع الاحجام المذكورة فى قائمة الاضافة ولا يمكنك وضع اى احجام

هل طلب ملف الكرون كل دقيقة سيسبب استنفاذ موارد السيرفر؟

طلب ملف الكرون كل دقيقة ليس له علاقة بالموارد ، فانه يجب ان يطلب كل دقيقة حتى يستطيع البرنامج تنسيق وتنفيذ التوقيتات الذى تم وضعها من لوحة التحكم ، وهذا معناه انك اذا قمت بضبط البرنامج ليبدا عملية جلب جديدة كل 5 دقائق فلن تنفيذ بشكل دقيق الا اذا قمت بضبط الكرون كل دقيقة ولن تنفيذ العملية الا كل خمس دقائق والاربع دقائق الاخرى سيكون الدخول الى ملف الكرون من قبل السيرفر مثل الدخول الى ملف فارغ لا يستهلك اى شىء

عندما أحاول الجلب من اليوتيوب يظهر لى رساله (0 RSS ITEMS)

أولا عليك التأكد ان النسخة التى تستعملها لديك اكبر من 1.7.25 بعدد ذلك عليك الدخول الى مشاريع جوجل  ثم القيام بإنشاء مشروع جديد والدخول  الى قائمه "APIs & auth"  ثم "APIs" وتفعيل "YouTube Data API v3" بعد ذلك عليك الذهاب الى "Credentials" وأخذ رقم "API key" ووضعه فى اعدادات الجلب فى لوحه التحكم

لم استطع اضهار اي خبر او موضوع في قسمه بالصفحة الرئيسية و لم استطع الوصول الي اي اعداد يقوم بذلك في لوحة التحكم

لكى تظهر الاخبار فى الصناديق فى الرئيسية عليها ان يكون بها اخبار او فى احد اقسامها الفرعية ولاظهار القسم بالرئيسية "ادارة الاقسام - تعديل - ثم اختار ظهور فى الرئيسية واختار الانواع التى تريد ظهورها"

قمت بإضافة مصدر و تحديد اعداداته كالمصدر الذي قمتم بوضعه و لم يجلب اي موضوع

تاكد اولا من أمر الكرون الموجود لديك فى السى بانل فى ايقونة "cron jobs" وتاكد انه ينفذ كل دقيقة .. تاكد من تفعيل الجلب من "اعدادات الجلب" .. تاكد انك فعلت المصدر لان عند اضافة مصدر جديد يضاف غير مفعل حتى تكمل اعدادته وتقوم بتفعيله ... تاكد من "متابع عمليات الجلب" من رئيسية لوحة التحكم و "دورة الجلب الحالية"

قمت بالتعديل علي بعض الاقسام و حذف البعض الأخر و لكن هناك اقسام فرعية تظهر تحت العناوين الرئيسية في القائمةو هي غير موجودة اصلا في صفحة الاقسام

القائمة العليا والسفلى محتواها منفصل عن الاقسام .. مما يتيح لك اضافة روابط خارجية او اى نوع من الروابط لذلك عندما تحذف قسم لا يتم حذفه تلقائيا من هذه القوائم .. للتعديل عليها "قائمة التنسيق - الروابط والقوائم"

الاخبار التي يتم جلبها عند محاولة عرض قسمها من القائمة العلوية او بلوكات الرئسية اجد هذه الاقسام فارغة لا تحتوي علي اي عناصر

القائمة العلوية والسفلية منفصلة عن محتوى الموقع الديناميكى .. لذلك ان قمت بالتعديل على اقسام الموقع بشكل ما عليك التعديل على هذه القوائم .. ان كنت تواجه مشكلة فى التاكد من وجود الاخبار يمكنك الدخول على الارشيف من الموقع او من ادارة المحتوى من لوحة الادارة

توقف الجلب فى الموقع بشكل مفاجئ.

السبب الاساسى لتوقف الجلب هو حدوث خطأ او حذف امر الكرون "وظائف الكرون" من السيرفر ... عليك التأكد من وجود الامر الذى يشير الى فتح ملف "cron.php" كل دقيقة من الشل او السى بانيل

كيف اضيف كود الاحصائيات او اى كود جافا سكريبت اخر فى القالب.

ان كنت تريد اضافة احصائيات Google او Histats عليك الدخول الى الاعدادات ثم مراقبة & تحليلات ثم وضع رقم الحساب الخاص بك لكل خدمة ، اما ان كنت تريد وضع كود مباشر عليك الدخول الى "المظهر - محرر القوالب - ثم اختيار تعديل هيكل القالب" ووضع اولا وسمى {literal}{/literal} ثم وضع الكود بداخلهما ثم وضع فى اخر سطر فى الملف