== BeePixel Header Footer Builder for Elementor ==
Contributors: jobairkutubi0
Tags: elementor header footer, header footer builder, elementor header, woocommerce header, sticky header
Requires at least: 5.8
Tested up to: 6.9
Requires PHP: 7.4
Requires Plugins: elementor
Stable tag: 1.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Build custom headers and footers with Elementor. Display conditions, WooCommerce support, user role targeting, shortcode support — 100% free.

== Description ==

**BeePixel Header Footer Builder for Elementor** lets you design and display custom header and footer templates on your WordPress site using the Elementor page builder. No coding required. Works with Elementor free — no Elementor Pro needed.

[youtube https://youtu.be/_4sDGtcGw4w]

> 💖 This plugin is free. If it helps your project, consider [supporting development on Patreon](https://www.patreon.com/15986582/join).

---

### Template Types

Create four types of templates:

**Header** — Replaces your theme's default header area with your custom Elementor design.

**Footer** — Replaces your theme's default footer area with your custom Elementor design.

**Before Header** — Adds a zone above the header. Useful for announcement bars, promotional banners, and top bars.

**After Footer** — Adds a zone below the footer. Useful for cookie notices, extra navigation, or secondary footer areas.

---

### Display Conditions

Control exactly where each template appears:

* Entire Website — Show on all pages globally
* Front Page / Homepage — Show only on the front page
* All Singular Posts & Pages — Show on all individual posts and pages
* All Posts — Show on blog posts only
* All Pages — Show on static pages only
* All Archive Pages — Show on category, tag, and date archive pages
* Search Results — Show on search result pages
* 404 Error Page — Show on 404 not found pages
* WooCommerce — Shop Page, Product Pages, Cart Page, Checkout Page

**Exclude Specific Pages:** Enter page or post IDs to exclude any template from specific pages, even when using a global display condition.

---

### User Role Targeting

Show different headers and footers based on who is viewing the page:

* All Users — Default behavior
* Logged In Users Only — Show to members and customers only
* Logged Out / Guest Users Only — Show to visitors who are not signed in
* Specific WordPress Roles — Target Administrators, Editors, Authors, Subscribers, Shop Managers, or any custom role

---

### Additional Features

**Canvas Template** — Enable the Elementor Canvas option to remove the theme header/footer wrapper completely, giving you a truly full-width blank canvas.

**Shortcode Support** — Embed any template anywhere using `[bphfe_template id="123"]`. Find the ID in the URL when editing the template (e.g. `post=123`). Works in posts, pages, text widgets, and any shortcode-enabled area.

---

### Theme Compatibility

Works with all WordPress themes. Tested and compatible with:

* Astra
* GeneratePress
* OceanWP
* Hello Elementor
* Neve
* Kadence
* Blocksy
* Storefront
* Divi
* Avada
* Twenty Twenty-One, Twenty Twenty-Two, Twenty Twenty-Three, Twenty Twenty-Four
* Any other standard WordPress theme

---

### WooCommerce Support

Create custom layouts for your WooCommerce store:

* Display a custom header on the Shop page
* Show a conversion-focused header on Product pages
* Use a simplified header on the Cart and Checkout pages
* Target WooCommerce customer roles specifically

---

### How to Use

1. Install and activate the plugin (Elementor must be installed and active)
2. Go to **BeePixel HFE** in your WordPress dashboard
3. Click **Add New**, enter a template name, then click **Add New**
4. Design your template using Elementor's drag-and-drop editor
5. In the **Template Settings** meta box, set the Template Type, Display Conditions, and User Role options
6. Click **Publish** — your template is now live on the selected pages

---

### Shortcode Example

`[bphfe_template id="123"]`

Replace `123` with your actual template post ID.

---

### Requirements

* WordPress 5.8 or higher
* Elementor (free version is sufficient)
* PHP 7.4 or higher
* Elementor Pro is not required

== Installation ==

**From the WordPress dashboard:**

1. Go to **Plugins > Add New**
2. Search for **BeePixel Header Footer Builder for Elementor**
3. Click **Install Now**, then **Activate**
4. Make sure Elementor is installed and active
5. Go to **BeePixel HFE** in the admin menu to get started

**Manual installation:**

1. Download the plugin zip file
2. Go to **Plugins > Add New > Upload Plugin**
3. Upload the zip file and click **Install Now**
4. Activate the plugin
5. Make sure Elementor is installed and active

== Frequently Asked Questions ==

= Does this require Elementor Pro? =

No. BeePixel Header Footer Builder works with the free version of Elementor. Elementor Pro is completely optional.

= Can I create multiple headers for different pages? =

Yes. You can create as many header and footer templates as you need. Each template has its own display conditions, so you can show different headers on different pages, post types, or user roles.

= Does it work with WooCommerce? =

Yes. The plugin includes display conditions for WooCommerce Shop, Product, Cart, and Checkout pages. You can also target WooCommerce customer roles.

= Can I show a different header for logged-in and logged-out users? =

Yes. Use the User Role Targeting option in the Template Settings. Set one header to "Logged In Users Only" and another to "Logged Out Users Only" with the same display condition.

= How do I exclude a template from a specific page? =

In the Template Settings meta box, find the "Exclude on Pages" field. Enter the page or post ID (found in the URL when editing, e.g. `post=42`) and the template will not appear on that page.

= How do I use the shortcode? =

Edit the template and copy the post ID from the browser URL (e.g. `post=123`). Then use `[bphfe_template id="123"]` anywhere shortcodes are supported.

= Is it compatible with caching plugins? =

Yes. Compatible with WP Rocket, W3 Total Cache, WP Super Cache, LiteSpeed Cache, and other popular caching solutions.

= Will it slow down my website? =

No. The plugin only loads its CSS on pages that have an active template. It does not load any unnecessary scripts or styles on pages without a template.

= What happens when I deactivate the plugin? =

When deactivated, your theme's default header and footer will reappear. Your templates are saved as WordPress posts and will be restored when the plugin is reactivated.

= Can I use it for client projects? =

Yes. The plugin is GPL licensed and can be used on unlimited websites including client projects.

= Where can I get help? =

Post a question in the [WordPress.org support forum](https://wordpress.org/support/plugin/beepixel-header-footer-elementor/) or support the developer via [Patreon](https://www.patreon.com/15986582/join).

== Screenshots ==

1. Template list in the admin dashboard showing Type, Display On, and Status columns
2. Template Settings meta box with Template Type dropdown and Display Conditions
3. User Role Targeting options including Logged In, Logged Out, and specific roles
4. WooCommerce display conditions
5. Patreon support widget in the sidebar
6. Frontend result — custom header active on homepage
7. Frontend result — different header on WooCommerce checkout page
8. Shortcode usage example

== Changelog ==

= 1.0.4 =
* Fix: Consistent version numbers across all files
* Fix: Proper output escaping with wp_kses_post()
* Improved: Frontend CSS z-index and positioning for header and before-header zones
* Improved: Template rendering stability

= 1.0.3 =
* Fix: Elementor CSS enqueued properly — resolved raw CSS text appearing on frontend
* Fix: Added wp_enqueue_scripts before rendering templates

= 1.0.2 =
* Fix: Added theme-specific hooks for Astra, GeneratePress, OceanWP
* Fix: Added universal wp_body_open fallback

= 1.0.1 =
* Fix: Header template rendering moved to correct hook

= 1.0.0 =
* Initial release
* Header, Footer, Before Header, After Footer template types
* 12 display conditions including full WooCommerce support
* User role targeting
* Exclude specific pages by ID
* Elementor Canvas Template support
* Shortcode support: [bphfe_template id="123"]
* Compatible with all major WordPress themes

== Upgrade Notice ==

= 1.0.4 =
Recommended update. Fixes output escaping and version consistency.
