توضیحات
Sam Scroll Master (SSM) یک افزونه سبک و مدرن برای فعال‌سازی اسکرول نرم در وب‌سایت‌های وردپرسی است.
Features include:
* Smooth scroll on links within the site.
* Enable/disable for frontend and admin.
* Exclude posts, pages, custom post types, or taxonomies.
* Control per user role or guest users.
* Responsive support for desktop, tablet, and mobile.
* Automatic cache purge on settings save (WP Rocket, LiteSpeed Cache, W3 Total Cache, and more).
* Accessibility ready
نحوه استفاده
این افزونه بر اساس تنظیمات انجام‌شده، به‌صورت خودکار روی برگه‌ها، نوشته‌ها و دستگاه‌های انتخاب‌شده اجرا می‌شود:
- فعال‌سازی اسکرول نرم برای بخش کاربری سایت یا پیشخوان مدیریت.
- مستثنا کردن برگه‌ها، نوع‌نوشته‌ها، نوع‌نوشته‌های سفارشی یا موارد طبقه‌بندی.
- فیلتر بر اساس نقش‌های کاربری یا نوع دستگاه (دسکتاپ، تبلت، موبایل).
- Whenever you save the settings, all supported cache plugins are purged automatically.
دست‌اندرکاران
توسعه‌یافته توسط SAM Web Design Agency – https://samwda.ir
این افزونه از SmoothScroll برای وب‌سایت‌ها، ساخته Balazs Galambosi استفاده می‌کند.
مجوز
این افزونه تحت مجوز GPL نسخه ۲ یا بالاتر منتشر شده است.
برای اطلاعات بیشتر به https://www.gnu.org/licenses/gpl-2.0.html مراجعه کنید.
نصب
- پوشه افزونه را در مسیر
/wp-content/plugins/بارگذاری کنید. - افزونه را از طریق منوی «افزونه‌ها» در وردپرس فعال کنید.
- برای تنظیم گزینه‌ها به
تنظیمات > Sam Scroll Masterبروید. - فعال‌سازی در فرانت‌اند، نقش‌های کاربری، دستگاه‌ها و استثناها را طبق نیاز تنظیم کنید.
سوالات متداول
-
آیا می‌توان اسکرول نرم را فقط برای کاربران خاصی فعال کرد؟
-
بله. از بخش «نقش‌های کاربری» در پنل تنظیمات برای کنترل نمایش اسکرول نرم استفاده کنید.
-
آیا می‌توان نوع‌نوشته‌ها یا طبقه‌بندی‌های سفارشی را مستثنا کرد؟
-
کاملاً. SSM از استثنا کردن هر نوع نوع‌نوشته یا طبقه‌بندی، حتی موارد سفارشی، پشتیبانی می‌کند.
-
آیا در پیشخوان وردپرس هم کار می‌کند؟
-
بله. می‌توانید به‌صورت اختیاری آن را برای پیشخوان وردپرس نیز فعال کنید.
-
Does it clear the cache automatically?
-
Yes. On every settings save, SSM purges all caches of supported plugins: WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache, WP Fastest Cache, WP Optimize, SG Optimizer, Autoptimize, Hummingbird, Cache Enabler, Breeze, and Swift Performance – so your changes take effect immediately.
نقد و بررسی‌ها
نقد و بررسی‌ای برای این افزونه یافت نشد.
توسعه دهندگان و همکاران
“اسکرول نرم سام” نرم افزار متن باز است. افراد زیر در این افزونه مشارکت کرده‌اند.
مشارکت کنندگان
“اسکرول نرم سام” به 1 زبان ترجمه شده است. با تشکر از مترجمین برای همکاری و کمک‌هایشان.
ترجمه “اسکرول نرم سام” به زبان شما.
علاقه مند به توسعه هستید؟
کد را مرور کنید، مخزن SVN را بررسی کنید، یا از طریق RSS در گزارش توسعه مشترک شوید.
گزارش تغییرات
1.2
- New: Automatic cache purge on settings save (WP Rocket, LiteSpeed Cache, W3 Total Cache, WP Super Cache, WP Fastest Cache, WP Optimize, SG Optimizer, Autoptimize, Hummingbird, Cache Enabler, Breeze, Swift Performance).
- New:
samsm_after_purge_cachesaction hook for third-party cache integrations. - New: uninstall.php – all plugin options are now removed on uninstall.
- Security: AJAX search endpoint is now admin-only (capability check added, nopriv access removed).
- Security: Whitelist validation for user roles, device types, and post types before saving.
- Fix: Smooth scroll now correctly loads for guest visitors when the “Guest” role is selected.
- Fix: Prevented errors when taxonomy term queries return WP_Error.
- Fix: Taxonomy term exclusions now also apply to pages and all single post types.
- Fix: Smooth scroll no longer attaches to empty “#” links or links pointing to other pages.
- Fix: Valid HTML structure in the settings page.
- Performance: Settings page loads only saved selections; remaining posts are fetched via AJAX search.
- Performance: Taxonomy term lists are capped to keep the settings page fast on large sites.
- Dev: Post/Redirect/Get pattern after saving (prevents duplicate submissions on page refresh).
- Dev: All strings are now translatable (text domain: sam-scroll-master).
- Dev: Forced RTL direction removed from admin CSS; layout follows the WordPress admin locale.
1.1
دسترسی‌پذیری: تنظیمات «ترجیح کاهش حرکت» کاربر رعایت می‌شود – در صورت فعال بودن این گزینه، اسکرول نرم به‌طور خودکار غیرفعال می‌شود.
بازبینی کد: بررسی کامل کد و انجام تست‌های سازگاری برای وردپرس 7 انجام شده است.
1.0
اولین انتشار عمومی همراه با صفحه تنظیمات.