=== Platecraft Addons for Elementor ===
Contributors: platecraft
Tags: elementor, addons, theme builder, woocommerce, widgets
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

66 widgets, a theme builder and dynamic tags for free Elementor: sliders, charts, forms, WooCommerce pages, menus, blog and more.

== Description ==

**Platecraft Addons** brings 66 widgets, a Theme Builder and 57 dynamic tags to the **free version of Elementor**. Build a whole site – header, footer, blog, shop, cart and checkout – with full design control and without Elementor Pro. Made with restaurants, cafés and shops in mind, and just as useful for any business, blog or portfolio.

= Why Platecraft =

* **No Pro needed** – every widget, the Theme Builder and the dynamic tags work with free Elementor.
* **Style every part** – typography, colours, spacing, borders, shadows and hover states, separately for desktop, tablet and mobile.
* **Light and self-contained** – no chart, slider or animation libraries from other sites. A widget's small CSS and JS files load only on pages that use it, and widgets you switch off are not loaded at all.
* **Made for WooCommerce** – product, shop, cart, checkout and account pages use WooCommerce's own forms, so payment and shipping plugins keep working.
* **Easy to find** – all widgets sit together under "Platecraft", right after Elementor's Basic widgets, each with a small Platecraft mark.

= Widgets =

**Basic**

* **Advanced Heading** – highlighted words with a gradient, image or outline and a hand-drawn underline, circle or strike that draws itself in; a small line above and a big faded word behind.
* **Dual Color Heading** – two parts, each with its own colour, gradient or outline.
* **Creative Button** – 15 hover backgrounds, 11 text animations, attention effects, a spinning gradient border, click ripple and magnetic pull.
* **Icon Box** and **Icon List** – icons, images or numbers with fill, light, 3D tilt or shine on hover; lists in columns or a row.
* **Accordion / FAQ** – questions that open and close, with FAQ data for search engines.
* **Counter** and **Progress Bars** – numbers that count up, bars and circles that fill when they come into view.

**Creative**

* **Marquee** – an endless band of text, logos or saved templates that speeds up while the page scrolls.
* **Animated Border Box** – a spinning, beaming or flowing gradient border around any content.
* **Countdown** – to a date, to a time every day, an evergreen timer or the end of a product's sale.
* **Offer Banner**, **Rotating Text Badge** and **Image Grid** (mosaic or masonry photos with a lightbox).

**Showcase**

* **Content Slider** – big slides with a title, text and buttons, or any saved template; fade, zoom, parallax, cube or flip, with a slow zoom on the picture and content that animates in.
* **Chart** – column, bar, line, area, pie and doughnut charts drawn by the page itself, with a legend and values on hover.
* **Testimonial Slider** (six designs), **Team**, **Logo Grid** and a **Timeline** that fills as the page scrolls.

**General**

* **Contact Form** – any fields in any widths. Every message is emailed to you and kept under Platecraft → Submissions – who sent it, from which page and when – with replies by email, notes, CSV export and spam protection that needs no outside service.
* **Popup** – opens on a click, after some seconds, on scrolling or when leaving; designed with Elementor.
* **Social Icons** – 36 networks in brand colours, brand gradients or your own colours and gradients, with hover effects and tooltips.
* **Breadcrumb** (with structured data), **Search Form** (a box or full screen) and **Share Buttons**.

**Shop (WooCommerce)**

* **Product Grid** and **Category Grid** – grids or carousels with tabs, AJAX add to cart and pagination.
* **Mini Cart** – a side panel or dropdown with a "free delivery from …" progress bar.
* **Cart**, **Checkout** and **My Account** – WooCommerce's own pages in a new layout: totals beside the products, − / + buttons, a cart that updates by itself, an account menu with icons and your own words.
* **Products Toolbar** and a **WhatsApp Order Button** that writes the product name, price and link into the message.

**Product page**

* Product Title, Price, Add to Cart (variations and − / + buttons), Rating, Stock, Meta, Description (with "Read more"), Short Description, Tabs, Badges and a **Product Gallery** with thumbnails, swipe and lightbox.

**Blog and archive**

* **Posts** – a grid, masonry, list or carousel with a drag-and-drop card layout, filter tabs and pagination.
* Archive Title, Short Description, Post Meta, Featured Image, Author Box, Post Navigation and Term List.

**Site and Theme Builder**

* **Nav Menu** (dropdowns, and a side panel or full-screen menu on phones), Site Logo, Site Title, Copyright (the year updates itself) and Post Content.

**Menus and business**

* **Food Menu** and **Tabbed List** – price lists with dotted lines, diet tags, sizes, old prices and photos.
* **Hover Image Menu**, **Field List** and **Product Details** – options, extras, ingredients and allergens from a built-in product tab, from ACF / Secure Custom Fields or typed in.
* **Opening Hours**, **Open Status** ("Open now / Closed", right on cached pages too) and a **Reservation Form** whose times follow your opening hours; bookings are kept under Platecraft → Bookings.

