Update open_web_page to fix 26

divar-ir · Apr 27, 2024 · 6c7b119 · 6c7b119
1 parent 0371e08
commit 6c7b119
Show file tree

Hide file tree

Showing 2 changed files with 20 additions and 19 deletions.
diff --git a/misc/README.md b/misc/README.md
diff --git a/widgets/actions/open_web_page.md b/widgets/actions/open_web_page.md
@@ -20,3 +20,23 @@
 # اعتبارسنجی اکشن 
 
 نیاز است تا هر دو فیلد `fallback_link` و `url` پر شود و value آن ها یک url ولید بدون whitespace باشد.
+
+### اعلام وضعیت کاربر در زمان بازگشت به دیوار
+برای اعلام وضعیت کاربر و اطلاع دیوار از موفقیت یا عدم موفقیت فرایند کاربر، لازم است هنگام هدایت کاربر به آدرسی که در در پاسخ به درخواست بالا با عنوان `return_url` دریافت کرده‌اید، پارامترهای زیر را اضافه کنید.
+| مثال    | توضیحات                                                       | پارامتر |
+|---------|---------------------------------------------------------------|---------|
+| 200000  | هزینه پرداخت شده توسط کاربر به ریال                           | price   |
+| success | success or fail نشان دهنده موفق بودن یا نبودن عملیات است | status  |
+
+نکته بسیار مهم این است که این عملیات ممکن است باعث [open redirection](https://learn.snyk.io/lesson/open-redirect/) یا حتی [xss](https://owasp.org/www-community/attacks/xss/)  شود بنابراین حتما بررسی کنید که url داده شده برای دیوار باشد. تکه کد زیر یک فانکشن جاوااسکریپت است که بررسی می‌کند آدرس ورودی برای دیوار باشد.
+```js
+function isDivarLink(link) {
+  // Define the regular expression for divar.ir and its subdomains
+  const divarRegex = /^https:\/\/(?:[a-zA-Z0-9-]+\.)?divar\.ir(\/?|\/.+)/;
+
+  // Test the link against the regular expression
+  return divarRegex.test(link);
+}
+```
+
+*نکته:* ر صورتی که آدرس بازگشت به دیوار را به هر دلیل ندارید، می‌توانید کاربر را به صفحهٔ [دیوار من](https://divar.ir/my-divar/my-posts) یا دیپ‌لینک‌های دیگر هدایت کنید یا از طریق جاواسکریپت، تب باز شده رو ببندید(لیست دیپ‌لینک‌ها به زودی به مستندات افزوده خواهدشد)