{"id":288941,"date":"2026-05-17T05:39:19","date_gmt":"2026-05-17T05:39:19","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/smooth-custom-cursor\/"},"modified":"2026-07-10T10:22:43","modified_gmt":"2026-07-10T10:22:43","slug":"smooth-custom-cursor","status":"publish","type":"plugin","link":"https:\/\/te.wordpress.org\/plugins\/smooth-custom-cursor\/","author":23464094,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.3.0","stable_tag":"2.3.0","tested":"7.0.1","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"Smooth Custom Cursor","header_author":"Himanshu Singh","header_description":"Adds a smooth customizable cursor with magnetic hover, trail and ripple effects.","assets_banners_color":"1e0c28","last_updated":"2026-07-10 10:22:43","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/hsarticle.com\/smooth-custom-cursor\/","header_author_uri":"https:\/\/hsarticle.com","rating":5,"author_block_rating":0,"active_installs":300,"downloads":3060,"num_ratings":1,"support_threads":1,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"2.1":{"tag":"2.1","author":"hsarticle","date":"2026-05-21 06:01:21"},"2.2":{"tag":"2.2","author":"hsarticle","date":"2026-06-07 18:50:04"},"2.3.0":{"tag":"2.3.0","author":"hsarticle","date":"2026-07-10 10:22:43"}},"upgrade_notice":{"2.3.0":"

Adds 8 new cursor styles (9 total) with per-style settings and live previews. Your existing Dot + Ring configuration is preserved and stays selected by default after updating.<\/p>","2.2":"

Cursor z-index fix \u2014 recommended update.<\/p>","2.1":"

Security and compatibility improvements \u2014 please update.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3534244,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3534244,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3602628,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3602628,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["2.1","2.2","2.3.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Admin settings panel \u2014 pick a cursor style and configure it with a live preview.","2":"Cursor in action on the frontend."}},"plugin_section":[],"plugin_tags":[785,21364,21368,13320,263212],"plugin_category":[50],"plugin_contributors":[263778],"plugin_business_model":[],"class_list":["post-288941","plugin","type-plugin","status-publish","hentry","plugin_tags-animation","plugin_tags-cursor","plugin_tags-custom-cursor","plugin_tags-mouse","plugin_tags-smooth-cursor","plugin_category-media","plugin_contributors-hsarticle","plugin_committers-hsarticle"],"banners":{"banner":"https:\/\/ps.w.org\/smooth-custom-cursor\/assets\/banner-772x250.png?rev=3602628","banner_2x":"https:\/\/ps.w.org\/smooth-custom-cursor\/assets\/banner-1544x500.png?rev=3602628","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/smooth-custom-cursor\/assets\/icon-128x128.png?rev=3534244","icon_2x":"https:\/\/ps.w.org\/smooth-custom-cursor\/assets\/icon-256x256.png?rev=3534244","generated":false},"screenshots":[],"raw_content":"\n

Smooth Custom Cursor replaces the default browser cursor with a beautiful animated cursor effect. Fully customizable from the WordPress admin panel, with a live preview box for every style.<\/p>\n\n

Choose from 9 cursor styles:\n1. Dot + Ring \u2014 classic lagging ring with magnetic hover (the original style)\n2. Glow Circle \u2014 small circle that grows into a larger circle with custom text on hover\n3. Diamond \u2014 a tilting diamond shape that reacts to movement direction\n4. Water Arrow \u2014 a hollow arrow that fills up like liquid and drains, on a loop\n5. Bubble Trail \u2014 a normal-looking arrow that releases bubbles while moving\n6. Character Trail \u2014 a normal-looking arrow that releases letters\/characters while moving\n7. Sparkle \u2192 Arrow \u2014 a spinning sparkle that tilts with movement and morphs into an arrow-in-circle on hover\n8. Seed \u2192 Bloom \u2014 a seed that drifts with a trailing vine and blooms into a flower on hover, with an optional magnetic button pull\n9. Image Cursor \u2014 upload any image from your Media Library to use as the cursor<\/p>\n\n

