Skip to content

Commit 3b91b58

Browse files
MaikuolanMaikuolan
committed
Progress towards v3 (~4.0).
1 parent a576d14 commit 3b91b58

16 files changed

+251
-163
lines changed

‎readme.ar.md

Lines changed: 21 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -301,7 +301,7 @@ unset($Web, $FrontEnd, $Scanner, $Loader);
301301

302302
![لقطة شاشة](https://raw.githubusercontent.com/phpMussel/extras/master/screenshots/frontend-v3.0.0-alpha2.png)
303303

304-
#### <div dir="rtl">٣.٧ API الماسح</div>
304+
#### <div dir="rtl">٣.٥ API الماسح</div>
305305

306306
<div dir="rtl">يمكنك أيضًا استخدام واجهة برمجة تطبيقات الماسح الضوئي phpMussel في البرامج النصية والبرامج النصية الأخرى، إذا كنت ترغب في ذلك.<br /><br /></div>
307307

@@ -393,7 +393,7 @@ Detected phpMussel-Testfile.ASCII.Standard (ascii_standard_testfile.txt)! Detect
393393

394394
<div dir="rtl">أنظر أيضا: <a href="#SCAN_DEBUGGING">كيفية الوصول إلى تفاصيل محددة حول الملفات عند مسحها ضوئيا؟</a><br /></div>
395395

396-
#### <div dir="rtl">٣.٥ 2FA<br /><br /></div>
396+
#### <div dir="rtl">٣.٦ 2FA<br /><br /></div>
397397

398398
<div dir="rtl">من الممكن جعل front-end أكثر أمانًا عن طريق تمكين 2FA. عند تسجيل الدخول إلى حساب باستخدام 2FA، يتم إرسال بريد إلكتروني إلى عنوان البريد الإلكتروني المقترن بهذا الحساب. تحتوي هذه الرسالة الإلكترونية على "رمز 2FA"، والذي يجب على المستخدم إدخاله، بالإضافة إلى اسم المستخدم وكلمة المرور، حتى تتمكن من تسجيل الدخول باستخدام هذا الحساب. وهذا يعني أن الحصول على كلمة مرور الحساب لن يكون كافيًا لأي متسلل أو مهاجم محتمل ليتمكن من تسجيل الدخول إلى هذا الحساب، لأنهم سيحتاجون أيضًا إلى الوصول بالفعل إلى عنوان البريد الإلكتروني المرتبط بهذا الحساب حتى يتمكنوا من تلقي رمز 2FA واستخدامه في الجلسة.<br /><br /></div>
399399

@@ -406,12 +406,26 @@ Detected phpMussel-Testfile.ASCII.Standard (ascii_standard_testfile.txt)! Detect
406406

407407
### <div dir="rtl">٤. <a name="SECTION4"></a>تمديد PHPMUSSEL</div>
408408

409+
<div dir="rtl">تم تصميم phpMussel مع وضع القابلية للتوسعة في الاعتبار. نرحب دائمًا <a href="https://github.com/phpMussel/.github/blob/master/CONTRIBUTING.md">بالمساهمات</a> في أي من مستودعات منظمة phpMussel. من الممكن أيضًا تعديل أو توسيع phpMussel وفقًا لاحتياجاتك الفريدة، إذا كنت ترغب في ذلك (على سبيل المثال، بالنسبة للتعديلات أو الإضافات الخاصة بتنفيذك الخاص، والتي لا يمكن نشرها بسبب متطلبات السرية أو الخصوصية في مؤسستك، أو التي قد يُنصح بنشرها في مستودعها الخاص، مثل الإضافات وحزم Composer الجديدة التي تتطلب phpMussel).<br /><br /></div>
410+
411+
<div dir="rtl"><br /><br /></div>
412+
Since v3, all phpMussel functionality exists as classes, which means that in some cases, the [object inheritance](https://www.php.net/manual/en/language.oop5.inheritance.php) mechanisms provided by PHP could be an easy and appropriate way to extend phpMussel.
413+
414+
<div dir="rtl"><br /><br /></div>
415+
phpMussel also provides its own mechanisms for extensibility. Prior to v3, the preferred mechanism was the integrated plugin system for phpMussel. Since v3, the preferred mechanism is the events orchestrator.
416+
417+
<div dir="rtl"><br /><br /></div>
418+
Boilerplate code for extending phpMussel and for writing new plugins is publicly available at the [boilerplates repository](https://github.com/phpMussel/plugin-boilerplates). Included also is a list of all [currently supported events](https://github.com/phpMussel/plugin-boilerplates/tree/master/boilerplate-v3#currently-supported-events) and more detailed instructions regarding how to use the boilerplate code.
419+
420+
<div dir="rtl"><br /><br /></div>
421+
You'll notice that the structure of the v3 boilerplate code is identical to the structure of the various phpMussel v3 repositories at the phpMussel organisation. That is not a coincidence. Whenever possible, I would recommend utilising the v3 boilerplate code for extensibility purposes, and utilising similar design principles to that of phpMussel v3 itself. If you choose to publicise your new extension or plugin, you can integrate Composer support for it, and it should then be theoretically possible for others to utilise your extension or plugin in the exact same way as phpMussel v3 itself, simply requiring it in along with their other Composer dependencies, and applying any necessary event handlers at their implementation. (Of course, don't forget to include instructions with your publications, so that others will know about any necessary event handlers that may exist, and any other information which may be necessary for correct installation and utilisation of your publication).
422+
409423
---
410424

411425

412426
### <div dir="rtl">٧. <a name="SECTION7"></a>خيارات التكوين/التهيئة</div>
413427

414-
<div dir="rtl">وفيما يلي قائمة من المتغيرات الموجودة في ملف تكوين "config.ini"، بالإضافة إلى وصف الغرض منه و وظيفته.<br /><br /></div>
428+
<div dir="rtl">فيما يلي قائمة بتوجيهات التكوين المقبولة من قبل phpMussel، بالإضافة إلى وصف الغرض منه و وظيفته.<br /><br /></div>
415429

416430
```
417431
التكوين (v3)
@@ -1189,10 +1203,6 @@ smtp_secure
11891203

11901204
### <div dir="rtl">٩. <a name="SECTION9"></a>مشاكل التوافق المعروفة</div>
11911205

1192-
#### <div dir="rtl">PHP و PCRE</div>
1193-
1194-
<div dir="rtl">phpMussel يتطلب PHP و PCRE لتنفيذ وظيفته بشكل صحيح و بدون أحدهما أو كلاهما فإن البرنامج لن يعمل بشكل صحيح. تأكد من أن نظامك يمتلك كلا من PHP و PCRE مثبتين و متاحين قبل أن تقوم بتنزيل و تثبيت phpMussel.<br /><br /></div>
1195-
11961206
#### <div dir="rtl">التوافق البرمجي لبرنامج مكافحة الفيروسات</div>
11971207

11981208
<div dir="rtl">من المعروف أن مشاكل التوافق بين phpMussel وبعض بائعي برامج مكافحة الفيروسات تحدث في بعض الأحيان في الماضي، لذلك كل بضعة أشهر، أتحقق من أحدث الإصدارات المتاحة من قاعدة بيانات phpMussel ضد Virus Total، لمعرفة ما إذا كانت هناك أية مشكلات تم الإبلاغ عنها هناك. عندما يتم الإبلاغ عن المشكلات هناك، سأذكر المشاكل هنا في الوثائق.<br /><br /></div>
@@ -1201,6 +1211,8 @@ smtp_secure
12011211

12021212
<div dir="rtl">لا أتحقق من ملفات التوقيع أو الوثائق أو أي محتوى محيطي آخر. تسبب ملفات التوقيع دائمًا بعض الإيجابيات الخاطئة عندما تكتشفها حلول مكافحة الفيروسات الأخرى. لذلك أوصي بشدة، إذا كنت تخطط لتثبيت phpMussel على جهاز يوجد به بالفعل حل آخر لمكافحة الفيروسات، لإدراج ملفات توقيع phpMussel في القائمة البيضاء.<br /><br /></div>
12031213

1214+
<div dir="rtl"><em>انظر أيضا: <a href="https://maikuolan.github.io/Compatibility-Charts/">مخططات التوافق</a>.</em><br /><br /></div>
1215+
12041216
---
12051217

12061218

@@ -1627,7 +1639,7 @@ Sun, 19 Jul 2020 13:33:31 +0800 انتهى.
16271639
الحجر الصحي بأنه "<code dir="ltr">1595142388-2e017ea9ac1478e45dc15794a1fc18c0.qfu</code>".
16281640
</pre>
16291641

1630-
<div dir="rtl">تتضمن معلومات حول التحميلات المحظورة عادةً ما يلي:<br /></div>
1642+
<div dir="rtl">عادةً ما تتضمن إدخالات السجل هذه المعلومات التالية:<br /></div>
16311643
<div dir="rtl"><ul>
16321644
<li>التاريخ والوقت الذي تم حظر التحميل فيه.</li>
16331645
<li>عنوان IP الذي نشأ فيه التحميل.</li>
@@ -1716,11 +1728,6 @@ x.x.x.x - Day, dd Mon 20xx hh:ii:ss +0000 - "admin" - حاليا على.
17161728

17171729
<div dir="rtl">عندما يسجل المستخدم بنجاح في الواجهة الأمامية، يعين phpMussel <a href="https://ar.wikipedia.org/wiki/%D9%85%D9%84%D9%81_%D8%AA%D8%B9%D8%B1%D9%8A%D9%81_%D8%A7%D8%B1%D8%AA%D8%A8%D8%A7%D8%B7">ملف تعريف ارتباط</a> حتى يتمكن من تذكر المستخدم للطلبات اللاحقة (أي، يتم استخدام ملفات تعريف الارتباط لمصادقة المستخدم على جلسة تسجيل الدخول). في صفحة تسجيل الدخول، يتم عرض تحذير ملف تعريف ارتباط بشكل بارز، ويحذر المستخدم من أنه سيتم تعيين ملف تعريف ارتباط إذا شارك في الإجراء ذي الصلة. لا يتم تعيين ملفات تعريف الارتباط في أي نقاط أخرى في مصدر التعليمات البرمجية.<br /><br /></div>
17181730

1719-
<div dir="rtl">خيارات التكوين ذات الصلة:<br /></div>
1720-
<div dir="rtl"><ul>
1721-
<li><code dir="ltr">disable_frontend</code> &lt;- <code dir="ltr">general</code></li>
1722-
</ul></div>
1723-
17241731
#### <div dir="rtl">١١.٥ التسويق والإعلان<br /><br /></div>
17251732

17261733
<div dir="rtl">لا تجمع phpMussel أو تعالج أي معلومات لأغراض التسويق أو الإعلانات، ولا تبيع أو تحقق أرباحًا من أي معلومات تم جمعها أو تسجيلها. phpMussel ليست مؤسسة تجارية، ولا ترتبط بأي مصالح تجارية، لذا فإن القيام بهذه الأشياء لن يكون له أي معنى. كان هذا هو الحال منذ بداية المشروع، وما زالت الحالة اليوم. بالإضافة إلى ذلك، فإن القيام بهذه الأشياء سيؤدي إلى نتائج عكسية للمشروع والغرض المقصود من المشروع ككل، وطالما استمر في الحفاظ على المشروع، لن يحدث أبداً.<br /><br /></div>
@@ -1754,4 +1761,4 @@ x.x.x.x - Day, dd Mon 20xx hh:ii:ss +0000 - "admin" - حاليا على.
17541761
---
17551762

17561763

1757-
<div dir="rtl">آخر تحديث: 21 يوليو 2020 (2020.07.21).</div>
1764+
<div dir="rtl">آخر تحديث: 2 يوليو 2020 (2020.08.02).</div>

‎readme.de.md

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -402,12 +402,22 @@ Nächster, müssen Sie eine E-Mail-Adresse mit einem Konto verknüpfen, damit ph
402402

403403
### 4. <a name="SECTION4"></a>ERWEITERUNG VON PHPMUSSEL
404404

405+
phpMussel wurde unter Berücksichtigung der Erweiterbarkeit entwickelt. Pull-Anfragen an eines der Repositories der phpMussel-Organisation und [Beiträge](https://github.com/phpMussel/.github/blob/master/CONTRIBUTING.md) im Allgemeinen sind immer willkommen. phpMussel kann auch für Ihre eigenen individuellen Bedürfnisse geändert oder erweitert werden wenn Sie wünschen (z.B., für Änderungen oder Erweiterungen, die für Ihre Implementierung spezifisch sind, und die aufgrund von Vertraulichkeits oder Datenschutzanforderungen in Ihrem Unternehmen nicht veröffentlicht werden können, oder für die vorzugsweise in ihrem eigenen Repository veröffentlicht werden könnten, zum Beispiel für Plugins und neue Composer-Pakete für die phpMussel erforderlich ist).
406+
407+
Since v3, all phpMussel functionality exists as classes, which means that in some cases, the [object inheritance](https://www.php.net/manual/en/language.oop5.inheritance.php) mechanisms provided by PHP could be an easy and appropriate way to extend phpMussel.
408+
409+
phpMussel also provides its own mechanisms for extensibility. Prior to v3, the preferred mechanism was the integrated plugin system for phpMussel. Since v3, the preferred mechanism is the events orchestrator.
410+
411+
Boilerplate code for extending phpMussel and for writing new plugins is publicly available at the [boilerplates repository](https://github.com/phpMussel/plugin-boilerplates). Included also is a list of all [currently supported events](https://github.com/phpMussel/plugin-boilerplates/tree/master/boilerplate-v3#currently-supported-events) and more detailed instructions regarding how to use the boilerplate code.
412+
413+
You'll notice that the structure of the v3 boilerplate code is identical to the structure of the various phpMussel v3 repositories at the phpMussel organisation. That is not a coincidence. Whenever possible, I would recommend utilising the v3 boilerplate code for extensibility purposes, and utilising similar design principles to that of phpMussel v3 itself. If you choose to publicise your new extension or plugin, you can integrate Composer support for it, and it should then be theoretically possible for others to utilise your extension or plugin in the exact same way as phpMussel v3 itself, simply requiring it in along with their other Composer dependencies, and applying any necessary event handlers at their implementation. (Of course, don't forget to include instructions with your publications, so that others will know about any necessary event handlers that may exist, and any other information which may be necessary for correct installation and utilisation of your publication).
414+
405415
---
406416

407417

408418
### 7. <a name="SECTION7"></a>EINSTELLUNGEN
409419

410-
Nachfolgend finden Sie eine Liste der Variablen in der Konfigurationsdatei `config.ini` mit einer kurzen Beschreibung ihrer Funktionen.
420+
Das Folgende ist eine Liste der Konfigurationsanweisungen die von phpMussel akzeptiert werden mit einer kurzen Beschreibung ihrer Funktionen.
411421

412422
```
413423
Konfiguration (v3)
@@ -1180,9 +1190,6 @@ Jede Form von regulären Ausdrücken, die von PHP verstanden und korrekt ausgef
11801190

11811191
### 9. <a name="SECTION9"></a>BEKANNTE KOMPATIBILITÄTSPROBLEME
11821192

1183-
#### PHP und PCRE
1184-
- phpMussel benötigt PHP und PCRE, um ausgeführt werden zu können. Ohne PHP und ohne die PCRE-Erweiterungen von PHP, kann phpMussel nicht oder nicht ordnungsgemäß ausgeführt werden. Stellen Sie sicher, dass auf Ihrem System PHP und PCRE installiert und verfügbar ist, bevor Sie phpMussel herunterladen und installieren.
1185-
11861193
#### KOMPATIBILITÄT ZU ANTIVIREN-SOFTWARE
11871194

11881195
Kompatibilitätsprobleme zwischen phpMussel und einigen Antiviren-Anbietern sind in der Vergangenheit aufgetreten, daher überprüfe ich etwa alle paar Monate die aktuellsten verfügbaren Versionen der phpMussel-Codebasis auf Virus Total, um festzustellen, ob dort Probleme gemeldet werden. Wenn dort Probleme gemeldet werden, ich liste die gemeldeten Probleme hier in der Dokumentation.
@@ -1191,6 +1198,8 @@ Bei meiner letzten Überprüfung (2019.10.10) wurden keine Probleme gemeldet.
11911198

11921199
Ich überprüfe keine Signaturdateien, Dokumentationen oder sonstigen peripheren Inhalte. Die Signaturdateien verursachen immer einige Fehlalarme, wenn andere Antiviren-Lösungen sie erkennen. Ich würde daher dringend empfehlen, wenn Sie phpMussel auf einem Computer installieren möchten, auf dem bereits eine andere Antiviren-Lösung vorhanden ist, die phpMussel-Signaturdateien auf eine Whitelist zu setzen.
11931200

1201+
*Siehe auch: [Kompatibilitätstabellen](https://maikuolan.github.io/Compatibility-Charts/).*
1202+
11941203
---
11951204

11961205

@@ -1614,7 +1623,7 @@ dcacac499064454218823fbabff7e09b5b011c0c877ee6f215f35bffb195b6e9:654:ascii_stand
16141623
Als „1595142388-2e017ea9ac1478e45dc15794a1fc18c0.qfu“ unter Quarantäne gestellt.
16151624
```
16161625

1617-
Ein "scan kills"-Eintrag enthält normalerweise die folgenden Informationen:
1626+
Diese Protokolleinträge enthalten normalerweise die folgenden Informationen:
16181627
- Das Datum und die Uhrzeit, zu der der Upload gesperrt wurde.
16191628
- Die IP-Adresse, von der der Upload stammt.
16201629
- Der Grund, warum die Datei blockiert wurde (was entdeckt wurde).
@@ -1688,9 +1697,6 @@ phpMussel verwendet keine [Kryptografie](https://de.wikipedia.org/wiki/Kryptogra
16881697

16891698
Wenn sich ein Benutzer erfolgreich am Frontend eingeloggt, phpMussel setzt eine einen [Cookie](https://de.wikipedia.org/wiki/HTTP-Cookie), um sich den Benutzer für nachfolgende Anfragen merken zu können (d.h., Cookies dienen zur Authentifizierung des Benutzers bei einer Einloggen-Sitzung). Auf der Einloggen-Seite wird eine Cookie-Warnung angezeigt, die den Benutzer warnen, dass ein Cookie gesetzt wird, wenn er die relevante Aktion ausführt. An anderen Stellen in der Codebasis werden keine Cookies gesetzt.
16901699

1691-
*Relevante Konfigurationsdirektiven:*
1692-
- `general` -> `disable_frontend`
1693-
16941700
#### 11.5 VERMARKTUNG UND WERBUNG
16951701

16961702
phpMussel sammelt und verarbeitet keine Informationen für der Zweck des Vermarktung oder Werbung, und weder verkauft noch profitiert von gesammelten oder protokolliert Informationen. phpMussel ist kein kommerzielles Unternehmen, noch bezieht es sich auf irgendwelche kommerziellen Interessen, daher macht es keinen Sinn, diese Dinge zu tun. Dies ist seit Beginn des Projekts der Fall und ist auch heute noch der Fall. Außerdem, diese Dinge wären kontraproduktiv für den Geist und den beabsichtigten Zweck des gesamten Projekts, und so lange ich das Projekt weiterführen, wird nie passieren.
@@ -1724,4 +1730,4 @@ Alternativ gibt es einen kurzen (nicht autoritativen) Überblick über die GDPR/
17241730
---
17251731

17261732

1727-
Zuletzt aktualisiert: 21 Juli 2020 (2020.07.21).
1733+
Zuletzt aktualisiert: 2 Juli 2020 (2020.08.02).

0 commit comments

Comments
 (0)