=== 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.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

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

== Description ==

**Platecraft Addons** brings 75 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, colors, 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; or a heading built from parts, each in its own font and color; a small line above and a big faded word behind.
* **Dual Color Heading** – two parts, each with its own color, gradient or outline.
* **Creative Button** – 15 hover backgrounds, 13 text animations (letters that roll up one by one too), 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.
* **Flip Box** – a card that turns, slides, pushes, fades or zooms to its back (12 effects) on hover, a tap or keyboard focus.
* **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.
* **Image Comparison** – before and after pictures with a handle to drag (or that follows the mouse), side by side or up and down.
* **Hotspots** – points on a picture (icon, word or number, placed per screen size) that open a card with text and a link.
* **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 → Inbox – 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 colors, brand gradients or your own colors and gradients, with hover effects and tooltips.
* **Data Table** – typed cell by cell (icons, pictures, links, cells spanning rows or columns) or pasted from a spreadsheet; sorting, a search box and one card per row on phones.
* **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.
* **Table of Contents** – the page's headings as nested or numbered links that mark the part being read; it folds and can stay on screen.
* **Reading Progress** – a bar along the screen's edge, a ring in a corner or a bar in your sticky header.
* 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), Post Content and a **Back to Top** button with a progress ring.

**Menus and business**

* **Pricing Table** and **Pricing Switch** – plans with features, badges and buttons, and a Monthly / Yearly switch (switch, sliding pill, buttons or underline) that changes their prices.
* **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 → Inbox → Bookings.

= Loop Animation =

Any widget, container, section or column can keep moving: 20 looping animations – bounce, float, sway, drift, orbit, hop, spin, spin-and-rest, swing, rock, wave, coin flip, wobble, pulse, heartbeat, jelly, tada, shake, ring, blink – or keyframes you write yourself. Set the speed, delay, distance, angle or size, easing, direction and turning point; play it all the time, while it is on screen or only on hover; pause it on hover, stop it on phones, or move only the pictures and icons. It works together with Elementor's Entrance Animation and Transform, is pure CSS, and loads only on pages that use it. Find it under Advanced → Loop Animation.

= 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 → Widgets → 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 → Settings → Opening Hours** and your WhatsApp number under **Platecraft → Settings → 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 → Widgets → 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 → Inbox (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 → Inbox → 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 → Settings → Product Details.

= How do I change the WhatsApp message? =

Go to Platecraft → Settings → 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 → Inbox → Bookings, the contact form messages kept under Platecraft → Inbox, 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 → Inbox: 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.5 =
* Fix: Elementor's newer Export / Import Kit (Elementor 3.30+ and 4.x) now takes the plugin's things along, like the older one already did: Theme Builder templates keep their type (header, footer, single …), places, priority and on / off switch, popups keep their settings, and opening hours, WhatsApp, the widgets that are off and the dynamic tags that are off come with Site Settings. Kits exported before this version do not contain them – export the kit again.
* New: Opening Hours – a Copy button on every day copies its hours to the days you tick (all days, weekdays or the weekend in one click).
* Fix: Hover Image Menu – with a taller active box (Box Padding Top / Bottom) the image no longer jumps up and down when the mouse moves from one list to the other.
* Fix: with Elementor on WordPress 7 the icons on the blue buttons of the Theme Builder (Add New Template, Edit with Elementor) were invisible.
* Fix: the tabs at the top of the Platecraft pages no longer keep a box around them after a click (the keyboard still shows it).
* Change: Dual Color Heading – the second part now uses the first part's font, size and weight; its own Typography changes only what should differ.
* Change: "Color" everywhere instead of "Colour" (American English, as in Elementor and WordPress). Only the words changed – saved designs stay as they are.
* Fix: Dual Color Heading – "Side by side" now reads like one sentence: the second part goes on right after the first, also when the first part runs over two lines. The old way (each part kept whole) is the new option "Side by side, each part whole".
* Fix: Creative Button – "Circle from the mouse" now grows from where the mouse comes in; it used to start from where the mouse had left the button the time before.
* New: Creative Button – "Letters roll up" and "Letters roll down" hover text: letter by letter (or word by word, for Bangla and other joined scripts), with the delay between them; the letters leave in the text color and come back in the hover color.
* Change: a tidier Platecraft menu – Widgets, Theme Builder, Popups, Inbox and Settings. Inbox holds the contact form messages and the bookings (with the number of new ones); Settings holds Opening Hours, WhatsApp, Product Details and Version Control; Dynamic Tags is a tab of Widgets. The pages keep their addresses, and each group shows its pages as tabs at the top. On Widgets and Dynamic Tags the row of group buttons is now one list next to the search.
* Fix: on phones the Platecraft bar at the top of its pages was half hidden behind the WordPress toolbar.

= 1.0.4 =
* New: Loop Animation for every widget, container, section and column (Advanced tab) – 20 animations or your own keyframes; plays all the time, on screen or on hover.
* New: 9 widgets – Pricing Table and Pricing Switch (Monthly / Yearly), Flip Box, Image Comparison, Hotspots, Data Table, Table of Contents, Reading Progress and Back to Top.
* New: Version Control (Platecraft → Version Control) – go back to an earlier release from WordPress.org if an update causes a problem, the way Elementor's Rollback works. Designs and settings stay.
* New: after a week of use, a small note asks administrators for a review on WordPress.org (with "Maybe later" and "I already did").
* Security: the post picker in the editor lists drafts, private and scheduled posts only to people who may edit them.
* Security: a custom-field dynamic tag no longer shows another person's WooCommerce billing or shipping details (a visitor still sees their own).
* Security: the contact form's "sent too fast" check also catches robots that leave out its time field.
* New: Advanced Heading – two Shared Styles for the parts. Style a look once (font, color or gradient, box) and choose it in every part that should have it; a part's Own Style still goes on top.

= 1.0.3 =
* Fix: with Elementor's Export / Import Kit, Theme Builder templates now keep their type, places, priority and on / off switch (they came in as plain Sections). Opening hours, WhatsApp settings, the widgets that are off and the dynamic tags that are off travel with the kit's Site Settings. Export the kit again with this version.
* New: Advanced Heading can be built from parts – as many as you like, each with its own font, color, gradient, outline or picture fill and box. New lines go between parts, and the shape goes under the parts you choose (e.g. "We Make *Digital* Products" with one word in a serif italic).

= 1.0.2 =
* New: Icon List – Opacity for the text and for the small line below it.
* Fix: a color 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 colors, brand gradients, outlines, icons only and more), your own colors 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, color 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.