Features:\n* 9 selectable cursor styles, each with its own settings section\n* Live preview box on the settings page for every style \u2014 see your changes before saving\n* Customizable colors, sizes, hover sizes, speed, and particle amount depending on style\n* Optional magnetic button-pull effect (Seed \u2192 Bloom style only)\n* Option to disable on mobile\/touch devices\n* Hides cursor when mouse leaves the browser window\n* Zero dependencies \u2014 pure vanilla JavaScript\n* Lightweight and performance-optimized<\/p>\n\n\n

    \n
  1. Upload the smooth-custom-cursor folder to the \/wp-content\/plugins\/ directory, or install directly via Plugins > Add New in WordPress admin.<\/li>\n
  2. Activate the plugin through the Plugins menu.<\/li>\n
  3. Go to Settings > Cursor Ultimate to pick a cursor style and configure its settings, using the live preview box to check it before saving.<\/li>\n<\/ol>\n\n\n
    \n

    Does it work with all themes?<\/h3><\/dt>\n

    Yes. The plugin injects the cursor elements via wp_footer and loads styles\/scripts on all frontend pages.<\/p><\/dd>\n

    Can I disable it on mobile?<\/h3><\/dt>\n

    Yes. In Settings > Cursor Ultimate, check the \"Disable on Mobile\" option.<\/p><\/dd>\n

    Why does my default cursor still show?<\/h3><\/dt>\n

    Make sure no other plugin or theme CSS is overriding cursor: none. The plugin sets cursor: none !important on all elements.<\/p><\/dd>\n

    Can I switch between styles without losing my settings?<\/h3><\/dt>\n

    Yes. Each style's settings are stored separately, so switching the \"Cursor Style\" dropdown keeps your previous configuration for every style intact.<\/p><\/dd>\n

    Does the magnetic button effect apply everywhere?<\/h3><\/dt>\n

    When enabled (Seed \u2192 Bloom style only), it applies to all buttons and links site-wide. If you have a lot of inline text links, consider leaving it off since pulling running text can look odd.<\/p><\/dd>\n

    What happens if I choose Image Cursor but don't upload an image?<\/h3><\/dt>\n

    The plugin falls back to the normal browser cursor until an image is chosen.<\/p><\/dd>\n

    What WordPress version is required?<\/h3><\/dt>\n

    WordPress 5.8 or higher.<\/p><\/dd>\n\n<\/dl>\n\n\n

    2.3.0<\/h4>\n\n
      \n
    • New: 8 additional cursor styles \u2014 Glow Circle, Diamond, Water Arrow, Bubble Trail, Character Trail, Sparkle \u2192 Arrow, Seed \u2192 Bloom, and Image Cursor (9 total, including the original Dot + Ring)<\/li>\n
    • New: Cursor Style dropdown in Settings > Cursor Ultimate, with a dedicated settings section per style<\/li>\n
    • New: Live preview box on the settings page for every style, reflecting unsaved changes in real time<\/li>\n
    • New: Diamond uses a color-invert effect on hover<\/li>\n
    • New: Optional magnetic button-pull effect for Seed \u2192 Bloom, with adjustable radius and strength<\/li>\n
    • New: Size and Hover Size controls for Bubble Trail and Character Trail<\/li>\n
    • Improved: Clearer labeling for Bubble Trail \/ Character Trail spacing controls (\"Bubble\/Character Spacing (distance in px)\" with a plain-language explanation)<\/li>\n
    • Improved: Settings for every style are saved independently, so switching styles never loses your previous configuration<\/li>\n
    • Improved: All new inputs sanitized and validated (hex colors, clamped number ranges, whitelisted dropdowns, sanitized image URLs) with nonce + capability checks, matching existing security practices<\/li>\n<\/ul>\n\n

      2.2<\/h4>\n\n
        \n
      • Fixed: Cursor z-index increased to always stay on top<\/li>\n<\/ul>\n\n

        2.1<\/h4>\n\n
          \n
        • Fixed: CSS variables now injected via wp_add_inline_style<\/li>\n
        • Fixed: All functions and options prefixed with smoocucu_<\/li>\n
        • Fixed: POST inputs now use isset, wp_unslash and sanitization<\/li>\n
        • Fixed: ABSPATH check added to all PHP files<\/li>\n
        • Security: Nonce verification on settings form<\/li>\n
        • Security: Capability check on settings page<\/li>\n
        • Improved: Cursor hides when mouse leaves browser window<\/li>\n<\/ul>\n\n

          2.0<\/h4>\n\n
            \n
          • Initial release.<\/li>\n<\/ul>","raw_excerpt":"Adds a smooth, animated custom cursor \u2014 choose from 9 cursor styles, each fully customizable with a live preview \u2014 no coding needed.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/288941","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=288941"}],"author":[{"embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/hsarticle"}],"wp:attachment":[{"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=288941"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=288941"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=288941"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=288941"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=288941"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/te.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=288941"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}