مخفی کردن لینکهای پست از مهمانان – نسخه 1.0.0
سازگاری
این افزونه با نسخههای vBulletin 6.2.2 تا 6.2.99 سازگار است.
نصب
core/packages/hideguestpostlinks/xml/product_hideguestpostlinks.xml
امنیت و نحوه عملکرد
این بسته از هوکهای زیر در vBulletin استفاده میکند:
این قابلیت فقط زمانی اجرا میشود که:
این قابلیت برای کاربران واردشده و همچنین درخواستهای AdminCP اجرا نمیشود.
تگهای Anchor دارای ویژگی href که درون کانتینر زیر قرار دارند:
js-post__content-text
در vBulletin 6.2.2، در سمت سرور شناسایی شده و به یک span غیرقابل کلیک تبدیل میشوند.
در این فرآیند موارد زیر حذف میشوند:
متن مدیری که برای نمایش به مهمانان تعیین میشود، به صورت متن ساده UTF-8 و با رعایت اصول Escape پردازش شده و هرگز به عنوان HTML تفسیر نمیشود.
این پیادهسازی عمداً موارد زیر را تغییر نمیدهد:
اسکنر HTML این افزونه به صورت جریانی (Streaming) کار میکند و تمام بایتهای اطراف پاسخ را بدون بازپردازش یا نرمالسازی کل سند HTML حفظ میکند.
بررسی و اعتبارسنجی
پس از نصب، موارد زیر را بررسی کنید:
< ، > ، & ، "
همچنین یک رشته شبیه کد اسکریپت وارد کنید و بررسی کنید که تمام این موارد فقط به صورت متن ساده نمایش داده شوند.
کش (Caching)
پس از انجام هر یک از عملیات زیر، تمام کشهای صفحه و قالب را پاک کنید:
اگر از Reverse Proxy یا CDN استفاده میکنید، پاسخ کاربران واردشده و مهمانان باید بر اساس کوکیهای نشست (Session Cookies) انجمن از یکدیگر تفکیک شوند.
نباید یک کش صفحه مشترک را به شکلی تنظیم کنید که پاسخ رندرشده یک کاربر برای کاربر دیگری نمایش داده شود.
ارتقا (Upgrade)
برای ارتقای افزونه:
حذف افزونه (Uninstall)
برای حذف کامل افزونه:
core/packages/hideguestpostlinks
بازگردانی (Rollback)
برای بازگردانی سریع، قابلیت را غیرفعال کرده و کشها را پاک کنید.
برای بازگشت به نسخه قبلی:
مبنای فنی
این پیادهسازی بر اساس قابلیتها و ساختارهای موجود در vBulletin 6.2.2 طراحی شده است، از جمله:
برای اجرای این افزونه به هیچ افزونه اختیاری PHP نیاز نیست.
سازگاری
این افزونه با نسخههای vBulletin 6.2.2 تا 6.2.99 سازگار است.
نصب
- قبل از شروع، از پایگاه داده و فایلهای vBulletin خود نسخه پشتیبان تهیه کنید.
- محتویات پوشه upload را با حفظ ساختار مسیرها، در ریشه انجمن آپلود کنید.
- در AdminCP وارد بخش Products & Hooks شده و سپس Manage Products را باز کنید.
- فایل زیر را وارد (Import) کنید:
core/packages/hideguestpostlinks/xml/product_hideguestpostlinks.xml
- وارد بخش Settings شده، سپس Options و بعد Hide Post Links from Guests را باز کنید.
- قابلیت را فعال کرده و پیام متنی دلخواهی را که قرار است به مهمانان نمایش داده شود، وارد کنید.
- کشهای سیستم، قالبها و صفحات کامل (Full-Page) مربوط به vBulletin را پاک کنید.
امنیت و نحوه عملکرد
این بسته از هوکهای زیر در vBulletin استفاده میکند:
- hookFrontendBeforeOutput
- hookFrontendAfterAjaxRender
این قابلیت فقط زمانی اجرا میشود که:
- افزونه فعال باشد.
- کاربر فعلی وارد حساب کاربری نشده باشد و مقدار userid برابر با 0 باشد.
این قابلیت برای کاربران واردشده و همچنین درخواستهای AdminCP اجرا نمیشود.
تگهای Anchor دارای ویژگی href که درون کانتینر زیر قرار دارند:
js-post__content-text
در vBulletin 6.2.2، در سمت سرور شناسایی شده و به یک span غیرقابل کلیک تبدیل میشوند.
در این فرآیند موارد زیر حذف میشوند:
- آدرس اصلی لینک (href)
- ویژگیهای (Attributes) لینک
- محتوای متصل به لینک
متن مدیری که برای نمایش به مهمانان تعیین میشود، به صورت متن ساده UTF-8 و با رعایت اصول Escape پردازش شده و هرگز به عنوان HTML تفسیر نمیشود.
این پیادهسازی عمداً موارد زیر را تغییر نمیدهد:
- پستهای ذخیرهشده
- محتوای واردشده در ویرایشگر
- امضاها
- منوها و ناوبری سایت
- قالبها
- لینکهایی که خارج از محتوای پیام پست قرار دارند
اسکنر HTML این افزونه به صورت جریانی (Streaming) کار میکند و تمام بایتهای اطراف پاسخ را بدون بازپردازش یا نرمالسازی کل سند HTML حفظ میکند.
بررسی و اعتبارسنجی
پس از نصب، موارد زیر را بررسی کنید:
- در حالت خارج از حساب کاربری، موضوعی را باز کنید که در پستهای آن نمونههایی از URL، ایمیل، لینک تصویر و لینک HTML که توسط سایت مجاز هستند وجود داشته باشد. بررسی کنید که تمام لینکهای قابل کلیک موجود در متن پست به حالت غیرقابل کلیک تبدیل شده و مقصد آنها نیز در سورس صفحه وجود نداشته باشد.
- وارد حساب کاربری شوید و همان موضوع را مجدداً بارگذاری کنید. بررسی کنید که تمام لینکهای اصلی و مقصد آنها بدون تغییر نمایش داده شوند.
- گزینه افزونه را غیرفعال کرده، کشها را پاک کنید و بررسی کنید که خروجی برای کاربران مهمان بدون تغییر باقی مانده باشد.
- در قسمت پیام جایگزین، کاراکترهایی مانند موارد زیر را وارد کنید:
< ، > ، & ، "
همچنین یک رشته شبیه کد اسکریپت وارد کنید و بررسی کنید که تمام این موارد فقط به صورت متن ساده نمایش داده شوند.
- بررسی کنید که موارد زیر تحت تأثیر افزونه قرار نگرفته باشند:
- منوی سایت
- امضاها
- پیشنمایش ویرایشگر
- پروفایلها
- لینکهای AdminCP
- صفحات و بخشهای زیر را نیز آزمایش کنید:
- لیست موضوعات
- صفحات موضوعات
- صفحهبندی
- بارگذاری پستها از طریق AJAX
- هرگونه سیستم کش صفحه که در سایت فعال است
- سورس پاسخ صفحه را بررسی کنید و مطمئن شوید که مقدار href حذفشده، در کد HTML مربوط به Anchor جایگزینشده باقی نمانده باشد.
کش (Caching)
پس از انجام هر یک از عملیات زیر، تمام کشهای صفحه و قالب را پاک کنید:
- نصب افزونه
- تغییر تنظیمات
- ارتقای افزونه
- غیرفعال کردن افزونه
- حذف افزونه
اگر از Reverse Proxy یا CDN استفاده میکنید، پاسخ کاربران واردشده و مهمانان باید بر اساس کوکیهای نشست (Session Cookies) انجمن از یکدیگر تفکیک شوند.
نباید یک کش صفحه مشترک را به شکلی تنظیم کنید که پاسخ رندرشده یک کاربر برای کاربر دیگری نمایش داده شود.
ارتقا (Upgrade)
برای ارتقای افزونه:
- از پوشه فعلی افزونه و پایگاه داده نسخه پشتیبان تهیه کنید.
- فایلهای نسخه جدید را فقط روی پوشه مربوط به همین افزونه آپلود و جایگزین کنید.
- فایل XML محصول جدید را با فعال بودن گزینه Overwrite/Upgrade وارد کنید.
- تمام کشهای vBulletin و کشهای خارجی صفحات را پاک کنید.
- مراحل بخش اعتبارسنجی را مجدداً انجام دهید.
حذف افزونه (Uninstall)
برای حذف کامل افزونه:
- قابلیت را غیرفعال کرده و تمام کشها را پاک کنید.
- از طریق AdminCP → Manage Products افزونه Hide Post Links from Guests را حذف کنید.
- پس از حذف محصول، فقط پوشه زیر را حذف کنید:
core/packages/hideguestpostlinks
- دوباره تمام کشها را پاک کنید.
بازگردانی (Rollback)
برای بازگردانی سریع، قابلیت را غیرفعال کرده و کشها را پاک کنید.
برای بازگشت به نسخه قبلی:
- نسخه فعلی افزونه را حذف کنید.
- پوشه پشتیبان نسخه قبلی افزونه را بازگردانی کنید.
- فایل XML نسخه قبلی محصول را وارد کنید.
- در صورت نیاز، تنظیمات نسخه قبلی را نیز بازگردانی کنید.
- تمام کشها را پاک کنید.
مبنای فنی
این پیادهسازی بر اساس قابلیتها و ساختارهای موجود در vBulletin 6.2.2 طراحی شده است، از جمله:
- استاندارد package hookClasses
- دو هوک خروجی Frontend مورد استفاده برای رندر صفحات کامل و AJAX
- دسترسی به userid نشست فعلی
- دسترسی به گزینههای موجود در Datastore
- ساختار تنظیمات موجود در Product XML
- کلاس js-post__content-text مورد استفاده در قالبهای پیشفرض پستها
برای اجرای این افزونه به هیچ افزونه اختیاری PHP نیاز نیست.