= Theme Builder =

Design the header, footer, single post or page, archive, search results, 404 page, product, shop, cart, checkout and My Account page with Elementor, then choose where each one shows – the entire site, some pages, a category, an author – with exceptions and a priority. Sticky and transparent headers. Works with any theme, classic or block. While you design, pick the post, product or category the template shows under ⚙ Settings → Preview.

= Dynamic Tags =

57 dynamic tags for any Elementor field with the stack icon, with or without Elementor Pro: post, archive, site, author, visitor, comments, custom fields and ACF, links (call, email, WhatsApp, maps, log in / out), WooCommerce (price, sale badge, stock, rating, live cart count …) and Platecraft (open a popup, opening hours of a day). Text tags have Before, After and Fallback. Switch groups off under Platecraft → Dynamic Tags.

= Trademarks =

Platecraft Addons for Elementor is an independent plugin by Platecraft. It is not affiliated with, endorsed by or sponsored by Elementor Ltd., Automattic Inc. or Meta Platforms, Inc. Elementor, WooCommerce and WhatsApp are trademarks of their respective owners and are named here only to describe what the plugin works with.

== Installation ==

1. Install and activate Elementor.
2. Upload the `platecraft-addons-for-elementor` folder to `/wp-content/plugins/`, or install the plugin from the Plugins screen.
3. Activate the plugin.
4. Set your opening hours under **Platecraft → Opening Hours** and your WhatsApp number under **Platecraft → WhatsApp**.
5. Edit a page with Elementor and search for "Platecraft" in the widget panel.

== Frequently Asked Questions ==

= Do I need Elementor Pro? =

No. All widgets, the Theme Builder and the dynamic tags work with the free version of Elementor. With Elementor Pro the plugin's tag groups are marked "(Platecraft)", and you can switch off the ones Pro already has under Platecraft → Dynamic Tags.

= Do I need WooCommerce? =

No. The shop widgets appear when WooCommerce is active. Without it, use the Custom source in the Hover Image Menu, the ACF / SCF or Manual source in Product Details, and "None" or a post ID in the WhatsApp button.

= Where do contact form messages go? =

Each message sent with a Contact Form is kept under Platecraft → Submissions (unless you switch "Keep Messages in WordPress" off) with the sender's details, the form name, the page, the time and – if the form keeps it – the IP address and browser. Opening one marks it as read; you can reply by email, add a note, filter by form and export CSV. It is also emailed to the addresses set in the widget, with the sender as Reply-To. WordPress sends the email; for dependable delivery, use an SMTP plugin. Messages hold personal data: a suggested privacy text is added under Settings → Privacy, and Tools → Export / Erase Personal Data include them.

= Where do reservation bookings go? =

They are kept in WordPress under Platecraft → Bookings (unless you switch "Save Bookings in WordPress" off), with the guest's details, a status (new, confirmed, cancelled) you can change, a private note, filters by booking date, search and a CSV export. They can also be sent to the email addresses set in the widget (or the site admin email), with the guest's email as Reply-To, and / or to a WhatsApp chat: the visitor's WhatsApp opens with the booking written in, ready to send to your number. Bookings hold personal data: the plugin adds a suggested text to Settings → Privacy, and Tools → Export / Erase Personal Data include them.

= Where do I add options, extras and ingredients for a product? =

Edit the product and open **Product data → Menu Details**. Add rows, drag them to reorder and update the product. Then add the Product Details widget to your single product template (Data Source: Product → Menu Details tab).

= I already use ACF / Secure Custom Fields for this. =

Choose the "Custom fields (ACF / SCF)" data source in the Product Details widget, open "Sections (custom fields)" and pick each field you want to show from the list – any field names work. Or use the Field List widget, one field per widget. Repeater sub-fields are detected automatically; you can also pick them by hand.

= Do I need a custom fields plugin? =

No. The built-in Menu Details product tab and the Manual source work without one. For your own fields install the free Secure Custom Fields plugin (it includes the Repeater field) and click "Create the field group for me" under Platecraft → Product Details.

= How do I change the WhatsApp message? =

Go to Platecraft → WhatsApp and edit the message. Use `{name}`, `{price}`, `{url}`, `{page}` and `{site}`. A line whose placeholder has no value (for example a product without a price) is left out. You can also enter a different message in a single button.

= Can I turn off widgets I do not use? =

Yes. Under Platecraft → Widgets, switch off any widget or a whole group. Switched-off widgets leave the Elementor panel and their files are not loaded.

= Is anything deleted when I remove the plugin? =

Deleting the plugin removes its settings (opening hours, WhatsApp settings and the widget and dynamic tag choices), the bookings kept under Platecraft → Bookings, the contact form messages kept under Platecraft → Submissions, the popups made under Platecraft → Popups and the Theme Builder templates. Menu details saved on products are kept. Export your bookings and messages as CSV first if you want to keep them.

