# Particles Backgrounds Addon for WPBakery Page Builder Lite

[![WordPress Plugin Version](https://img.shields.io/badge/version-1.0.2-blue.svg)](https://wordpress.org/plugins/the-basement-agency-particles-background/)
[![WordPress](https://img.shields.io/badge/wordpress-6.7.2%20tested-brightgreen.svg)](https://wordpress.org/plugins/the-basement-agency-particles-background/)
[![PHP](https://img.shields.io/badge/php-7.4%2B-purple.svg)](https://wordpress.org/plugins/the-basement-agency-particles-background/)
[![License](https://img.shields.io/badge/license-GPL%20v2%2B-yellow.svg)](https://wordpress.org/plugins/the-basement-agency-particles-background/)

This powerful WordPress plugin adds pro-level particle backgrounds to the famous WPBakery Page Builder, allowing both novice and mid-level designers to create stunning animated backgrounds on their websites.

![Particles Background Example](https://ps.w.org/the-basement-agency-particles-background/assets/banner-772x250.png)

## Description

Add beautiful animated backgrounds to your WPBakery Page Builder rows or sections with HTML5 canvas-based particles animations. This plugin seamlessly integrates with WPBakery Page Builder to provide an easy-to-use interface for creating dynamic particle effects.

## Features

- **Easy Integration**: Adds a dedicated "Particles" tab to WPBakery Page Builder rows and sections
- **Customizable Particles**: Control particle size, color, speed, shape, and more
- **Interactive Options**: Add hover effects and click interactions to your particle backgrounds
- **Fully Responsive**: Works perfectly on all screen sizes and devices
- **Performance Optimized**: Lightweight implementation that won't slow down your site

## Installation

### From WordPress Plugin Repository

1. Visit the plugins page within your WordPress dashboard and select 'Add New'
2. Search for 'The Basement.Agency Particles Background'
3. Activate the plugin from your Plugins page

### Manual Installation

1. Upload the 'the-basement-agency-particles-background' folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress

No additional configuration is needed - the plugin works out of the box and will add new options to your WPBakery Page Builder interface.

## Requirements

- WordPress 5.6.8 or higher
- PHP 7.4 or higher (compatible with PHP 8.2)
- WPBakery Page Builder plugin (required)

## Usage

1. Edit a page or post with WPBakery Page Builder
2. Add or edit a row element
3. Navigate to the "Particles" tab in the row settings

![Particles Tab](https://ps.w.org/the-basement-agency-particles-background/assets/screenshot-1.png)

4. Configure the particle settings to your liking
5. Save your changes

Alternatively, you can add the "WP Particles.js" element from the WPBakery elements list.

## Example Configuration

![Configuration Example](https://ps.w.org/the-basement-agency-particles-background/assets/screenshot-2.png)

## Frequently Asked Questions

### Is this plugin free?

This plugin comes in two versions: a free version with limited functionality and a paid version with the full range of features.

### Does this plugin work with any theme?

Yes, the plugin is designed to work with any WordPress theme that supports WPBakery Page Builder.

### Is this plugin compatible with the latest WordPress version?

Yes, the plugin is regularly updated to maintain compatibility with the latest WordPress versions.

### What version of PHP do I need?

Sites must be built on PHP 7.4 or greater, and the plugin is compatible with PHP 8.2.

## Premium Version

For advanced features and additional particle effects, check out our premium version at [The Basement Agency](https://particles.thebasement.agency/)

![Premium Features](https://ps.w.org/the-basement-agency-particles-background/assets/screenshot-3.png)

## Support

If you need support or have any questions, please visit our [contact page](https://thebasement.agency/contact/).

## License

This plugin is licensed under the GPL v2 or later.

## Changelog

### 1.0.2
* Added compatibility with PHP 8.2
* Added compatibility with WordPress 6.7.2
* Improved code security and stability
* Fixed various PHP notices and warnings

### 1.0.1
* Fixed bug which made some Particle Effects block the interaction with inner row elements (buttons, textblocks, etc.)

### 1.0.0
* Initial release