Progress towards v3.

Author: Maikuolan

readme.ar.md

@@ -5,9 +5,6 @@
  <li>١. <a href="#SECTION1">مقدمة</a></li>
  <li>٢. <a href="#SECTION2">كيفية التحميل</a></li>
  <li>٣. <a href="#SECTION3">كيفية الإستخدام</a></li>
- <li>٤. <a href="#SECTION4">إدارة FRONT-END</a></li>
- <li>٥. <a href="#SECTION5">CLI (واجهة سطر الأوامر)</a></li>
- <li>٦. <a href="#SECTION6">الملفات الموجودة في هذه الحزمة</a></li>
  <li>٧. <a href="#SECTION7">خيارات التكوين/التهيئة</a></li>
  <li>٨. <a href="#SECTION8">شكل/تنسيق التوقيع</a></li>
  <li>٩. <a href="#SECTION9">مشاكل التوافق المعروفة</a></li>
@@ -103,6 +100,36 @@ https://github.com/phpMussel/Examples
 
 ### <div dir="rtl">٣. <a name="SECTION3"></a>كيفية الإستخدام</div>
 
+#### <div dir="rtl">٣.٠ CONFIGURING PHPMUSSEL</div>
+
+<div dir="rtl">بعد تثبيت phpMussel، ستحتاج إلى ملف تكوين بحيث يمكنك تكوينه. يمكن تهيئة ملفات التكوين phpMussel كملفات INI أو YML. إذا كنت تعمل من أحد ملفات ZIP النموذجية، فسيكون لديك بالفعل مثالان لملفات التكوين المتاحة، <code dir="ltr">phpmussel.ini</code> و <code dir="ltr">phpmussel.yml</code>؛ يمكنك اختيار واحد من هؤلاء للعمل منه، إذا كنت ترغب في ذلك. إذا كنت لا تعمل من أحد ملفات ZIP النموذجية، فستحتاج إلى إنشاء ملف جديد.<br /><br /></div>
+
+<div dir="rtl">إذا كنت راضيًا عن التكوين الافتراضي لـ phpMussel ولا تريد تغيير أي شيء، يمكنك استخدام ملف فارغ كملف التكوين الخاص بك. أي شيء لم تتم تهيئته بواسطة ملف التهيئة الخاص بك سيستخدم الإعداد الافتراضي الخاص به، لذلك لن تحتاج إلا إلى تكوين شيء بشكل صريح إذا كنت تريد أن يكون مختلفًا عن الإعداد الافتراضي الخاص به (بمعنى أن ملف تكوين فارغ سيتسبب في أن يستخدم phpMussel جميع إعداداته الافتراضية).<br /><br /></div>
+
+<div dir="rtl">إذا كنت تريد استخدام الواجهة الأمامية phpMussel، فيمكنك تكوين كل شيء من صفحة تكوين الواجهة الأمامية. ولكن، نظرًا لأن الإصدار v3 فصاعدًا، يتم تخزين معلومات تسجيل الدخول للجهة الأمامية في ملف التهيئة، لذلك لتسجيل الدخول إلى الواجهة الأمامية، ستحتاج على الأقل إلى تكوين حساب لاستخدامه لتسجيل الدخول، وبعد ذلك، من هناك، ستتمكن من تسجيل الدخول واستخدام صفحة تكوين الواجهة الأمامية لتكوين كل شيء آخر.<br /><br /></div>
+
+<div dir="rtl">ستضيف المقتطفات أدناه حسابًا جديدًا للواجهة الأمامية باسم المستخدم "admin" وكلمة المرور "password".<br /><br /></div>
+
+<div dir="rtl">لملفات INI:<br /><br /></div>
+```
+[user.admin]
+password='$2y$10$FPF5Im9MELEvF5AYuuRMSO.QKoYVpsiu1YU9aDClgrU57XtLof/dK'
+permissions='1'
+```
+
+<div dir="rtl">لملفات YML:<br /><br /></div>
+```
+user.admin:
+ password: "$2y$10$FPF5Im9MELEvF5AYuuRMSO.QKoYVpsiu1YU9aDClgrU57XtLof/dK"
+ permissions: 1
+```
+
+<div dir="rtl">يمكنك تسمية التكوين الخاص بك ما تريد (طالما تحتفظ بامتدادها، بحيث يعرف phpMussel التنسيق الذي يستخدمه)، ويمكنك تخزينه في أي مكان تريده. يمكنك إخبار phpMussel بمكان العثور على ملف التكوين الخاص بك من خلال توفير مساره عند إنشاء اللودر. إذا لم يتم توفير أي مسار، فسيحاول phpMussel تحديد موقعه ضمن أصل دليل vendor.<br /><br /></div>
+
+<div dir="rtl">في بعض البيئات، مثل Apache، من الممكن وضع نقطة في مقدمة التكوين الخاص بك لإخفائها ومنع الوصول العام.<br /><br /></div>
+
+<div dir="rtl">راجع قسم التكوين في هذا المستند لمزيد من المعلومات حول توجيهات التكوين المتنوعة المتاحة لـ phpMussel.<br /><br /></div>
+
 #### <div dir="rtl">٣.٤ API الماسح</div>
 
 النتائج | وصف
