source: taxonomy-note/trunk/readme.txt @ 3399264

=== Taxonomy Note ===
Contributors: matteoenna
Tags: taxonomy, custom fields, term meta, content editing
Donate link: https://www.paypal.me/matteoedev/2.55
Requires at least: 5.0
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl.html

Add custom notes to taxonomy terms directly inside the post editor. Perfect for recipes, ingredients, attributes, or any taxonomy-based content.

== Description ==

**Taxonomy Note** allows you to add a customizable “note” input field for every taxonomy term assigned to a post.  
When a post type/taxonomy pair is enabled in the settings, a dedicated meta box will appear in the post editor showing all assigned terms, each with its own note field.

This is ideal for:

- Recipes (ingredients with quantity or notes)
- Products (attributes with additional info)
- Events (tags with remarks)
- Editorial workflows (categories with comments)
- Any situation where a taxonomy term needs extra per-post context

Notes are stored per post, not globally — so each post can have different notes for the same term.

### 🧩 Key Features

- **Admin Setup Panel** – Choose which post types and taxonomies should show the note panel.
- **Per-Post Notes** – Each post can store different notes for the same taxonomy term.
- **Automatic Cleanup** – If a term is removed from the post, its note disappears from the panel.
- **Lightweight & Non-Intrusive** – Pure WordPress; no JS frameworks required.
- **Perfect for Recipes** – Works beautifully if an AI or script extracts “ingredients” and you need to add quantities manually.
- **Compatible With Any Theme or Builder** – Gutenberg, Classic Editor, Elementor, and others.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/taxonomy-note/`
2. Activate the plugin from the **Plugins** menu.
3. Go to **Settings → Taxonomy Note**.
4. Select the post types and taxonomies where you want the note panel to appear.

== Usage ==

1. Edit any post type where you enabled the plugin.
2. Assign one or more taxonomy terms as usual.
3. A new **“Notes”** meta box will appear for each selected taxonomy.
4. Enter any custom text next to each assigned term.
5. Save the post — notes will be stored automatically.

Notes are saved **only for terms currently assigned to the post**.

== Credits ==

This plugin was created inside a project for Villa Sostaga.
Special thanks to Villa Sostaga for allowing the release as open source.
Maintained independently by Matteo Enna.

== Frequently Asked Questions ==

### Does removing a term delete its note?
Yes — if a term is no longer assigned to a post, its note is removed from the panel (and will not be saved).

### Are notes shared across posts?
No. Notes are *per post*, not global per term.

### Can I export or use these notes in the front-end?
Yes. Notes are stored as post meta (`_taxonomy_note_notes_{taxonomy}`) and can be displayed using:

- `get_post_meta()`
- A custom shortcode
- Your theme files
- A custom plugin

### Is there any performance impact?
Minimal. Notes are loaded only when editing a post and stored efficiently in post meta.