Hedomi Tarot – AI-Powered Tarot Reading & WooCommerce Plugin for WordPress

Create interactive, personalized tarot readings directly on your WordPress website.

Hedomi Tarot allows tarot readers, spiritual professionals, and digital entrepreneurs to create custom tarot decks, design unique spreads, generate AI-personalized interpretations, and sell paid readings through WooCommerce.

Visitors can ask a question, manually select their cards or receive an automatic draw, and view a complete interpretation based on the selected cards, their positions, upright or reversed orientation, and the meanings written by the website owner.

Create Your Own Tarot Experience

Build unlimited decks and add your own:

• Card artwork
• Upright meanings
• Reversed meanings
• Keywords
• Yes, No, or Maybe answers
• Position-specific spread contexts

Each spread can be visually arranged using the built-in position editor. Cards can be placed, rotated, and organized to create simple three-card readings, relationship spreads, career readings, spiritual guidance layouts, or completely original tarot systems.

AI-Personalized Tarot Interpretations

Connect the plugin to the OpenAI API and transform traditional card meanings into personalized readings based on the visitor’s exact question.

The AI considers:

• The client’s question
• The selected card
• The card’s position in the spread
• Upright or reversed orientation
• Card keywords
• Your original card interpretation
• The relationship between all cards in the reading

The result can include an individual interpretation for every card, practical guidance, an overall reading, and a final reflection.

AI use is completely optional. The plugin can also display only the traditional meanings saved by the administrator.

Sell Tarot Readings with WooCommerce

Turn your tarot calculator into a paid digital service.

Each spread can be configured as free or connected to a WooCommerce product. When a customer purchases the product, the plugin automatically adds reading credits to their WordPress account.

You can define how many readings each purchased product quantity provides.

For example:

• 1 product purchased = 1 tarot reading
• 3 products purchased = 3 tarot readings
• 1 package purchased = 5 tarot readings

Credits are consumed only after a successful reading. If the required AI interpretation fails, the customer keeps the credit.

Manual and Automatic Card Selection

Choose how visitors interact with each spread:

• Manual card selection
• Automatic card draw
• Both options

You can also enable reversed cards and define the probability of a card appearing reversed.

Flexible Spread Builder

Create unlimited tarot spreads with:

• Custom position names
• Position descriptions
• Drag-and-drop visual placement
• Horizontal and vertical positioning
• Card rotation
• Adjustable card width
• Custom card-back image
• Custom colors
• Reading instructions
• Configurable buttons
• Card or tab result layouts

Secure and Reliable

Hedomi Tarot includes server-side validation, secure AJAX requests, deck verification, WooCommerce credit protection, duplicate-order prevention, temporary reading locks, API diagnostics, rate limits, and automatic fallback to traditional meanings.

The OpenAI API key is stored securely on the WordPress server and is never exposed in the frontend.

Main Features

• Unlimited tarot decks
• Unlimited cards
• Unlimited custom spreads
• Upright and reversed meanings
• Manual and automatic card selection
• Reversed-card probability
• Visual spread position editor
• AI-personalized readings
• Multiple AI tones and languages
• Practical guidance and overall synthesis
• Traditional reading fallback
• OpenAI connection diagnostics
• Visitor consent and privacy notice
• Hourly AI usage limits
• Free and paid spreads
• WooCommerce product integration
• Reading-credit system
• Multiple credits per purchase
• Automatic customer account creation
• Return to the tarot page after checkout
• Administrator preview mode
• Responsive frontend
• WordPress shortcode support

Shortcode

Add any published spread to a page using:

[hedomi_tarot id="123"]

Replace 123 with the ID of your tarot spread.

Requirements

• WordPress 6.2 or newer
• PHP 7.4 or newer
• WooCommerce for paid readings
• An OpenAI API key for AI-personalized interpretations

WooCommerce and OpenAI are optional. Traditional free tarot readings work without either service.

Perfect For

Hedomi Tarot is ideal for:

• Professional tarot readers
• Spiritual coaches
• Esoteric websites
• Tarot course creators
• Membership websites
• Digital product businesses
• WordPress agencies
• Developers creating tarot websites for clients

Important Information

The plugin does not include copyrighted tarot artwork or ready-made commercial card interpretations. You can use your own artwork, licensed images, public-domain decks, and original meanings.

OpenAI API usage is billed separately by OpenAI and is not included with the plugin or with a ChatGPT subscription.

 

Documentation