@@ -118,65 +145,14 @@ https://github.com/phpMussel/Examples
 
 <div dir="rtl">أنظر أيضا: <a href="#SCAN_DEBUGGING">كيفية الوصول إلى تفاصيل محددة حول الملفات عند مسحها ضوئيا؟</a><br /></div>
 
----
-
-
-### <div dir="rtl">٤. <a name="SECTION4"></a>إدارة FRONT-END</div>
-
-#### <div dir="rtl">٤.٠ ما هو FRONT-END.<br /><br /></div>
-
-<div dir="rtl">Front-end يوفر وسيلة سهلة للحفاظ على، وإدارة، وتحديث phpMussel. يمكنك عرض، حصة، وتحميل ملفات الدخول، يمكنك تعديل تكوين، يمكنك تثبيت وإلغاء تثبيت مكونات، ويمكنك تحميل وتنزيل وتعديل الملفات.<br /><br /></div>
-
-<div dir="rtl">Front-end معطل في البداية، لمنع الوصول غير المصرح به (الدخول غير المصرح به قد يكون له عواقب أمنية كبيرة). تعليمات لتمكينه أدناه.<br /><br /></div>
-
-#### <div dir="rtl">٤.١ كيفية تمكين FRONT-END.<br /><br /></div>
-
-<div dir="rtl">١. العثور <code dir="ltr">"disable_frontend"</code> من في <code dir="ltr">"config.ini"</code>، وتعيينها إلى false (القيمة القياسية هي true).<br /><br /></div>
-
-<div dir="rtl">٢. الوصول إلى <code dir="ltr">"loader.php"</code> من المتصفح (مثلا، <code dir="ltr">"http://localhost/phpmussel/loader.php"</code>).<br /><br /></div>
-
-<div dir="rtl">٣. تسجيل الدخول باستخدام اسم المستخدم وكلمة المرور الافتراضية (admin/password).<br /><br /></div>
-
-<div dir="rtl">ملحوظة: تغيير اسم المستخدم وكلمة المرور الخاصة بك بعد تسجيل الدخول للمرة الأولى، من أجل منع الوصول غير المصرح به (هذا مهم جدا)!<br /><br /></div>
-
-<div dir="rtl">أيضًا، للحصول على الأمان الأمثل، نوصي بشدة بتمكين 2FA لجميع حسابات الواجهة الأمامية (الإرشادات الواردة أدناه).<br /><br /></div>
-
-#### <div dir="rtl">٤.٢ كيفية استخدام FRONT-END.<br /><br /></div>
-
-<div dir="rtl">في كل صفحة، ويفسر ذلك كيفية استخدامها. إذا كنت بحاجة إلى أي مساعدة، يرجى الاتصال بالدعم. وهناك أيضا بعض مقاطع الفيديو المفيدة المتاحة على موقع يوتيوب.<br /><br /></div>
-
-#### <div dir="rtl">٤.٣ 2FA<br /><br /></div>
+#### <div dir="rtl">٣.٥ 2FA<br /><br /></div>
 
 <div dir="rtl">من الممكن جعل front-end أكثر أمانًا عن طريق تمكين 2FA. عند تسجيل الدخول إلى حساب باستخدام 2FA، يتم إرسال بريد إلكتروني إلى عنوان البريد الإلكتروني المقترن بهذا الحساب. تحتوي هذه الرسالة الإلكترونية على "رمز 2FA"، والذي يجب على المستخدم إدخاله، بالإضافة إلى اسم المستخدم وكلمة المرور، حتى تتمكن من تسجيل الدخول باستخدام هذا الحساب. وهذا يعني أن الحصول على كلمة مرور الحساب لن يكون كافيًا لأي متسلل أو مهاجم محتمل ليتمكن من تسجيل الدخول إلى هذا الحساب، لأنهم سيحتاجون أيضًا إلى الوصول بالفعل إلى عنوان البريد الإلكتروني المرتبط بهذا الحساب حتى يتمكنوا من تلقي رمز 2FA واستخدامه في الجلسة.<br /><br /></div>
 
