Title: Sam Scroll Master
Author: SAM Web Design Agency
Published: <strong>28 جنوري 2026</strong>
Last modified: 8 سيپٽمبر 2026

---

پلگ انس ڳولھيو

![](https://ps.w.org/sam-scroll-master/assets/banner-772x250.png?rev=3569338)

![](https://ps.w.org/sam-scroll-master/assets/icon-256×256.png?rev=3569338)

# Sam Scroll Master

 کان: [SAM Web Design Agency](https://profiles.wordpress.org/samwda/)

[ڊائون لوڊ ڪريو](https://downloads.wordpress.org/plugin/sam-scroll-master.1.2.zip)

 * [تفصيل](https://snd.wordpress.org/plugins/sam-scroll-master/#description)
 * [جائزو](https://snd.wordpress.org/plugins/sam-scroll-master/#reviews)
 *  [تنصيب](https://snd.wordpress.org/plugins/sam-scroll-master/#installation)
 * [ترقي](https://snd.wordpress.org/plugins/sam-scroll-master/#developers)

 [سھائتا](https://wordpress.org/support/plugin/sam-scroll-master/)

## وضاحت

**Sam Scroll Master (SSM)** is a lightweight and modern plugin to enable smooth 
scrolling across WordPress sites.

**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

### Usage

The plugin works automatically on selected pages/posts and devices based on the 
settings:

 * Enable smooth scrolling for frontend or admin panel.
 * Exclude specific pages, post types, custom post types, or taxonomy terms.
 * Filter by user roles or device types (desktop, tablet, mobile).
 * Whenever you save the settings, all supported cache plugins are purged automatically.

### Credits

Developed by SAM Web Design Agency – https://samwda.ir
 This plugin uses SmoothScroll
for websites by Balazs Galambosi.

### License

This plugin is licensed under the GPLv2 or later.
 See https://www.gnu.org/licenses/
gpl-2.0.html for details.

## انسٽاليشن

 1. Upload the plugin folder to the `/wp-content/plugins/` directory.
 2. Activate the plugin through the ‘Plugins’ menu in WordPress.
 3. Navigate to `Settings > Sam Scroll Master` to configure options.
 4. Configure frontend activation, user roles, devices, and exclusions as needed.

## FAQ

### Can I enable smooth scroll only for certain users?

Yes. Use the “User Roles” section in the settings panel to control who sees smooth
scroll.

### Can I exclude custom post types or taxonomies?

Absolutely. SSM supports exclusions for any post type or taxonomy, including custom
ones.

### Does it work in WordPress admin?

Yes. You can enable it optionally for WordPress admin panel.

### 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.

## جائزا

ھن پلگ ان لاءِ ڪي به رايا ناھن.

## تعاون ڪندڙ & ڊولپرز

“Sam Scroll Master” اوپن سورس سافٽ ويئر آهي. ھيٺين ماڻھن ھن پلگ ان ۾ حصو ورتو آھي.

تعاون ڪندڙ

 *   [ SAM Web Design Agency ](https://profiles.wordpress.org/samwda/)
 *   [ Ahmadreza Mahjoob ](https://profiles.wordpress.org/smahjoob/)

واحد: “Sam Scroll Master” 1 لوڪل ۾ ترجمو ڪيو ويو آهي. [ترجمي ڪندڙن](https://translate.wordpress.org/projects/wp-plugins/sam-scroll-master/contributors)
جي مهرباني سندن تعاون لاءِ.

[ترجمو ڪريو “Sam Scroll Master” توهان جي ٻولي ۾.](https://translate.wordpress.org/projects/wp-plugins/sam-scroll-master)

### ڊولپمينٽ ۾ دلچسپي؟

[ڪوڊ براؤز ڪريو](https://plugins.trac.wordpress.org/browser/sam-scroll-master/)،
چيڪ ڪريو [SVN مخزن](https://plugins.svn.wordpress.org/sam-scroll-master/)، يا رڪنيت
حاصل ڪريو [ڊولپمينٽ لاگ](https://plugins.trac.wordpress.org/log/sam-scroll-master/)
پاران [RSS](https://plugins.trac.wordpress.org/log/sam-scroll-master/?limit=100&mode=stop_on_copy&format=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_caches` action 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

Accessibility: Respect user’s prefers-reduced-motion setting – smooth scroll automatically
disabled when reduced motion is requested.
 Code review: Full code audit and compatibility
testing performed on WordPress 7.

#### 1.0

Initial public release with settings page.

## ميٽا

 *  Version **1.2**
 *  Last updated **1 مهينو اڳ**
 *  Active installations **10 کان گھٽ**
 *  WordPress version ** 6.0 يا وڌيڪ **
 *  Tested up to **7.1.3**
 *  PHP version ** 7.4 يا وڌيڪ **
 *  Languages
 * [English (US)](https://wordpress.org/plugins/sam-scroll-master/) ۽ .[Persian](https://fa.wordpress.org/plugins/sam-scroll-master/).
 *  [پنھنجي ٻولي ۾ ترجمو ڪريو](https://translate.wordpress.org/projects/wp-plugins/sam-scroll-master)
 * Tags
 * [cache](https://snd.wordpress.org/plugins/tags/cache/)[javascript](https://snd.wordpress.org/plugins/tags/javascript/)
   [scroll](https://snd.wordpress.org/plugins/tags/scroll/)[simple plugin](https://snd.wordpress.org/plugins/tags/simple-plugin/)
   [smooth scroll](https://snd.wordpress.org/plugins/tags/smooth-scroll/)
 *  [ترقي يافته ڏيک](https://snd.wordpress.org/plugins/sam-scroll-master/advanced/)

## درجه بندي

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/sam-scroll-master/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/sam-scroll-master/reviews/)

## تعاون ڪندڙ

 *   [ SAM Web Design Agency ](https://profiles.wordpress.org/samwda/)
 *   [ Ahmadreza Mahjoob ](https://profiles.wordpress.org/smahjoob/)

## سھائتا

چوڻ لاءِ ڪجهه آهي؟ مدد گهرجي؟

 [ڏسو سپورٽ فورم](https://wordpress.org/support/plugin/sam-scroll-master/)

## عطيو

ڇا توھان ھن پلگ ان جي ترقي ۾ مدد ڪرڻ چاھيو ٿا؟

 [ هن پلگ ان ڏانھن مدد ڪريو ](https://samwda.ir)