# Setup Freemius SDK – GEO AIEngineer v2.0

Il plugin utilizza l'**SDK Freemius v2.13.4** (sostituito dalla cartella `wordpress-sdk-2.13.4` in `vendor/freemius/`).

---

## Verifica SDK

Controlla che la cartella esista e contenga l'SDK v2.13.4:

```
adriano-geo-context-crawl-monitor-v2/
└── vendor/
    └── freemius/
        └── start.php   ← versione 2.13.4
```

Se la cartella è vuota o mancante:

1. Copia i file da `wordpress-sdk-2.13.4` in `vendor/freemius/`
2. Assicurati che `vendor/freemius/start.php` esista

---

## Credenziali e Dati Configurati nel Main Plugin File

```php
$gaie_fs = fs_dynamic_init( array(
    'id'                  => '31328',
    'slug'                => 'geo-aiengineer-monitor-ai-crawler-activity-and-manage-your-gen',
    'type'                => 'plugin',
    'public_key'          => 'pk_5048fc0a5ce5d7c9525ef64ea48eb',
    'is_premium'          => false,
    'premium_suffix'      => 'Pro',
    'has_premium_version' => true,
    'has_addons'          => false,
    'has_paid_plans'      => true,
    'trial'               => array(
        'days'               => 14,
        'is_require_payment' => false,
    ),
    'is_org_compliant'    => true,
    'menu'                => array(
        'slug'    => 'geo-ai-engineer',
        'contact' => false,
        'support' => false,
    ),
) );
```

---

## Checklist pre-pubblicazione WordPress.org

- [x] Freemius SDK v2.13.4 installato in `vendor/freemius/`
- [ ] Il file `vendor/freemius/` è incluso nel pacchetto (non è in `.svnignore`)
- [ ] Il flusso opt-in non è forzato (Freemius mostra il modal di opt-in opzionale)
- [ ] Il codice Pro non è incluso nel build free (le classi Pro sono incluse ma la logica è gated via `gaie_fs()->is_plan_or_trial__premium_only()`)
- [ ] Nessuna chiamata a server esterni per il tracking crawler (zero phone-home eccetto Freemius)
- [ ] `readme.txt` aggiornato con versione 2.0.0 e `Requires PHP: 8.0`

---

## Build per WordPress.org SVN

1. **Crea il `.svnignore`** o `.distignore` per escludere:
   - `CHANGELOG-v2.md`
   - `SETUP-FREEMIUS.md`
   - `*.md` (eccetto `readme.txt`)
   - `.git/`
   - `node_modules/`

2. **Non escludere** `vendor/freemius/` — deve essere incluso nel pacchetto SVN.

3. **Tag SVN**:
   ```bash
   svn copy https://plugins.svn.wordpress.org/adriano-geo-context-crawl-monitor/trunk \
             https://plugins.svn.wordpress.org/adriano-geo-context-crawl-monitor/tags/2.0.0 \
             -m "Tagging v2.0.0"
   ```

---

## Test locale rapido

1. Attiva il plugin in WordPress (WP 6.0+, PHP 8.0+)
2. Vai su **GEO AIEngineer → Dashboard**
3. Visita `https://tuosito.it/ai-context.json` per verificare l'endpoint
4. Usa un browser con User-Agent custom per simulare GPTBot e verifica che il log appaia
5. Testa il flusso opt-in Freemius: deve apparire il modal di consenso facoltativo (non forzato)