==============================================================================
AstroChart - Documentazione Shortcode / Shortcode Documentation
==============================================================================

Il plugin AstroChart espone due shortcode WordPress. Tutti gli attributi sono
opzionali: se assenti, il plugin mostra il form di input per l'utente finale.

The AstroChart plugin exposes two WordPress shortcodes. All attributes are
optional: when omitted, the plugin displays the input form for the end user.


------------------------------------------------------------------------------
1. [astrochart_chart] - Carta natale completa
------------------------------------------------------------------------------

Mostra form + ruota natale SVG + tabelle pianeti, aspetti, case.
Shows form + natal wheel (SVG) + planet/aspect/house tables.

USO BASE / BASIC USAGE

    [astrochart_chart]

CON DATI PRE-COMPILATI / WITH PREFILLED DATA

    [astrochart_chart date="1992-05-16" time="08:45" timezone="Europe/Rome"
        lat="45.4642" lon="9.1900" hsys="P"]

NASCONDI IL FORM / HIDE THE FORM

    [astrochart_chart date="1992-05-16" time="08:45" place="Roma, RM"
        show_form="0" sections="natal"]


ATTRIBUTI / ATTRIBUTES

    date         Data nascita formato YYYY-MM-DD              es. "1992-05-16"
    time         Ora nascita formato HH:MM                    es. "08:45"
    timezone     Timezone IANA                                es. "Europe/Rome"
    lat          Latitudine decimale                          es. "45.4642"
    lon          Longitudine decimale                         es. "9.1900"
    place        Nome luogo (alternativa a lat/lon)           es. "Roma, RM"
    hsys         Sistema di case                              P|K|R|C|O|E|W
                 P=Placidus K=Koch R=Regiomontanus
                 C=Campanus O=Porphyry E=Equal W=Whole Sign
    show_form    Mostra il form di input                      "1" (default) | "0"
    sections     Sezioni risultato                            "natal" | "natal,solar_return"
    target_year  Anno per la rivoluzione solare               es. "2026"
    default_calc_tab    Tab attivo di default                 "natal" | "solar_return"
    layout       Layout dei pannelli                          "stack" (default) | "tabs"
    theme        Tema visivo                                  "light" (default) | "dark"
    css          Override CSS JSON                            es. css='{"accent":"#38bdf8"}'

    show_card_data    Mostra pannello dati carta              "1" (default) | "0"
    show_legend       Mostra legenda pianeti                  "1" (default) | "0"
    show_points       Mostra pannello pianeti                 "1" (default) | "0"
    show_houses       Mostra pannello case                    "1" (default) | "0"
    show_aspects      Mostra pannello aspetti                 "1" (default) | "0"
    show_calc_data    Mostra dati di calcolo                  "0" (default) | "1"

    aspect_filter     Aspetti da mostrare                     "conjunction,sextile,square,trine,opposition"
    orb_conjunction   Orbita personalizzata congiunzione      es. "8.5"
    orb_sextile       Orbita personalizzata sestile           es. "4"
    orb_square        Orbita personalizzata quadrato          es. "6"
    orb_trine         Orbita personalizzata trigono           es. "6.5"
    orb_opposition    Orbita personalizzata opposizione       es. "8"


------------------------------------------------------------------------------
2. [astrochart_ascendant] - Solo Ascendente
------------------------------------------------------------------------------

Calcola e mostra solo il segno e il grado dell'Ascendente.
Calculates and shows only the Ascendant sign and degree.

USO BASE / BASIC USAGE

    [astrochart_ascendant]

CON DATI PRE-COMPILATI / WITH PREFILLED DATA

    [astrochart_ascendant date="1990-03-15" time="14:30"
        lat="41.9028" lon="12.4964" timezone="Europe/Rome" output="long"]


ATTRIBUTI / ATTRIBUTES

    date         Data nascita formato YYYY-MM-DD              es. "1990-03-15"
    time         Ora nascita formato HH:MM                    es. "14:30"
    timezone     Timezone IANA                                es. "Europe/Rome"
    lat          Latitudine decimale                          es. "41.9028"
    lon          Longitudine decimale                         es. "12.4964"
    place        Nome luogo (alternativa a lat/lon)           es. "Roma"
    output       Formato output                               "short" (default) | "long"
                 short: "Bilancia 12.34"
                 long:  "Ascendente Bilancia 12° 20' 24\""


