From 146ee6ceca1764ace8492592f42a6d90ac999202 Mon Sep 17 00:00:00 2001 From: Arash Yousefi Date: Sat, 16 Nov 2024 18:51:59 +0330 Subject: [PATCH] Add expiration date for user-addon docs (#99) --- addons/ReadMe.md | 13 +++---- addons/list_service_providers.md | 58 -------------------------------- 2 files changed, 5 insertions(+), 66 deletions(-) delete mode 100644 addons/list_service_providers.md diff --git a/addons/ReadMe.md b/addons/ReadMe.md index 2db5708..ff9c6b9 100644 --- a/addons/ReadMe.md +++ b/addons/ReadMe.md @@ -19,13 +19,10 @@ ### قابلیت‌های افزونه کاربر -افزونه کاربر به خودی خود موجودیت مستقلی دارد که در کنار اطلاعات معنایی افزونه `semantic` باعث بهبود کاربرد پذیری دیوار برای کاربران میشود. -با این حال، افزونه کاربر با تنظیمات مناسب میتواند منجر به الصاق افزونه آگهی روی آگهی‌های گذشته با عمق ۳۰ آگهی و آگهی‌های آینده تا زمان وجود افزونه گردد. +با استفاده از افزونه‌ی کاربر شما می‌توانید اطلاعات مربوط به کاربران را بر روی حساب کاربری آن‌ها بچسبانید. +همچنین این اطلاعات هنگام ساخت آگهی جدید توسط کاربر به صورت خودکار بر روی آگهی‌های کاربر چسبانده می‌شود و بر روی حداکثر ۳۰ آگهی اخیر کاربر نیز ثبت می‌شود. +این افزونه‌ها پس از ۳ ماه به صورت خودکار منقضی خواهند شد. - -# لیست افزونه‌های دیوار و تولید CTA - -برای آگاهی از نحوه تولید لینک‌های از صفحه مدیریت آگهی به سمت اپلیکیشن شما میتوانید -[سند لیست سرویس پرووایدر](./list_service_providers.md) - را مطالعه نمائید. +دقت کنید که کنار ضمانتی برای پاک کردن افزونه‌ها در لحظه‌ی منقضی شدن شان نمی‌دهد و ممکن است این فرایند با تاخیر انجام بپذیرد. +در صورتی که نیاز دارید زمان اعتبار افزونه‌ کاربرتان را کنترل کنید باید در زمان مورد نظرتان، افزونه را به روز یا حذف کنید. diff --git a/addons/list_service_providers.md b/addons/list_service_providers.md deleted file mode 100644 index ee1650d..0000000 --- a/addons/list_service_providers.md +++ /dev/null @@ -1,58 +0,0 @@ -# لیست ارائه‌دهندگان خدمات - -از صفحه مدیریت آگهی یا احتمالا صفحات دیگری از دیوار میتوان به لیستی از ارائه دهندگان خدمات دست یافت. لینک مربوط به درخواست خدمت از اپلیکیشن شما را خود شما از طریق تماس با رابط پلتفرم دیوار در اختیار ما قرار داده اید. - -> این لینک می‌تواند شامل query string باشد و پارامترهای مختلفی از طرف دیوار یا سرویس‌دهنده در آن وجود داشته‌باشند. - -برای مثال در آدرس زیر سه دسته query param وجود دارد که در ادامه توضیح داده‌شده: -```text -https://example.com/service_path/? - app_slug=example_app& - body_chassis_status.back_chassis_status=healthy& - body_chassis_status.body_status=some-scratches& - body_chassis_status.front_chassis_status=healthy& - body_status=some-scratches& - brand_model=Pride+131+SE& - category=light& - chassis_status=both-healthy& - color=%D8%B3%D9%81%DB%8C%D8%AF& - fuel_type=benzine& - gearbox=manual& - motor_status=healthy& - new_price=203000000.000000& - post_token=QZk4AH_B& - prefilled_title=%D9%BE%D8%B1%D8%A7%DB%8C%D8%AF+131+SE%D8%8C+%D9%85%D8%AF%D9%84+%DB%B1%DB%B3%DB%B9%DB%B2& - price.mode=%D9%85%D9%82%D8%B7%D9%88%D8%B9& - price.value=203000000.000000& - third_party_insurance_deadline=11& - usage=256000.000000& - utm_campaign=inspection_26aug& - utm_medium=admanagement& - utm_source=divar& - year=%DB%B1%DB%B3%DB%B9%DB%B2 -``` - -در اینجا مقدار پارامتر زیر را پلتفرم باز دیوار تنظیم میکند: -- app_slug -- post_token -- ticket_uuid - -برخی مقادیر توسط خود اپلیکیشن در این لینک قرار داده شده: -- utm_campaign -- utm_medium -- utm_source - -باقی پرامترها از روی اطلاعات آگهی برای شما تنظیم شده اند: -- price.value -- usage -- ... - -> از این پارامترها میتوانید برای پر کردن مقدار اولیهٔ فرمهای خود یا نمایش اطلاعات اولیهٔ آگهی به کاربر استفاده کنید. این کار را برای جلوگیری از نیاز شما به ارسال درخواست برای دریافت اطلاعات آگهی انجام داده‌ایم. - -> صفحهٔ شما باید نسبت به query param اضافه‌تر یا کمتر مقاوم باشد. همچنین ممکن است نوع مقدار یک پارامتر تغییر کند. برای مثال در آینده مقادیر float به integer تغییر خواهند کرد. - -> این مثال ارائه شده برای یک نمونه آگهی در دسته‌بندی خودرو است. هر دسته‌بندی دارای مقادیر مختص خود است که فهرست آنها در آینده اضافه خواهد شد. - -> پارامتر ticket_uuid توسط تیم های دیوار پر میشود. شما باید این پارامتر را استخراج کنید و در صورت معتبر بودن مقدار آن، از موجودی آن استفاده کنند. توضیحات بیشتر در قسمت [تیکت پرداخت](../payment-ticket/payment_ticket.md) ارائه شده‌است. - ->در صورتی که پارامتر addon_creation با مقدار false در آدرس وجود داشت. شما می‌بایست فلوی خود را در حالت مینیمال اجرا کنید. (لینک به صفحه یا بخش‌های دیگری از خدماتتان نداشته‌باشد و صرفاً اطلاعات مورد نیاز برای انجام عملیات را از کاربر بگیرد و به دیوار برگردد). در این حالت مکملی هم برای نمایش در آگهی درج نمی‌شود.