Skip to content

Commit a5dc79c

Browse files
committed
New feature: Trigger notifications (CIDRAM/CIDRAM#231).
Changelog excerpt: - A new option has been added to the auxiliary rules system, allowing trigger notifications to be sent to a configured email address.
1 parent f3926d2 commit a5dc79c

16 files changed

Lines changed: 251 additions & 27 deletions

readme.ar.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -203,6 +203,8 @@ $CIDRAM->view();
203203
│ disabled_channels [string]
204204
│ default_timeout [int]
205205
│ sensitive [string]
206+
│ email_notification_address [string]
207+
│ email_notification_name [string]
206208
├───components
207209
│ ipv4 [string]
208210
│ ipv6 [string]
@@ -547,6 +549,8 @@ lang
547549
├─ar ("العربية")
548550
├─bg ("Български")
549551
├─bn ("বাংলা")
552+
├─bs ("Bosanski")
553+
├─ca ("Català")
550554
├─cs ("Čeština")
551555
├─de ("Deutsch")
552556
├─en ("English (AU/GB/NZ)")
@@ -555,8 +559,11 @@ lang
555559
├─es ("Español")
556560
├─fa ("فارسی")
557561
├─fr ("Français")
562+
├─gl ("Galego")
563+
├─gu ("ગુજરાતી")
558564
├─he ("עברית")
559565
├─hi ("हिंदी")
566+
├─hr ("Hrvatski")
560567
├─id ("Bahasa Indonesia")
561568
├─it ("Italiano")
562569
├─ja ("日本語")
@@ -572,6 +579,7 @@ lang
572579
├─ro ("Română")
573580
├─ru ("Русский")
574581
├─sv ("Svenska")
582+
├─sr ("Српски")
575583
├─ta ("தமிழ்")
576584
├─th ("ภาษาไทย")
577585
├─tr ("Türkçe")
@@ -738,6 +746,12 @@ disabled_channels
738746
##### <div dir="rtl">"sensitive" <code dir="ltr">[string]</code><br /></div>
739747
<div dir="rtl"><ul><li>قائمة المسارات التي يجب اعتبارها صفحات حساسة. ستتم مقارنة كل مسار مدرج مع URI المعاد بناؤه عند الحاجة. سيتم التعامل مع المسار الذي يبدأ بشرطة مائلة للأمام على أنه حرفي، ويتم مطابقته من مكون المسار للطلب فصاعدًا. سيتم التعامل مع المسار الذي يبدأ بحرف غير أبجدي رقمي وينتهي بنفس الحرف (أو نفس الحرف بالإضافة إلى علامة اختيارية "i") كتعبير عادي. سيتم التعامل مع أي نوع آخر من المسارات على أنه حرفي، ويمكن أن يتطابق مع أي جزء من URI. قد يؤثر المسار الذي يتم اعتباره صفحة حساسة على كيفية تصرف بعض الوحدات، ولكن ليس له أي تأثير آخر.</li></ul></div>
740748

749+
##### <div dir="rtl">"email_notification_address" <code dir="ltr">[string]</code><br /></div>
750+
<div dir="rtl"><ul><li>إذا اخترت تلقي الإشعارات من CIDRAM عبر البريد الإلكتروني، على سبيل المثال، عند تفعيل قواعد مساعدة محددة، يمكنك تحديد عنوان المستلم لهذه الإشعارات هنا.</li></ul></div>
751+
752+
##### <div dir="rtl">"email_notification_name" <code dir="ltr">[string]</code><br /></div>
753+
<div dir="rtl"><ul><li>إذا اخترت تلقي الإشعارات من CIDRAM عبر البريد الإلكتروني، على سبيل المثال، عند تفعيل قواعد مساعدة محددة، يمكنك تحديد اسم المستلم لتلك الإشعارات هنا.</li></ul></div>
754+
741755
#### <div dir="rtl">"components" (التصنيف)<br /></div>
742756
<div dir="rtl">التكوين لتنشيط وتعطيل المكونات المستخدمة من قبل CIDRAM. عادةً ما يتم ملؤها بواسطة صفحة التحديثات، ولكن يمكن أيضًا إدارتها من هنا لتحكم أفضل وللمكونات المخصصة التي لا تتعرف عليها صفحة التحديثات.<br /><br /></div>
743757

@@ -2352,4 +2366,4 @@ x.x.x.x - Day, dd Mon 20xx hh:ii:ss +0000 - "admin" - حاليا على.
23522366
---
23532367

23542368

2355-
<div dir="rtl">آخر تحديث: ٢٨ يناير ٢٠٢٤ (٢٠٢٤.٠١.٢٨).</div>
2369+
<div dir="rtl">آخر تحديث: ٢١ أبريل ٢٠٢٤ (٢٠٢٤.٠٤.٢١).</div>

readme.de.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -197,6 +197,8 @@ Konfiguration (v3)
197197
│ disabled_channels [string]
198198
│ default_timeout [int]
199199
│ sensitive [string]
200+
│ email_notification_address [string]
201+
│ email_notification_name [string]
200202
├───components
201203
│ ipv4 [string]
202204
│ ipv6 [string]
@@ -532,6 +534,8 @@ lang
532534
├─ar ("العربية")
533535
├─bg ("Български")
534536
├─bn ("বাংলা")
537+
├─bs ("Bosanski")
538+
├─ca ("Català")
535539
├─cs ("Čeština")
536540
├─de ("Deutsch")
537541
├─en ("English (AU/GB/NZ)")
@@ -540,8 +544,11 @@ lang
540544
├─es ("Español")
541545
├─fa ("فارسی")
542546
├─fr ("Français")
547+
├─gl ("Galego")
548+
├─gu ("ગુજરાતી")
543549
├─he ("עברית")
544550
├─hi ("हिंदी")
551+
├─hr ("Hrvatski")
545552
├─id ("Bahasa Indonesia")
546553
├─it ("Italiano")
547554
├─ja ("日本語")
@@ -557,6 +564,7 @@ lang
557564
├─ro ("Română")
558565
├─ru ("Русский")
559566
├─sv ("Svenska")
567+
├─sr ("Српски")
560568
├─ta ("தமிழ்")
561569
├─th ("ภาษาไทย")
562570
├─tr ("Türkçe")
@@ -719,6 +727,12 @@ disabled_channels
719727
##### „sensitive“ `[string]`
720728
- Eine Liste von Pfaden die als vertrauliche Seiten betrachtet werden sollen. Jeder aufgelistete Pfad wird bei Bedarf mit dem rekonstruierten URI verglichen. Ein Pfad, der mit einem Schrägstrich beginnt, wird als Literal behandelt und ab der Pfadkomponente der Anforderung abgeglichen. Andernfalls wird ein Pfad, der mit einem nicht alphanumerischen Zeichen beginnt, und mit demselben Zeichen (oder demselben Zeichen plus einem optionalen „i“-Flag) endet, als regulärer Ausdruck behandelt. Jede andere Art von Pfad wird als Literal behandelt, und kann mit jedem Teil des URI abgeglichen. Ob ein Pfad als sensible Seite betrachtet wird, kann sich auf das Verhalten einiger Module auswirken, aber hat ansonsten keine Auswirkungen.
721729

730+
##### „email_notification_address“ `[string]`
731+
- Wenn Sie Benachrichtigungen von CIDRAM per E-Mail wünschen, z.B., wenn bestimmte Hilfsregeln ausgelöst werden, hier können Sie die Empfängeradresse für diese Benachrichtigungen angeben.
732+
733+
##### „email_notification_name“ `[string]`
734+
- Wenn Sie Benachrichtigungen von CIDRAM per E-Mail wünschen, z.B., wenn bestimmte Hilfsregeln ausgelöst werden, hier können Sie den Empfängernamen für diese Benachrichtigungen angeben.
735+
722736
#### „components“ (Kategorie)
723737
Konfiguration zur Aktivierung und Deaktivierung der von CIDRAM verwendeten Komponenten. Wird normalerweise von der Update-Seite ausgefüllt, aber kann auch von hier aus verwaltet werden, um eine genauere Kontrolle zu haben und für benutzerdefinierte Komponenten die von der Update-Seite nicht erkannt werden.
724738

@@ -2302,4 +2316,4 @@ Detailliertere Informationen werden zu einem späteren Zeitpunkt hier in der Dok
23022316
---
23032317
23042318
2305-
Zuletzt aktualisiert: 28. Januar 2024 (2024.01.28).
2319+
Zuletzt aktualisiert: 21. April 2024 (2024.04.21).

readme.en.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -197,6 +197,8 @@ Configuration (v3)
197197
│ disabled_channels [string]
198198
│ default_timeout [int]
199199
│ sensitive [string]
200+
│ email_notification_address [string]
201+
│ email_notification_name [string]
200202
├───components
201203
│ ipv4 [string]
202204
│ ipv6 [string]
@@ -530,6 +532,8 @@ lang
530532
├─ar ("العربية")
531533
├─bg ("Български")
532534
├─bn ("বাংলা")
535+
├─bs ("Bosanski")
536+
├─ca ("Català")
533537
├─cs ("Čeština")
534538
├─de ("Deutsch")
535539
├─en ("English (AU/GB/NZ)")
@@ -538,8 +542,11 @@ lang
538542
├─es ("Español")
539543
├─fa ("فارسی")
540544
├─fr ("Français")
545+
├─gl ("Galego")
546+
├─gu ("ગુજરાતી")
541547
├─he ("עברית")
542548
├─hi ("हिंदी")
549+
├─hr ("Hrvatski")
543550
├─id ("Bahasa Indonesia")
544551
├─it ("Italiano")
545552
├─ja ("日本語")
@@ -555,6 +562,7 @@ lang
555562
├─ro ("Română")
556563
├─ru ("Русский")
557564
├─sv ("Svenska")
565+
├─sr ("Српски")
558566
├─ta ("தமிழ்")
559567
├─th ("ภาษาไทย")
560568
├─tr ("Türkçe")
@@ -715,6 +723,12 @@ disabled_channels
715723
##### "sensitive" `[string]`
716724
- A list of paths to regard as sensitive pages. Each path listed will be checked against the reconstructed URI when needed. A path which begins with a forward slash will be treated as a literal, and matched from the path component of the request onward. Otherwise, a path which begins with a non-alphanumeric character, and ends with that same character (or that same character plus an optional "i" flag) will be treated as a regular expression. Any other kind of path will be treated as a literal, and can match from any part of the URI. Whether a path is regarded as a sensitive page may affect how some modules behave, but doesn't have any effect otherwise.
717725

726+
##### "email_notification_address" `[string]`
727+
- If you've opted to receive notifications from CIDRAM via email, e.g., when specific auxiliary rules are triggered, you can specify the recipient address for those notifications here.
728+
729+
##### "email_notification_name" `[string]`
730+
- If you've opted to receive notifications from CIDRAM via email, e.g., when specific auxiliary rules are triggered, you can specify the recipient name for those notifications here.
731+
718732
#### "components" (Category)
719733
Configuration for the activation and the deactivation of the components used by CIDRAM. Typically populated by the updates page, but can also be managed from here for finer control and for custom components not recognised by the updates page.
720734

@@ -2285,4 +2299,4 @@ More detailed information will be included here, in the documentation, at an app
22852299
---
22862300
22872301
2288-
Last Updated: 28 January 2024 (2024.01.28).
2302+
Last Updated: 21 April 2024 (2024.04.21).

readme.es.md

Lines changed: 17 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -197,6 +197,8 @@ Configuración (v3)
197197
│ disabled_channels [string]
198198
│ default_timeout [int]
199199
│ sensitive [string]
200+
│ email_notification_address [string]
201+
│ email_notification_name [string]
200202
├───components
201203
│ ipv4 [string]
202204
│ ipv6 [string]
@@ -316,7 +318,7 @@ stages
316318
├─Tracking ("Ejecutar seguimiento de IP")
317319
├─RL ("Ejecutar la limitación de tasa")
318320
├─CAPTCHA ("Desplegar CAPTCHAs (solicitudes bloqueadas)")
319-
├─Reporting ("Ejecutar informes")
321+
├─Reporting ("Ejecutar reportes")
320322
├─Statistics ("Actualizar estadísticas")
321323
├─Webhooks ("Ejecutar webhooks")
322324
├─PrepareFields ("Preparar campos para salida y registros")
@@ -533,6 +535,8 @@ lang
533535
├─ar ("العربية")
534536
├─bg ("Български")
535537
├─bn ("বাংলা")
538+
├─bs ("Bosanski")
539+
├─ca ("Català")
536540
├─cs ("Čeština")
537541
├─de ("Deutsch")
538542
├─en ("English (AU/GB/NZ)")
@@ -541,8 +545,11 @@ lang
541545
├─es ("Español")
542546
├─fa ("فارسی")
543547
├─fr ("Français")
548+
├─gl ("Galego")
549+
├─gu ("ગુજરાતી")
544550
├─he ("עברית")
545551
├─hi ("हिंदी")
552+
├─hr ("Hrvatski")
546553
├─id ("Bahasa Indonesia")
547554
├─it ("Italiano")
548555
├─ja ("日本語")
@@ -558,6 +565,7 @@ lang
558565
├─ro ("Română")
559566
├─ru ("Русский")
560567
├─sv ("Svenska")
568+
├─sr ("Српски")
561569
├─ta ("தமிழ்")
562570
├─th ("ภาษาไทย")
563571
├─tr ("Türkçe")
@@ -721,6 +729,12 @@ disabled_channels
721729
##### "sensitive" `[string]`
722730
- Una lista de rutas para considerar como páginas confidenciales. Cada ruta listada se comparará con el URI reconstruido cuando sea necesario. Una ruta que comienza con una barra inclinada se tratará como un literal, y se comparará desde el componente de ruta de la solicitud en adelante. Alternativamente, una ruta que comienza con un carácter no alfanumérico, y termina con ese mismo carácter (o ese mismo carácter más un indicador "i" opcional) se tratará como una expresión regular. Cualquier otro tipo de ruta se tratará como un literal, y puede coincidir con cualquier parte del URI. Si una ruta se considera una página confidencial puede afectar el comportamiento de algunos módulos, pero no tiene ningún efecto en otros casos.
723731

732+
##### "email_notification_address" `[string]`
733+
- Si ha optado por recibir notificaciones del CIDRAM por correo electrónico, por ejemplo, cuando se activan reglas auxiliares específicas, puede especificar la dirección del destinatario de esas notificaciones aquí.
734+
735+
##### "email_notification_name" `[string]`
736+
- Si ha optado por recibir notificaciones del CIDRAM por correo electrónico, por ejemplo, cuando se activan reglas auxiliares específicas, puede especificar el nombre del destinatario de esas notificaciones aquí.
737+
724738
#### "components" (Categoría)
725739
Configuración para la activación y la desactivación de los componentes utilizados por CIDRAM. Normalmente se administra desde la página de actualizaciones, pero también se puede administrar desde aquí para un control más preciso y para los componentes personalizados que la página de actualizaciones no reconoce.
726740

@@ -758,7 +772,7 @@ Configuración relacionada con el registro (excluyendo lo que es aplicable a otr
758772
- Un archivo para registrar los resultados de cualquier solicitud saliente. Especificar el nombre del archivo, o dejar en blanco para desactivar.
759773

760774
##### "report_log" `[string]`
761-
- Un archivo para registrar cualquier informe enviado a las API externas. Especificar el nombre del archivo, o dejar en blanco para desactivar.
775+
- Un archivo para registrar cualquier reportes enviados a las API externas. Especificar el nombre del archivo, o dejar en blanco para desactivar.
762776

763777
##### "truncate" `[string]`
764778
- ¿Truncar archivos de registro cuando alcanzan cierto tamaño? Valor es el tamaño máximo en B/KB/MB/GB/TB que un archivo de registro puede crecer antes de ser truncado. El valor predeterminado de 0KB deshabilita el truncamiento (archivos de registro pueden crecer indefinidamente). Nota: ¡Se aplica a archivos de registro individuales! El tamaño de los archivos de registro no se considera colectivamente.
@@ -2294,4 +2308,4 @@ Se incluirá información más detallada aquí, en la documentación, en un mome
22942308
---
22952309
22962310
2297-
Última Actualización: 28 de Enero de 2024 (2024.01.28).
2311+
Última Actualización: 21 de Abril de 2024 (2024.04.21).

readme.fr.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -197,6 +197,8 @@ Configuration (v3)
197197
│ disabled_channels [string]
198198
│ default_timeout [int]
199199
│ sensitive [string]
200+
│ email_notification_address [string]
201+
│ email_notification_name [string]
200202
├───components
201203
│ ipv4 [string]
202204
│ ipv6 [string]
@@ -532,6 +534,8 @@ lang
532534
├─ar ("العربية")
533535
├─bg ("Български")
534536
├─bn ("বাংলা")
537+
├─bs ("Bosanski")
538+
├─ca ("Català")
535539
├─cs ("Čeština")
536540
├─de ("Deutsch")
537541
├─en ("English (AU/GB/NZ)")
@@ -540,8 +544,11 @@ lang
540544
├─es ("Español")
541545
├─fa ("فارسی")
542546
├─fr ("Français")
547+
├─gl ("Galego")
548+
├─gu ("ગુજરાતી")
543549
├─he ("עברית")
544550
├─hi ("हिंदी")
551+
├─hr ("Hrvatski")
545552
├─id ("Bahasa Indonesia")
546553
├─it ("Italiano")
547554
├─ja ("日本語")
@@ -557,6 +564,7 @@ lang
557564
├─ro ("Română")
558565
├─ru ("Русский")
559566
├─sv ("Svenska")
567+
├─sr ("Српски")
560568
├─ta ("தமிழ்")
561569
├─th ("ภาษาไทย")
562570
├─tr ("Türkçe")
@@ -719,6 +727,12 @@ disabled_channels
719727
##### « sensitive » `[string]`
720728
- Une liste de chemins à considérer comme des pages sensibles. Chaque chemin listé sera vérifié par rapport à l'URI reconstruit si nécessaire. Un chemin qui commence par une barre oblique sera traité comme un littéral, et mis en correspondance à partir du composant de chemin de la requête. Sinon, un chemin qui commence par un caractère non alphanumérique, et se termine par ce même caractère (ou ce même caractère plus un indicateur « i » facultatif) sera traité comme une expression régulière. Tout autre type de chemin sera traité comme un littéral, et peut correspondre à partir de n'importe quelle partie de l'URI. Le fait qu'un chemin soit considéré comme une page sensible peut affecter le comportement de certains modules, mais n'a aucun effet autrement.
721729

730+
##### « email_notification_address » `[string]`
731+
- Si vous avez choisi de recevoir des notifications de CIDRAM par e-mail, par exemple, lorsque des règles auxiliaires spécifiques sont déclenchées, vous pouvez spécifier ici l'adresse du destinataire de ces notifications.
732+
733+
##### « email_notification_name » `[string]`
734+
- Si vous avez choisi de recevoir des notifications de CIDRAM par e-mail, par exemple, lorsque des règles auxiliaires spécifiques sont déclenchées, vous pouvez spécifier ici le nom du destinataire de ces notifications.
735+
722736
#### « components » (Catégorie)
723737
Configuration pour l'activation et la désactivation des composants utilisés par le CIDRAM. Généralement rempli par la page des mises à jour, mais peut également être géré à partir d'ici pour un contrôle plus précis et pour les composants personnalisés non reconnus par la page des mises à jour.
724738

@@ -2298,4 +2312,4 @@ Des informations plus détaillées seront incluses ici, dans la documentation,
22982312
---
22992313
23002314
2301-
Dernière mise à jour : 28 Janvier 2024 (2024.01.28).
2315+
Dernière mise à jour : 21 Avril 2024 (2024.04.21).

readme.id.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -197,6 +197,8 @@ Konfigurasi (v3)
197197
│ disabled_channels [string]
198198
│ default_timeout [int]
199199
│ sensitive [string]
200+
│ email_notification_address [string]
201+
│ email_notification_name [string]
200202
├───components
201203
│ ipv4 [string]
202204
│ ipv6 [string]
@@ -532,6 +534,8 @@ lang
532534
├─ar ("العربية")
533535
├─bg ("Български")
534536
├─bn ("বাংলা")
537+
├─bs ("Bosanski")
538+
├─ca ("Català")
535539
├─cs ("Čeština")
536540
├─de ("Deutsch")
537541
├─en ("English (AU/GB/NZ)")
@@ -540,8 +544,11 @@ lang
540544
├─es ("Español")
541545
├─fa ("فارسی")
542546
├─fr ("Français")
547+
├─gl ("Galego")
548+
├─gu ("ગુજરાતી")
543549
├─he ("עברית")
544550
├─hi ("हिंदी")
551+
├─hr ("Hrvatski")
545552
├─id ("Bahasa Indonesia")
546553
├─it ("Italiano")
547554
├─ja ("日本語")
@@ -557,6 +564,7 @@ lang
557564
├─ro ("Română")
558565
├─ru ("Русский")
559566
├─sv ("Svenska")
567+
├─sr ("Српски")
560568
├─ta ("தமிழ்")
561569
├─th ("ภาษาไทย")
562570
├─tr ("Türkçe")
@@ -719,6 +727,12 @@ disabled_channels
719727
##### "sensitive" `[string]`
720728
- Daftar jalur yang dianggap sebagai halaman sensitif. Setiap jalur yang terdaftar akan diperiksa terhadap URI yang direkonstruksi bila diperlukan. Jalur yang dimulai dengan garis miring ke depan akan diperlakukan sebagai literal, dan dicocokkan dari komponen jalur permintaan selanjutnya. Jika tidak, jalur yang dimulai dengan karakter non-alfanumerik, dan diakhiri dengan karakter yang sama (atau karakter yang sama ditambah tanda "i" opsional) akan diperlakukan sebagai ekspresi reguler. Jenis jalur lain apapun akan diperlakukan sebagai literal, dan dapat dicocokkan dari bagian manapun dari URI. Apakah jalur dianggap sebagai halaman sensitif dapat memengaruhi perilaku beberapa modul, tetapi sebaliknya tidak berpengaruh apapun.
721729

730+
##### "email_notification_address" `[string]`
731+
- Jika Anda memilih untuk menerima notifikasi dari CIDRAM melalui email, misalnya, ketika aturan tambahan tertentu dipicu, Anda dapat menentukan alamat penerima notifikasi tersebut disini.
732+
733+
##### "email_notification_name" `[string]`
734+
- Jika Anda memilih untuk menerima notifikasi dari CIDRAM melalui email, misalnya, ketika aturan tambahan tertentu dipicu, Anda dapat menentukan nama penerima notifikasi tersebut disini.
735+
722736
#### "components" (Kategori)
723737
Konfigurasi untuk pengaktifan dan penonaktifan komponen yang digunakan oleh CIDRAM. Biasanya diisi oleh halaman pembaruan, tetapi juga dapat dikelola dari sini untuk kontrol yang lebih baik dan untuk komponen dipersonalisasi yang tidak dikenali oleh halaman pembaruan.
724738

@@ -2283,4 +2297,4 @@ Informasi lebih rinci akan disertakan disini, dalam dokumentasi, pada waktu yang
22832297
---
22842298
22852299
2286-
Terakhir Diperbarui: 28 Januari 2024 (2024.01.28).
2300+
Terakhir Diperbarui: 21 April 2024 (2024.04.21).

0 commit comments

Comments
 (0)