=== Card Elements for Divi ===
Contributors: techeshta, alkesh7, vastarpara, hadihirpara
Tags: card elements module, divi addon, profile card module, testimonial card module, listing card module
Requires at least: 4.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Showcase useful elements with card style for the Divi Builder, compatible with both Divi 4 and Divi 5.

== Description ==

Card Elements for Divi is an effective and user-friendly way to showcase your team profiles, testimonials, posts, tours and listings in multiple ways with a unique card-style design. It adds new modules to the Divi Builder and is compatible with both the legacy Divi 4 builder and the native Divi 5 builder.

The Card Elements for Divi plugin comes bundled with five carefully designed modules that help you showcase and decorate your website content with card styling. More modules will be added in future versions.

== Where is the Card Elements for Divi plugin useful? ==

* You can decorate your blog post in various styles.
* Showcase your customer reviews in attractive ways.
* Decorate your tour and travel packages differently.
* Present your listing card in unique ways.
* Various profile card styles to show your team in unique ways.

### Ready-made Card Modules

* Profile Card
* Testimonial Card
* Post Card
* Tour Card
* Listing Card

== Installation ==

1. Upload the `card-elements-for-divi` folder to the `/wp-content/plugins/` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Make sure the Divi theme or the Divi Builder plugin (version 4.0 or later) is active. If neither is found, the plugin shows an admin notice with a link to get or activate Divi.

== How to Use ==

1. Edit any page or post with the Divi Builder.
2. Click the "+" icon to add a new module to a row.
3. Search for and select one of the card modules: Profile Card, Testimonial Card, Post Card, Tour Card or Listing Card.
4. Fill in the content (image, title, text, links, etc.) in the module's Content tab.
5. Optionally adjust spacing, borders and other styling using the standard Divi Design and Advanced tabs.
6. Save the page to publish your card.

No extra configuration or settings page is required; the modules are available as soon as the plugin is activated.

== External services ==

This plugin links to the following third-party service:

= WhatsApp (share button) =

The Tour Card and Listing Card modules can display a "Share on WhatsApp" button so visitors can share the current page with their contacts. The button is a plain link to `https://api.whatsapp.com/send`, provided by WhatsApp LLC (Meta Platforms, Inc.).

* What data is sent: the full URL of the page on which the card is displayed (passed as the `text` parameter of the link). No other site or visitor data is added by this plugin.
* When it is sent: only when a visitor clicks the WhatsApp share button. Nothing is sent to WhatsApp when the page loads or when the card is displayed. Clicking the button opens WhatsApp in a new browser tab, and from then on the visitor's interaction is with WhatsApp directly.
* How to disable it: the button is enabled by default. To hide it, open the Tour Card or Listing Card module settings and turn off the "Show WhatsApp Share" option in the Content tab. This option is available in both the Divi 4 and Divi 5 builders. When it is turned off, no WhatsApp link is added to the page.

WhatsApp Terms of Service: https://www.whatsapp.com/legal/terms-of-service
WhatsApp Privacy Policy: https://www.whatsapp.com/legal/privacy-policy

== Source Code and Build Tools ==

The compiled JavaScript files in `includes/divi5/build/` (profile-card.js, testimonial-card.js, post-card.js, tour-card.js and listing-card.js) are generated with webpack and Babel from the human-readable source files included in this plugin:

* Source: `includes/divi5/modules/{module-name}/index.jsx` and the matching `module.json` file in each module folder.
* Build configuration: `webpack.config.js`, `package.json` and `package-lock.json` in the root of the plugin's source repository.

The compiled files are already included in the plugin, so you do NOT need Node.js or npm to use it. Only if you want to modify the source and regenerate them, run `npm install` and then `npm run build` from the plugin source folder (Node.js 18 or later). Use `npm start` to rebuild automatically while editing.

== Screenshots ==

1. Profile Card module - showcase your team with photo, bio and social links.
2. Testimonial Card module - display customer reviews with ratings.
3. Tour Card and Listing Card modules - present bookings, listings and packages.

== Frequently Asked Questions ==

= Does this plugin require Divi? =

Yes, either the Divi theme or the standalone Divi Builder plugin must be installed and active.

= Is this plugin compatible with Divi 5? =

Yes, the plugin is built to work with both the Divi 4 (legacy) builder and the native Divi 5 builder.

== Changelog ==

= 1.0.0 =
* Initial release.