-<div dir="rtl">أولاً، لتمكين 2FA، استخدم صفحة تحديثات front-end لتثبيت مكون PHPMailer. phpMussel يستخدم PHPMailer لإرسال رسائل البريد الإلكتروني. ملحوظة: على الرغم من أن phpMussel متوافق مع <code dir="ltr">PHP &gt;= 5.4.0</code>، PHPMailer يتطلب <code dir="ltr">PHP &gt;= 5.5.0</code>، مما يعني أن تمكين 2FA لـ phpMussel front-end لن يكون ممكنًا لمستخدمي <code dir="ltr">PHP 5.4</code>.<br /><br /></div>
-
 <div dir="rtl">بعد تثبيت PHPMailer، ستحتاج إلى تعبئة توجيهات التهيئة لـ PHPMailer عبر صفحة تهيئة phpMussel أو ملف التكوين. يتم تضمين مزيد من المعلومات حول توجيهات التكوين هذه في قسم التكوين في هذا المستند. بعد ملء توجيهات تهيئة PHPMailer، اضبط <code dir="ltr">enable_two_factor</code> على <code dir="ltr">true</code>. 2FA ممكّن الآن.<br /><br /></div>
 
 <div dir="rtl">بعد ذلك، ستحتاج إلى ربط عنوان بريد إلكتروني بحساب، حتى يعرف phpMussel مكان إرسال رموز 2FA عند تسجيل الدخول باستخدام هذا الحساب. للقيام بذلك، استخدم عنوان البريد الإلكتروني كاسم مستخدم للحساب (مثل <code dir="ltr">[email protected]</code>)، أو تضمين عنوان البريد الإلكتروني كجزء من اسم المستخدم بالطريقة نفسها التي تريدها عند إرسال بريد إلكتروني بشكل طبيعي (مثل <code dir="ltr">Foo Bar &lt;[email protected]&gt;</code>).<br /><br /></div>
 
-<div dir="rtl">ملحوظة: حماية "vault" ضد الوصول غير المصرح به (على سبيل المثال، من خلال تعزيز أمن الخادم الخاص بك وتقييد أذونات الوصول العام)، أهمية خاصة هنا، لأن الوصول غير المصرح به إلى ملف التكوين الخاص بك (المخزن في "vault")، قد يؤدي إلى تعريض إعدادات SMTP الصادرة (بما في ذلك اسم مستخدم وكلمة مرور SMTP). يجب التأكد من تأمين "vault" بشكل صحيح قبل تمكين 2FA. إذا كنت غير قادر على القيام بذلك، فعلى الأقل، يجب عليك إنشاء حساب بريد إلكتروني جديد مخصص لهذا الغرض، وذلك لتقليل المخاطر المرتبطة بإعدادات SMTP المكشوفة.<br /><br /></div>
-
----
-
-
-### <div dir="rtl">٥. <a name="SECTION5"></a>CLI (واجهة سطر الأوامر).</div>
-
-<div dir="rtl">يمكن تشغيل phpMussel باعتباره برنامج فحص ملفات تفاعلي في وضع CLI في ظل النظم المستندة إلى Windows. راجع قسم "كيفية التثبيت (لواجهة سطر الاوامر)" من هذا الملف التمهيدي لمزيد من التفاصيل.<br /><br /></div>
-
-<div dir="rtl">للحصول على قائمة الأوامر المتاحة لواجهة سطر الأوامر، اكتب "c" في موجه واجهة سطر الأوامر واضغط "دخول" Enter.<br /><br /></div>
-
-<div dir="rtl">بالإضافة إلى، للراغبين، فيديو تعليمي عن كيفية استخدام phpMussel في وضع CLI متوفر هنا:</div>
-- <https://youtu.be/H-Pa740-utc>
-
----
-
-
-### <div dir="rtl">٦. <a name="SECTION6"></a>الملفات الموجودة في هذه الحزمة</div>
-
-```
-```
-
 ---