FAIR

Federated and Independent Repositories

cbParallax

Plugin Banner

cbParallax

by Demis Patti

Download
Description

cbParallax lets you add custom background images with a vertical or horizontal parallax effect to your WordPress site. You can set a single background for the entire site or configure individual backgrounds for each post, page, or product.

Features:

  • Background image with smooth parallax scrolling effect
  • One image for all pages or individual backgrounds per page/post
  • Works vertically and horizontally
  • Various overlay patterns to choose from
  • Color overlay with opacity control
  • Boxed layout option with customizable margins
  • Mobile device detection with option to disable parallax on mobile
  • Compatible with WooCommerce products

Requirements:

  • Your theme must support the WordPress Custom Backgrounds theme feature
  • For parallax effect, images should be at least 1920px x 1200px
  • PHP 8.0 or higher

Privacy Policy

This plugin does not collect, store, or transmit any personal data. All settings are stored locally in your WordPress database.

  1. Upload the cb-parallax folder to your /wp-content/plugins/ directory
  2. Activate the plugin through the ‘Plugins’ menu in WordPress
  3. Go to Settings > cbParallax to configure the plugin
  4. Optionally, enable per-post backgrounds and edit individual posts to add custom backgrounds
  1. Multiple background views of a single post

    Multiple background views of a single post

  2. Settings Page with all configuration options

    Settings Page with all configuration options

  3. Custom background meta box on the post edit screen

    Custom background meta box on the post edit screen

Where do I interact with this plugin?

You can access the main settings under Settings > cbParallax in your WordPress admin. If you enable the “Individual Background Images” option, a meta box will appear on your post/page edit screens.

Why doesn’t it work with my theme?

Most likely your theme doesn’t support the WordPress custom-background theme feature. Check with your theme author to see if they can add support. The theme needs to call add_theme_support('custom-background').

My theme supports custom-background but it still doesn’t work!

Make sure no container element (like a full-width wrapper) is covering the body element where the background is displayed. You may need to add some CSS transparency to your content container.

How do I add theme support?

If you’re a theme developer, add this to your theme’s functions.php:
add_theme_support( ‘custom-background’ );

What image dimensions work best?

For the best parallax effect, use images at least 1920px wide and 1200px tall. This ensures smooth scrolling on fullHD displays with room for the parallax movement.

Can I disable the parallax effect on mobile?

Yes! There’s an option in the settings to disable the parallax effect on mobile devices, which can help with performance.

Working on last update!

By volicius on August 15, 2020

And it does just want we need, BACKGROUND IMAGE WITH PARALLAX!!

Love it! Does exactly what I wanted!

By LilGames on December 15, 2018

It was difficult to find a plugin that did what I simply wanted: Parallax the custom background! And it works with Divi! My only suggestions to the developer: 1. Update it to 5.0 compatiblilty (I mean, it WORKS, but make sure your plugin is secure) 2. Any way you can make it scroll smoothly? When I mouse-wheel the motion is choppy. Try interpolating the change in position... 🙂

Great plugin

By sharcs on July 1, 2017

Plugin works, the controls are simple but effective and the support was great.

Amazing plugin!

By alainmelsens on April 19, 2017

This is an amazing and very useful plugin. The only thing I miss, is to delete or replace an image on the current page. But maybe this is something to put on the to-do list? Greetings.

Works like a charm! Love it!

By ikar77 on February 14, 2017

Thanks a lot Demis for a plugin in general and for a new feature - responsive backgrounds! Asked for it just a week ago, and "voilà" - new version with implemented feature! Very useful and elegant plugin. Thanks!

Small and beautiful

By mattanius on December 10, 2016

Well-done little plugin that is easy to understand and use and works out of the box (if your theme supports the custom-background CSS class, that is … it often does if it allows you to set a background color or image in the theme options). As of version 0.4.2, it's not yet possible to have defaults for background images and parallax options for the scroll effect, so you have to repeat the setting for each page and post you want it on. But that's already everything I'm missing a bit 🙂 Edit: As of version 0.6.0, Demis has added a feature for default background settings now. You find it at "Settings → cbParallax" in your WordPress site.

1.0.0

  • Security: Added proper sanitization and escaping throughout the plugin
  • Security: Added capability checks on AJAX handlers
  • Security: Fixed nonce verification issues
  • Fixed: Corrected form tag closure in settings page
  • Fixed: Removed references to non-existent options in AJAX responses
  • Improved: Mobile detection using WordPress wp_is_mobile() function
  • Improved: Code formatting to WordPress coding standards
  • Improved: Updated file headers and documentation
  • Updated: Requires WordPress 6.6 or higher
  • Updated: Requires PHP 8.0 or higher

0.9.2.4

  • Previous stable release
Back to top