Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/mohsendro/wpswup/archive/refs/heads/main.zipNo built-in updater. New versions won't appear under Dashboard → Updates. Install new releases yourself, or let Git Updater track the repository.
WP Swup (wpswup)
SPA-like page transitions with Swup.js 4 for WordPress.
Works with WooCommerce, Elementor, and WoodMart — no theme file edits required.
Repository: mohsendro/wpswup
Features
- ⚡ Zero-reload navigation via Swup.js 4
- 🎨 Official Swup themes: fade, slide, overlay (+ directions), or none
- 🔍 Auto-detect content containers (WoodMart, Elementor, common WP themes)
- 🔧 PHP hooks +
window.WPSWUPJavaScript API - 🏗️ Cache plugin headers (WP Rocket, LiteSpeed, …)
- 🧩 WoodMart overlay / side-panel fix on SPA navigations
- ⚙️ Settings → WP Swup
Requirements
- WordPress 5.9+
- PHP 8.0+
Installation
- Clone or download into
wp-content/plugins/wpswup/ - Activate WP Swup
- Configure under Settings → WP Swup
- Leave Swap Containers empty for auto-detect (recommended)
Theme setup
No theme edits required. The plugin auto-detects selectors such as:
- WoodMart:
.main-page-wrapper,.wd-page-content - Elementor page wrappers
#main,#content,#primary,main.site-main, …
Optional: force full reload on specific links:
<a href="/cart/" data-no-swup>Cart</a>
Changelog
1.4.0
- Renamed all internal
SLL/sllidentifiers toWPSWUP/wpswup(namespace, constants, assets, JS API) - Standard WordPress i18n only:
.pot/.po/.mo(removedinstall-mo.phpand.l10n.php) - Migrates legacy
sll_optionstowpswup_optionson load
1.3.0
- Removed Lazy Section Rendering (will ship as a separate plugin later)
- Plugin focused on Swup SPA transitions only
1.2.2
- Strengthened WoodMart overlay close after theme change / reinit
- Official Swup theme instantiation in JS
1.2.1
- Full WordPress i18n (pot / po / mo)
- Official Swup themes selectable in settings
1.1.2
- Renamed project to WP Swup (
wpswup) — main filewpswup.php - Auto-detect containers (WoodMart / Elementor / common themes)
1.1.0
- Swup 4 hooks, Forms/Preload plugins, WooCommerce & Elementor re-init
1.0.0
- Initial release