Price data contract

Prices are post meta, stored as text, one key per serving format.

The keys

On cocktails, precio-copa is the single price and is labelled Price in the bulk tools.

Values are strings

Prices are stored exactly as entered, sanitized as text. They may contain a currency symbol, a decimal comma or point, and free-form qualifiers such as 10,80€ (6 unidades).

Do not assume a parseable number. Code that computes on prices must define its own parsing and handle values it cannot parse.

Empty versus zero

Treat an empty meta value as absence, not as zero.

Reading prices

$full = get_post_meta( $post_id, 'precio-racion-completa', true );

if ( '' !== trim( (string) $full ) ) {
    // The item is offered in a full portion.
}

Writing prices

Prices are ordinary post meta and can be written with update_post_meta(). Two behaviors of the product's own tools are worth matching:

• Bulk import skips empty cells, so an import never blanks a stored price.
• Inline list editing writes a single key for a single post.

Prices across translations

Price fields are configured to stay in step across a menu item's translations. Read a price from any translation and expect the same value; write to the source item rather than to a translated record.

Prices and market references

The wine list additionally stores non-public reference values:

These are internal guidance and are not rendered to guests. Do not surface them on a public template.

Price presentation

Public output pairs each price with an icon identifying its format. The PDF generator adds two per-menu-type settings — a prefix and a suffix applied to every price — which live in the generator's own settings rather than in the meta value.

Two filters allow the PDF price icons to be overridden:

Integration guidance

• Read the keys for the menu type you are handling; do not assume all ten exist.
• Present empty formats as absent, never as 0.
• Preserve the stored string when displaying; reformatting silently changes the menu.
• If you must compute, parse defensively and fail visibly rather than guessing.