Peter Elmered

<h4>THIS PLUGIN IS STILL EXPERIMENTAL – USE AT YOUR OWN RISK!</h4>
<p>The plugin is under development. Please try it and contact me if you encounter any bugs or have any questions or suggestions. If you want to help me develop this further send a pull request on <a href="https://github.com/pelmered/wp-pjax" title="WP-PJAX on GitHub" rel="nofollow ugc">GitHub</a>.<br />
The plugin is not ready for production yet, but I will soon release version 0.1 that will be production ready.</p>
<h4>WP-PJAX – PJAX for WordPress Plugin.</h4>
<p>Makes your site faster and saves you a lot of bandwidth and CPU power by making your WordPress site PJAX powered!</p>
<h4>What is PJAX?</h4>
<p>PJAX is a technique that uses AJAX and PushState to deliver a faster browsing experience by only loading and updating parts of the page HTML each page load. PushState makes it possible to add real permalinks, page titles, and a working back button so that your visitors won’t be able to tell the difference between PJAX page load and ordinary full page loads, except for the increased speed of course :).</p>
<h4>Why PJAX?</h4>
<p>It makes your site significantly faster in most cases and saves you both processing power and bandwidth!</p>
<h4>Features</h4>
<ul>
<li>Speeds up any website. With the built in page cache enabled you can expect 10-50+% faster page loads. </li>
<li>Supports 4 Levels of application cache! This plugin uses browser cache and page cache. It is also enabling reverse proxy(i.e. Varnish) cache by (optionally) striping sessions and cookies and it works very well with underlaying object and database cache using third party cache plugins such as <a href="https://wordpress.org/extend/plugins/w3-total-cache/" title="W3 Total Cache" rel="ugc">W3 Total Cache</a> (recommended). </li>
<li>Works well with <a href="https://wordpress.org/extend/plugins/w3-total-cache/" title="W3 Total Cache" rel="ugc">W3 Total Cache</a>.</li>
<li>Configurable. No need to dig into the code. You will still need basic knowledge about HTML and how WordPress works to make this plugin reach it’s full potential.</li>
<li>Live notices with a report for every page load (Load time, page cache hit or miss, Reverse proxy/Varnish cache miss or hit etc – See screenshot). This is great for debugging and testing and is of course only visible for admins.</li>
<li>Only a few changes in your theme and you are ready to go. Should not take more than 5 minutes and requires only basic knowledge.</li>
</ul>
<h4>Browser support</h4>
<p>PJAX is not supported in Internet Explorer 9 and earlier(IE 10+ supports this), but the plugin handles this gracefully by falling back on regular page loads for unsupported browsers. <a href="http://caniuse.com/#search=pushstate" title="Details on browser support" rel="nofollow ugc">Details on browser support</a></p>
<h4>Development</h4>
<p>All development of this plugin occurs on <a href="https://github.com/pelmered/wp-pjax" title="WP-PJAX on GitHub" rel="nofollow ugc">GitHub</a>. Please help me develop this by forking and sending pull requests.</p>
<h4>Planned features / To-Do</h4>
<ul>
<li>Better handling of menu active classes. Will probably use regex for this. Support for marking parent pages active would be nice but I don’t know any good ways to accomplish that.</li>
<li>Better control over exceptions for when to disable PJAX, when you use Page cache, and when and what cookies and sessions that should be striped. Regex support will be added.</li>
<li>Refresh cache on publish/update.</li>
<li>Separate loading of sidebars with separate cache.</li>
<li>Page loading notice / icon. This should also be customizable with css, text(localizable) and it should be possible to upload your own icon.</li>
<li>Page cache prefetch needs to be revisited. WP-Cron is a bit tricky and its hard to handle timeouts gracefully and reliably cross different environments. </li>
<li>Remove all debug code and general code cleanup. This will be finished before the 0.1 release.</li>
<li>Add an optional menu to the admin bar for clearing cache(all and current page).</li>
<li>Optimize execution flow for better performance</li>
<li>Maybe: Better way to generate the configurable javascript. I think of two options for this, ether use <code>wp_localize_script</code> to inject variables into javascript or to generate a javascript with PHP file when settings are saved.</li>
</ul>
<h4>Known issues</h4>
<ul>
<li>The PJAX toggle checkbox does not work. <code>$.pjax.disable()</code> does not seam to work as it should. Maybe I need to set a cookie with AJAX to set this for the current user and then handle it on the server side.</li>
<li></li>
</ul>
<h3>Development</h3>
<p>All development of this plugin occurs on <a href="https://github.com/pelmered/wp-pjax" title="WP-PJAX on GitHub" rel="nofollow ugc">GitHub</a>. Please help me develop this by forking and sending plull requests.</p>


WP-PJAX

Makes WordPress a lot faster using PJAX (PushState + AJAX) for loading content.

David OOWPRESS

