Description
Responsive, fullscreen background image with a parallax effect.
Features
- Custom background image
- One Image for all pages or individual images and effects on a per post basis
- Compatible with posts, pages, products, and many more
- Optional fullscreen background parallax effect
- Works vertically and, for fun, horizontally
- Various overlays to choose from
Requirements
- Your theme must support the core WordPress implementation of the Custom Backgrounds theme feature.
- In order to use the parallax feature, I decided to set the minimum required image dimensions to 1920px * 1200px, which covers a fullHD screen with a slight vertical parallax movement ( Image height – viewport height, so 1200px – 1080px gives 120px offset to move the image. I hope you get the point here.).
- You most likely need to edit some css in order to “uncover” the background image or parts of it respectively. Your theme’s layout should be “boxed”, or an opacity should be added to the page content container for the background image to be seen.
- PHP version 8.0 or above.
Screenshots
Multiple background views of a single post. 
Settings Page. 
Custom background meta box on the edit post screen.
Installation
- Upload the
cb-parallaxfolder to your/wp-content/plugins/directory. - Activate the “cbParallax” plugin through the “Plugins” menu in WordPress.
- Edit a post to add a custom background.
FAQ
-
Where do I interact with this plugin and how does it work?
-
Please visit the plugin help tab for further information.
-
Why doesn’t it work with my theme?
-
Most likely, this is because your theme doesn’t support the WordPress
custom-backgroundtheme feature.
This plugin requires that your theme utilize this theme feature to work properly.
Unfortunately, there’s just no reliable way for the plugin to overwrite the background if the theme doesn’t support this feature.
You’ll need to check with your theme author to see if they’ll add support or switch to a different theme. -
My theme supports ‘custom-background’ but it doesn’t work!
-
That’s unlikely.
Just to make sure, check with your theme author and make sure that they support the WordPresscustom-backgroundtheme feature.
Also, make sure that no container element is covering the element that holds the background image. -
How do I add support for this in a theme?
-
Your theme must support the [Custom Backgrounds] (https://codex.wordpress.org/Custom_Backgrounds) feature for this plugin to work.
If you’re a theme author, consider adding support for this feature if you can make it fit in with your design. The following is the basic code, but check out the above link.
add_theme_support( ‘custom-background’ ); -
Are there any known limitations?
-
- This is not really a limitation of functionality, but since the background image container wraps the body element, it usually resembles the viewport dimensions. This means, that on themes where the navigation bar is on the side, the sidebar covers a part of the viewport and thus also a part of the image (logic, but noteworthy).
-
Can you help me?
-
Yes. I have a look at the plugin’s support page two or three times a month and I provide some basic support there.
-
Are there any known issues?
-
- Besides the known limitations, no.
Reviews
Contributors & Developers
“cbParallax” is open source software. The following people have contributed to this plugin.
Contributors
Translate “cbParallax” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.