==============================================================================
ESEMPI PRONTI ALL'USO / READY-TO-USE EXAMPLES
==============================================================================

CARTA COMPLETA CON TUTTI I PANNELLI IN TAB
FULL CHART WITH ALL PANELS IN TABS

    [astrochart_chart date="1990-03-15" time="14:30" lat="41.9028" lon="12.4964"
        timezone="Europe/Rome" place="Roma, Italia" show_form="0" layout="tabs"
        show_card_data="1" show_legend="1" show_points="1" show_houses="1"
        show_aspects="1" show_calc_data="1"]


CARTA NATALE + RIVOLUZIONE SOLARE
NATAL CHART + SOLAR RETURN

    [astrochart_chart sections="natal,solar_return" default_calc_tab="solar_return"
        date="1990-03-15" time="14:30" lat="41.9028" lon="12.4964"
        timezone="Europe/Rome" place="Roma, Italia" target_year="2026"
        show_form="0" layout="tabs" show_calc_data="1"]


SOLO ASCENDENTE (FORMATO ESTESO)
ASCENDANT ONLY (LONG FORMAT)

    [astrochart_ascendant date="1990-03-15" time="14:30" lat="41.9028"
        lon="12.4964" timezone="Europe/Rome" output="long"]


TEMA SCURO CON OVERRIDE COLORI
DARK THEME WITH COLOR OVERRIDES

    [astrochart_chart date="1990-03-15" time="14:30" lat="41.9028" lon="12.4964"
        timezone="Europe/Rome" show_form="0" theme="dark"
        css='{"accent":"#38bdf8","planet_dot_fill":"#fbbf24"}']


SOLO ASPETTI MAGGIORI CON ORBITE PERSONALIZZATE
MAJOR ASPECTS ONLY WITH CUSTOM ORBS

    [astrochart_chart date="1990-03-15" time="14:30" lat="41.9028" lon="12.4964"
        timezone="Europe/Rome" show_form="0"
        aspect_filter="conjunction,sextile,square,trine,opposition"
        orb_conjunction="8.5" orb_square="6" orb_trine="6.5"]


==============================================================================
NOTE TECNICHE / TECHNICAL NOTES
==============================================================================

SISTEMI DI CASE SUPPORTATI / SUPPORTED HOUSE SYSTEMS

    P    Placidus            (default)
    K    Koch
    R    Regiomontanus
    C    Campanus
    O    Porphyry
    E    Equal
    W    Whole Sign


MOTORI DI CALCOLO / CALCULATION ENGINES

Selezionabili da Impostazioni -> AstroChart. La scelta vale per tutti gli
shortcode. Selectable from Settings -> AstroChart. The choice applies to all
shortcodes.

    Core              PHP locale, istantaneo, default consigliato.
                      Local PHP, instant, recommended default.
    Table             Tabelle ad alta precisione pre-calcolate (~19 MB download).
                      Pre-computed high-precision tables (~19 MB download).
    JPL Horizons      NASA JPL Horizons via API (sperimentale).
                      NASA JPL Horizons via API (experimental).


COORDINATE VS NOME LUOGO / COORDINATES VS PLACE NAME

Se fornisci lat + lon + timezone direttamente nello shortcode, il plugin NON
contatta nessun servizio di geocoding esterno. Se fornisci solo "place" e
l'utente lascia il form vuoto, viene usato il geocoder configurato in
Impostazioni -> AstroChart (Nominatim di default).

If you supply lat + lon + timezone directly in the shortcode, the plugin does
NOT contact any external geocoding service. If you only supply "place" and the
user leaves the form empty, the configured geocoder is used (Nominatim by
default), set under Settings -> AstroChart.


==============================================================================
RIFERIMENTI / REFERENCES
==============================================================================

Plugin homepage:     https://wordpress.org/plugins/astrochart/
Author website:      https://ctrino.com
License:             GPL-2.0-or-later
Source code:         vedi README di repository / see repository README
