Title: Hedomi Tarot
Author: Elena Domingos
Published: <strong>August 31, 2026</strong>
Last modified: September 2, 2026

---

Search plugins

![](https://ps.w.org/hedomi-tarot/assets/banner-772x250.png?rev=3674929)

![](https://ps.w.org/hedomi-tarot/assets/icon-256x256.png?rev=3674953)

# Hedomi Tarot

 By [Elena Domingos](https://profiles.wordpress.org/elenadom/)

[Download](https://downloads.wordpress.org/plugin/hedomi-tarot.0.4.8.zip)

 * [Details](https://wordpress.org/plugins/hedomi-tarot/#description)
 * [Reviews](https://wordpress.org/plugins/hedomi-tarot/#reviews)
 *  [Installation](https://wordpress.org/plugins/hedomi-tarot/#installation)
 * [Development](https://wordpress.org/plugins/hedomi-tarot/#developers)

 [Support](https://wordpress.org/support/plugin/hedomi-tarot/)

## Description

Hedomi Tarot is a free, fully functional tarot-reading plugin for WordPress. The
WordPress.org build includes its local reading and optional AI functionality without
feature locking or trial restrictions. WooCommerce payment and reading-credit functionality
is a separate Pro feature and its functional code is not included in this Free build.

Features include:

 * Deck taxonomy and tarot card post type.
 * Upright and reversed meanings.
 * Keywords and optional Yes/No classification.
 * Spread builder with unlimited positions.
 * Visual drag-and-drop position preview.
 * Manual and automatic card selection.
 * Optional reversed cards and configurable probability.
 * Secure AJAX validation with nonce and deck verification.
 * Responsive frontend and card-reveal animations.
 * Reading cards or tabbed interpretations.
 * Shortcode: [hedomi_tarot id=”123″]
 * Optional OpenAI personalized interpretations using the visitor question and the
   administrator’s card meanings.
 * Required visitor consent for AI personalization, configurable local AI abuse 
   protection, connection test, and traditional-reading fallback.
 * One-click creation of the standard 78-card Tarot structure as editable drafts.

The plugin does not include copyrighted card artwork or interpretations. Site owners
must provide content they have the right to use.

OpenAI is an optional external service. Traditional readings work without OpenAI
and without an API key.

### External services

Hedomi Tarot can optionally connect to the OpenAI API to generate personalized tarot
interpretations. OpenAI performs the interpretation on its external servers. This
service is not required for traditional readings.

The connection occurs only when the site owner configures an OpenAI API key, enables
AI, and an AI reading is requested. The visitor must explicitly confirm consent 
before the question and spread data are sent to OpenAI.

For an AI reading, the plugin may send the visitor question (if provided), spread
title, selected card names, card orientation, spread position names and context,
card keywords, Yes/No metadata, site locale, card meanings entered by the site administrator,
and any additional AI instructions entered by the administrator. The OpenAI API 
key is sent in the server-to-server Authorization header. It is not exposed in frontend
JavaScript. Requests set the OpenAI `store` parameter to `false`; OpenAI’s processing
and retention practices remain governed by its own policies. WordPress authentication
cookies, authentication keys, salts, and session identifiers are not sent to OpenAI.

When the administrator enables the optional per-visitor AI abuse-protection limit,
anonymous requests use a SHA-256 hash of the visitor IP address as a temporary local
rate-limit key. The raw IP address is not stored by this feature, the hash is not
sent to OpenAI, and the transient expires within one hour. This rate protection 
affects only optional AI personalization and never blocks traditional readings.

OpenAI Terms of Use: https://openai.com/policies/terms-of-use/
 OpenAI Privacy Policy:
https://openai.com/policies/privacy-policy/

## Screenshots

[[

[[

[[

## Installation

 1. Upload the plugin ZIP in Plugins > Add New > Upload Plugin.
 2. Activate Hedomi Tarot.
 3. Open Hedomi Tarot > Decks and create a deck.
 4. Open Hedomi Tarot > Create 78 cards to generate a standard deck, or add cards manually.
    Set each card’s Featured Image and meanings.
 5. Open Hedomi Tarot > Spreads and create a spread.
 6. Select the deck, add positions and arrange them in the visual preview.
 7. Publish the spread and paste its shortcode into a page.

## FAQ

### Does the plugin include a tarot deck?

No. Card artwork and interpretations must be added by the site owner, using material
they have the right to use.

### Is the WordPress.org build fully functional?

Yes. Its local tarot-reading functionality is available without feature locking 
or trial restrictions. OpenAI personalization is optional and requires the site 
owner’s own API configuration.

### Are manually selected cards validated?

Yes. The server checks the nonce, card count, duplicate IDs and whether every card
belongs to the selected deck.

### Does the plugin require OpenAI?

No. OpenAI is optional. Traditional readings use the card meanings saved by the 
site owner and work without an API key. When a site owner supplies an OpenAI API
key and enables AI, the plugin can request personalized interpretations from OpenAI.

### Does the plugin send WordPress authentication cookies, keys, or salts to OpenAI?

No. The plugin does not send WordPress authentication cookies, keys, salts, or session
identifiers to OpenAI.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“Hedomi Tarot” is open source software. The following people have contributed to
this plugin.

Contributors

 *   [ Elena Domingos ](https://profiles.wordpress.org/elenadom/)

[Translate “Hedomi Tarot” into your language.](https://translate.wordpress.org/projects/wp-plugins/hedomi-tarot)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/hedomi-tarot/), check
out the [SVN repository](https://plugins.svn.wordpress.org/hedomi-tarot/), or subscribe
to the [development log](https://plugins.trac.wordpress.org/log/hedomi-tarot/) by
[RSS](https://plugins.trac.wordpress.org/log/hedomi-tarot/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 0.4.7

 * Added a secure admin tool that creates all 78 standard Tarot cards as editable
   drafts.
 * Existing cards in the selected deck are detected and skipped to prevent duplicates.

#### 0.4.6

 * Added a non-functional Pro preview for WooCommerce payment and reading-credit
   settings inside the spread editor.
 * Premium controls are visibly marked PRO and disabled; premium WooCommerce and
   credit code remains excluded from the Free build.
 * Added a restrained link to the separate Hedomi Tarot Pro edition.

#### 0.4.5

 * Removed legacy access restrictions from the WordPress.org build so local reading
   functionality remains fully available.
 * Removed use of WordPress authentication salts from AI identifiers and removed
   the external safety identifier from OpenAI requests.
 * Moved the AI settings JavaScript to an enqueued script.
 * Removed the unnecessary load_plugin_textdomain() call for WordPress.org-hosted
   translations.
 * Kept nonce and capability checks on administrative AJAX actions and nonce validation
   on frontend reading requests.
 * Made visitor consent mandatory before sending reading data to OpenAI.
 * Simplified WordPress.org-facing documentation and removed promotional admin UI.

#### 0.4.4

 * Corrected the WordPress.org contributor username to elenadom so the plugin is
   linked to the submitting account.

#### 0.4.3

 * Updated WordPress compatibility metadata.
 * Removed production-root setup Markdown files flagged by the WordPress.org automated
   scanner.
 * Removed the Domain Path header because this build does not bundle a local languages
   directory.

#### 0.4.0

 * Made AI an optional enhancement instead of a dependency of the reading flow.
 * API failures, missing consent, and AI limits fall back to traditional meanings
   instead of blocking the reading.
 * Added a visible result badge showing AI personalized vs traditional reading mode.

#### 0.2.3

 * Added a real OpenAI Responses API connection test and sanitized diagnostics.

#### 0.2.0

 * Added optional OpenAI personalized interpretations and per-spread AI controls.

#### 0.1.0

 * Initial functional foundation.

## Meta

 *  Version **0.4.8**
 *  Last updated **2 days ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.2 or higher **
 *  Tested up to **7.1**
 *  PHP version ** 7.4 or higher **
 * Tags
 * [cards](https://wordpress.org/plugins/tags/cards/)[Oracle](https://wordpress.org/plugins/tags/oracle/)
   [shortcode](https://wordpress.org/plugins/tags/shortcode/)[tarot](https://wordpress.org/plugins/tags/tarot/)
 *  [Advanced View](https://wordpress.org/plugins/hedomi-tarot/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/hedomi-tarot/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/hedomi-tarot/reviews/)

## Contributors

 *   [ Elena Domingos ](https://profiles.wordpress.org/elenadom/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/hedomi-tarot/)