== Screenshots ==

1. All Platecraft widgets sit together in the free Elementor editor, right after Elementor's Basic widgets, each with a small Platecraft mark.
2. Content Slider: big slides with a title, text and buttons – or any saved template – with fade, zoom, parallax, cube or flip.
3. Advanced Heading, Icon Box, Counter and Progress Bars – every part can be styled.
4. Chart: column, bar, area, line, pie and doughnut charts drawn without a chart library.
5. Contact Form: any fields in any widths, with spam protection that needs no outside service.
6. Every message is kept under Platecraft → Submissions: who sent it, from which form and page, and when.
7. Food Menu, Opening Hours and the Reservation Form for restaurants and cafés.
8. Cart: WooCommerce's cart with the totals beside the products and − / + buttons.
9. Theme Builder: header, footer, post, archive, product, shop, cart, checkout and account templates with display conditions.
10. Platecraft → Widgets: switch off what you do not use.

== External services ==

The WhatsApp Order Button and the Reservation Form (when set to send bookings to WhatsApp) link to WhatsApp (wa.me), a service provided by WhatsApp LLC (Meta), so visitors can start a chat with your business.

* What is sent: nothing is sent when a page loads. Only when a visitor clicks the button (or sends the booking form), their browser opens a wa.me link that contains your WhatsApp number and the message text (for example the product name, price and link, or the booking details the visitor typed).
* WhatsApp Terms of Service: https://www.whatsapp.com/legal/terms-of-service
* WhatsApp Privacy Policy: https://www.whatsapp.com/legal/privacy-policy

The Share Buttons widget links to the sharing pages of Facebook, X, LinkedIn, WhatsApp, Telegram, Pinterest, Reddit and Threads (only the networks you add).

* What is sent: nothing is sent when a page loads. Only when a visitor clicks a share button, their browser opens that network's share page with the page address and title (and, for Pinterest, the featured image address).
* Facebook / Meta (Facebook, WhatsApp, Threads): https://www.facebook.com/legal/terms – https://www.facebook.com/privacy/policy
* X: https://x.com/en/tos – https://x.com/en/privacy
* LinkedIn: https://www.linkedin.com/legal/user-agreement – https://www.linkedin.com/legal/privacy-policy
* Telegram: https://telegram.org/tos – https://telegram.org/privacy
* Pinterest: https://policy.pinterest.com/terms-of-service – https://policy.pinterest.com/privacy-policy
* Reddit: https://redditinc.com/policies/user-agreement – https://www.reddit.com/policies/privacy-policy

No other external services are used. The plugin does not track visitors and loads no remote files.

== Changelog ==

= 1.0.2 =
* New: Icon List – Opacity for the text and for the small line below it.
* Fix: a colour picked for softer text now shows exactly as chosen; before, it showed lighter. This was in Icon List's small line, post meta, author box, term list, chart labels, counter label, old prices, product tabs, cart and checkout headings and more.

= 1.0.1 =
* New: Social Icons widget – 36 networks, ten looks (brand colours, brand gradients, outlines, icons only and more), your own colours or gradients for the icon, text, background and border (normal and hover), hover effects, tooltips, and icons that come in one by one.
* New: Product Description widget – the product's full description, with an optional title and a "Read more" button for long texts.
* New: Theme Builder conditions – Shop Page, product category and tag archives and single products are now in the WooCommerce group, so the shop and each kind of product archive can have its own template.
* Fix: Theme Builder content templates (single product, shop, blog post, archive …) now use the full width of the screen; with some themes, like Hello Elementor, they were held in a narrow column.
* Fix: widgets in Theme Builder headers and footers no longer show unstyled for a moment while the page loads.
* Fix: inside Theme Builder templates and popups, wave and zigzag tab lines (Product Grid, tabs) and custom box shadows now show on the site as in the editor (WordPress's HTML filter removed them).
* Fix: Icon List – Alignment now also works in the Columns layout, and the Lines section always shows its switch (with new Line Length and Space Above the Line settings).
* Fix: Progress Bars – the "Filling Takes" time now also applies to the numbers that count up on the site.
* New: Nav Menu lines between items (mobile menu and dropdowns) can be solid, dashed, dotted or switched off, with their own thickness, colour and room at the ends.
* Fix: in the editor, the Nav Menu now shows a new "Show the Menu Button On" choice straight away (before, it showed only after another setting was changed).
* Fix: the Nav Menu side panel and full screen menu now start at the very top of the screen; in the editor they left a gap above.
* Fix: in the editor preview, sticky and transparent Theme Builder headers no longer leave room for an admin bar that is not there.

= 1.0.0 =
* First release: 64 widgets, a theme builder, 57 dynamic tags, contact form submissions, bookings and popups.