<p><strong>OOW PJAX</strong>, brought to you by <strong>OOWCODE</strong> and <strong>OOWPRESS</strong>, revolutionizes WordPress navigation with <strong>PJAX (PushState + AJAX)</strong>, delivering lightning-fast page transitions without full page reloads. Built with <strong>pure JavaScript</strong> (no jQuery), this lightweight plugin ensures a modern, fluid user experience while remaining compatible with any WordPress theme. Whether you’re running a portfolio, a blog with a persistent media player, or a dynamic content site, OOW PJAX enhances navigation, boosts engagement, and reduces server load.</p>
<h3>Why OOW PJAX Stands Out</h3>
<p>OOW PJAX is designed for WordPress sites that demand <strong>seamless navigation</strong> and <strong>dynamic content updates</strong>. Unlike generic performance plugins, it targets specific use cases where fluid transitions are critical, such as:</p>
<ul>
<li><strong>Sites with Persistent Media Players</strong>: Keep audio or video players (e.g., music, podcasts, live streams) running in the footer or sidebar during navigation, avoiding interruptions.</li>
<li><strong>Portfolio Websites</strong>: Showcase projects with smooth, app-like transitions, perfect for photographers, designers, or agencies.</li>
<li><strong>Dynamic Content Sites</strong>: Blogs, magazines, or news sites with frequently updated content benefit from fast, cached page loads.</li>
<li><strong>E-commerce Stores</strong>: Enhance product browsing with quick transitions, keeping users engaged without reload delays.</li>
<li><strong>Single-Page App (SPA) Experiences</strong>: Create a near-SPA feel for membership sites, directories, or dashboards without heavy frameworks.</li>
<li><strong>Interactive Landing Pages</strong>: Deliver immersive experiences for marketing campaigns or event sites with uninterrupted navigation.</li>
</ul>
<p>Version 1.5 introduces a critical fix for handling Unicode characters (e.g., Chinese, emojis) in inline styles, preventing <code>InvalidCharacterError</code> issues with <code>btoa</code>. This update, contributed by <strong>@long-dotcom</strong>, ensures robust style management for multilingual and emoji-rich sites. It also enhances security with dynamic nonce refreshing, improves asynchronous stylesheet handling, and refines form redirect handling, making OOW PJAX more reliable for complex WordPress sites.</p>
<h3>Key Features</h3>
<ul>
<li><strong>Seamless AJAX Navigation</strong>: Loads content via AJAX, updating specific containers without reloading the entire page.</li>
<li><strong>Persistent Elements</strong>: Keeps fixed elements (e.g., media players, sticky menus, chat widgets) intact during transitions.</li>
<li><strong>Browser History Support</strong>: Syncs URLs with the History API for natural forward/back navigation.</li>
<li><strong>Customizable Loader</strong>: Style the loading overlay with CSS to match your brand (e.g., spinner, progress bar).</li>
<li><strong>Content Caching</strong>: Stores pages locally for instant repeat visits, with adjustable cache lifetime and user-aware logic.</li>
<li><strong>Advanced Form Handling</strong>: Submits forms (e.g., comments, login, contact) via AJAX, with explicit nonce support and redirect handling (301, 302, 303, 307, 308).</li>
<li><strong>Dynamic Nonce Refresh</strong>: Automatically refreshes security nonces via AJAX for enhanced security and reliability.</li>
<li><strong>Lightweight & jQuery-Free</strong>: Built with vanilla JavaScript for minimal footprint and maximum performance.</li>
<li><strong>Flexible Configuration</strong>: Define target containers, exclude links/zones (e.g., <code>.no-pjax</code>, <code>#wpadminbar</code>), and add custom JS before/after navigation.</li>
<li><strong>Debug Mode</strong>: Logs detailed information in the browser console and server logs for easy troubleshooting.</li>
<li><strong>Secure Implementation</strong>: Uses dynamic nonces, sanitization, and strict validation for all settings and AJAX requests.</li>
<li><strong>Script Priority Control</strong>: Customize the loading order of <code>oow-pjax.js</code> in the footer for compatibility.</li>
<li><strong>Dynamic Style Management</strong>: Injects and manages page-specific stylesheets and inline styles asynchronously, now with Unicode support.</li>
<li><strong>Advanced Script Execution</strong>: Re-executes scripts in updated containers or footer, with control over inline scripts and validation.</li>
<li><strong>CodeMirror Integration</strong>: Edit Custom JS with syntax highlighting and a Dracula theme.</li>
<li><strong>Unicode Support for Styles</strong>: Safely handles non-Latin1 characters (e.g., Chinese, emojis) in inline styles without errors (new in 1.5).</li>
</ul>
<h3>Who Needs OOW PJAX?</h3>
<p>OOW PJAX is tailored for WordPress users who want to elevate their site’s navigation and user experience. Specific use cases include:</p>
<ul>
<li><strong>Music & Podcast Sites</strong>: Ensure uninterrupted playback of audio players during browsing.</li>
<li><strong>Video Platforms</strong>: Maintain video playback (e.g., tutorials, live streams) across navigation.</li>
<li><strong>Creative Portfolios</strong>: Deliver smooth transitions between project pages for artists or agencies.</li>
<li><strong>Content-Heavy Blogs</strong>: Speed up navigation with caching for frequently visited pages.</li>
<li><strong>E-commerce with Sticky Features</strong>: Keep cart widgets or live chat persistent during browsing.</li>
<li><strong>Membership Sites</strong>: Create fluid navigation for dashboards or course platforms.</li>
<li><strong>Marketing Campaigns</strong>: Build immersive landing pages with fast transitions.</li>
</ul>
<h3>How It Works</h3>
<ol>
<li><strong>Link Interception</strong>: Captures clicks on internal links, skipping external links, <code>target="_blank"</code>, excluded selectors (e.g., <code>.no-pjax</code>), or excluded zones (e.g., <code>#wpadminbar</code>).</li>
<li><strong>AJAX Content Loading</strong>: Fetches new content via AJAX and updates specified containers (e.g., <code>#main</code>, <code>.content</code>).</li>
<li><strong>URL Synchronization</strong>: Updates the browser’s URL using the History API for seamless navigation.</li>
<li><strong>Persistent Elements</strong>: Preserves fixed elements (e.g., media players, sticky headers) across transitions.</li>
<li><strong>Customizable Loader</strong>: Displays a styled overlay during content loading, with configurable minimum duration.</li>
<li><strong>Caching</strong>: Caches pages for instant repeat visits (disabled for logged-in users) with adjustable lifetime.</li>
<li><strong>Form Handling</strong>: Submits forms via AJAX, supporting explicit comment nonces and server-side redirects (e.g., 301, 302).</li>
<li><strong>Script Management</strong>: Re-executes scripts in updated containers or footer, with custom JS execution before/after navigation.</li>
<li><strong>Style Injection</strong>: Asynchronously injects page-specific stylesheets and inline styles, now with robust Unicode support.</li>
</ol>
<h3>Getting Started</h3>
<p>Install OOW PJAX, configure it in minutes, and transform your site’s navigation:<br />
1. Install and activate the plugin from the WordPress admin.<br />
2. Go to <strong>OOWCODE > OOW PJAX</strong> in the WordPress admin panel.<br />
3. In the <strong>Settings</strong> tab, enable PJAX and configure:<br />
   – <strong>Target Containers</strong>: CSS selectors for content updates (e.g., <code>#main</code>).<br />
   – <strong>Exclude Selectors/Zones</strong>: Links or zones to skip (e.g., <code>.no-pjax</code>, <code>#wpadminbar</code>).<br />
   – <strong>Loader CSS</strong>: Customize the loading animation.<br />
   – <strong>Cache Settings</strong>: Enable caching with a lifetime (e.g., 300 seconds).<br />
   – <strong>Form Handling</strong>: Enable AJAX for forms and specify refresh containers (e.g., <code>#comments</code>).<br />
   – <strong>Script Priority</strong>: Set a high value (e.g., 9999) to load <code>oow-pjax.js</code> late.<br />
   – <strong>Custom JS</strong>: Add JavaScript before/after navigation using CodeMirror.<br />
4. Save settings and test navigation on your site.<br />
5. Check the <strong>Overview</strong> tab for tips or the <strong>Support</strong> tab for help.</p>
<h3>Live Demo</h3>
<p>See OOW PJAX in action! Visit our <a href="https://demo.oowcode.com/oow-pjax/" rel="nofollow ugc">live demo</a> to experience seamless transitions, a persistent media player, and portfolio navigation on a real WordPress site.</p>
<h3>Why Choose OOW PJAX?</h3>
<ul>
<li><strong>Targeted Use Cases</strong>: Perfect for sites with persistent media, portfolios, or dynamic content.</li>
<li><strong>SEO-Friendly</strong>: Maintains proper URLs and browser history for search engine compatibility.</li>
<li><strong>Theme-Agnostic</strong>: Works with any WordPress theme by targeting custom containers.</li>
<li><strong>Lightweight Design</strong>: No jQuery, minimal code, and optimized performance.</li>
</ul>
<p>Discover the power of seamless navigation with OOW PJAX by <strong>OOWCODE</strong> and <strong>OOWPRESS</strong>. Visit <a href="https://oowcode.com/oow-pjax" rel="nofollow ugc">oowcode.com/oow-pjax</a> for full documentation.</p>
<h3>Support</h3>
<p>Need help? Visit the <strong>Support</strong> tab in the plugin settings or email <a href="mailto:support@oowpress.com" rel="nofollow ugc">support@oowpress.com</a>. Full documentation is available at <a href="https://oowcode.com/oow-pjax" rel="nofollow ugc">oowcode.com/oow-pjax</a>.</p>
<h3>Contribute</h3>
<p>Contribute to OOW PJAX on <a href="https://github.com/oowcode/oow-pjax" rel="nofollow ugc">GitHub</a> or share feedback at <a href="https://oowcode.com" rel="nofollow ugc">oowcode.com</a>.</p>
<h3>License</h3>
<p>OOW PJAX is licensed under the GPLv2 or later.</p>


OOW PJAX

Transform your WordPress site into a fast, seamless PJAX (PushState + AJAX) experience without jQuery.

WP-PJAX vs OOW PJAX