=== Pixlora Elements – Widgets & Theme Builder for Elementor ===
Contributors: kiranmulmi
Tags: elementor, widgets, header, footer, theme builder
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.4.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Custom Elementor widgets and a lightweight header/footer and theme-part builder.

== Description ==

Pixlora Elements extends the free Elementor page builder with:

* A dedicated **Pixlora** widget category containing site logo, nav menu, social icons, copyright, button, link list, posts (six designs: classic grid, side image list, masonry, image overlay, magazine and timeline), portfolio (four designs with filter tabs: classic grid, hover overlay, masonry and metro), search form and theme-builder widgets (post title, post content, post excerpt, featured image, post meta, post comments, archive title, archive posts).
* A **Header & Footer builder**: design headers, footers, single, archive, search and 404 templates with Elementor and assign them with display conditions.
* A bundled **preset library** with over 200 ready-made pages, sections, headers, footers and blog layouts. Presets and their photos ship inside the plugin and load from your own site.
* **Pixlora AI** (optional): describe a page or a change in plain words and it builds or edits the layout in the Elementor editor using your own AI provider. It stays off until you add a provider under Pixlora Templates > Pixlora AI Settings. See "External services" below.

This plugin requires the [Elementor](https://wordpress.org/plugins/elementor/) plugin to be installed and active.

Pixlora Elements is an independent project. It is not affiliated with, endorsed by, or sponsored by Elementor Ltd. "Elementor" is a trademark of its respective owner and is used here only to describe compatibility.

== Installation ==

1. Install and activate the Elementor plugin.
2. Upload the `pixlora-elements` folder to the `/wp-content/plugins/` directory, or install through the Plugins screen.
3. Activate Pixlora Elements through the Plugins screen.
4. Create templates under **Pixlora Templates** and edit them with Elementor.

== Frequently Asked Questions ==

= Does this plugin call any external services? =

Only the optional Pixlora AI feature, and only after you connect an AI provider in Pixlora AI Settings. Everything else, including the preset library and its photos, works entirely on your own site. See "External services" for what is sent.

= Does it work without Elementor Pro? =

Yes. Header, footer and body templates are applied through standard WordPress template hooks, so no Pro add-on is needed.

== External services ==

Pixlora AI connects to an AI service that you choose. It is off by default: nothing is sent until an administrator enters a provider URL (and, if needed, an API key) under Pixlora Templates > Pixlora AI Settings.

Any OpenAI-compatible chat completions API can be used, for example OpenAI, OpenRouter, Groq, Mistral or Together AI, or an AI server running on your own computer such as Ollama or LM Studio. The plugin sends requests only to the address you enter.

When data is sent: only when a logged-in user who can edit the page sends a message in the Pixlora AI chat inside the Elementor editor. Nothing is sent when visitors view your site, and nothing is sent in the background.

What is sent with each request:

* the message typed into the chat;
* the layout of the page being edited: its sections, widgets, their settings and their text;
* the site title and tagline, and the title and type of the page being edited;
* the last few Pixlora AI requests made on that page, and any site preferences Pixlora AI was asked to remember (for example brand colours);
* when the AI looks for images: titles and alt text of matching images in your media library;
* your API key, if you entered one, so the provider can identify your account.

No visitor data is collected or sent. The API key is stored in your WordPress database and is never shown again after saving.

The provider you choose processes this data under its own terms. Please review them before connecting. For example, if you use OpenAI: Terms of use https://openai.com/policies/terms-of-use/ and Privacy policy https://openai.com/policies/privacy-policy/.

== Changelog ==

= 1.4.0 =
* New: Pixlora AI – describe what you want and it builds or edits the page for you, right in the editor.
* New: AI settings page to connect your own AI provider.
* New: Over 170 new ready-made designs, including full pages, sections, headers, footers and blog layouts.
* New: 30 free photos to use in your designs.
* New: Slider widget.
* New: Fresh navy and teal look for all widgets, with an option to keep the classic style.
* Improved: Bigger, easier-to-browse design library with live previews.
* Improved: Clearer placeholders in the editor for blog and page templates.

= 1.3.4 =
* New: Five filter styles for the Portfolio widget.

= 1.3.3 =
* Improved: Softer, smaller corners on the Portfolio widget.

= 1.3.2 =
* Fixed: Portfolio captions no longer hide the photo.

= 1.3.1 =
* Improved: Portfolio widget redesign.

= 1.3.0 =
* New: Portfolio widget.

= 1.2.1 =
* Improved: Posts widget looks better out of the box.

= 1.2.0 =
* New: Posts widget with six layouts.

= 1.1.3 =
* Improved: Filter templates by type in the template list.

= 1.1.2 =
* Improved: New plugin name.
* Fixed: Activation issue when Elementor is active.

= 1.1.1 =
* Improved: Elementor is now required.

= 1.1.0 =
* New: Redesigned header and footer designs.
* Fixed: Minor editor and compatibility issues.

= 1.0.0 =
* Initial release.

== Copyright ==

Pixlora Elements is distributed under the terms of the GNU GPL v2 or later.

This plugin bundles the following third-party resources:

Photos in assets/ai-assets/ (used by Pixlora AI and the bundled presets)
Source: WordPress Photo Directory, https://wordpress.org/photos/
License: CC0 1.0 Universal (Public Domain Dedication), https://creativecommons.org/publicdomain/zero/1.0/
Each photo's photographer and source page are listed in assets/ai-assets/LICENSE.txt and assets/ai-assets/manifest.json.

== Upgrade Notice ==

= 1.4.0 =
Navy & teal redesign of all widgets. Widgets without a saved Design use the new Corporate look; review existing headers, footers and templates and switch them to Design > Classic to keep their previous styling. Custom colors set in the panel are kept.

= 1.3.4 =
Adds five filter tab designs to the Portfolio widget.

= 1.3.3 =
Smaller, sharper corners on the Portfolio widget.

= 1.3.2 =
Cleaner Portfolio overlay captions.

= 1.3.1 =
Modern redesign of the Portfolio widget.

= 1.3.0 =
Adds a filterable Portfolio widget with four designs.

= 1.2.1 =
Polished default design for the Posts widget.

= 1.2.0 =
Adds a Posts widget with six selectable designs.

= 1.1.3 =
Adds a Type filter to the template list screen.

= 1.1.2 =
Plugin renamed to Pixlora Elements; activation and output-escaping fixes.

= 1.1.1 =
Elementor is now a required dependency and WordPress 6.5 or newer is required.

= 1.1.0 =
New premium header/footer presets and important editor-compatibility fixes.

= 1.0.0 =
Initial release.
