================================================================================
FEDERCREATIONS - CRAWLER SITEMAP PACKAGE
================================================================================

📦 CONTENUTO DEL PACCHETTO:

1. federcreations-crawler.php
   Il crawler PHP principale da caricare sul tuo server

2. htaccess-for-crawler.txt
   Configurazione .htaccess per abilitare CORS
   (rinomina in .htaccess o aggiungi al tuo .htaccess esistente)

3. INSTALL-GUIDE.html
   Guida visuale passo-passo per l'installazione

4. README-CRAWLER.md
   Documentazione tecnica completa

5. LEGGIMI.txt
   Questo file


================================================================================
🚀 INSTALLAZIONE RAPIDA (3 PASSI):
================================================================================

PASSO 1 - CARICA IL CRAWLER
----------------------------
Carica il file "federcreations-crawler.php" nella ROOT del tuo sito via FTP/SFTP

Esempio posizione corretta:
  /public_html/federcreations-crawler.php
  oppure
  /www/federcreations-crawler.php

❌ NON in sottocartelle come /wp-content/ o /tools/


PASSO 2 - CONFIGURA .HTACCESS (se necessario)
----------------------------------------------
Se il crawler non funziona per problemi CORS:

OPZIONE A - Hai già un file .htaccess:
  1. Apri il tuo .htaccess esistente
  2. Apri il file "htaccess-for-crawler.txt"
  3. Copia il contenuto e incollalo alla FINE del tuo .htaccess

OPZIONE B - Non hai un file .htaccess:
  1. Rinomina "htaccess-for-crawler.txt" in ".htaccess"
  2. Caricalo nella stessa cartella del crawler PHP


PASSO 3 - VERIFICA
-------------------
Apri nel browser:
  https://www.tuosito.com/federcreations-crawler.php?action=info

Dovresti vedere una risposta JSON simile a:
{
  "success": true,
  "data": {
    "name": "FederCreations Sitemap Crawler",
    "version": "1.0",
    "status": "ready"
  }
}

✅ Se vedi questo = Installazione riuscita!


================================================================================
🔧 USO CON IL GENERATORE SITEMAP:
================================================================================

1. Vai su https://www.federcreations.com/sitemap-generator.html

2. Seleziona "Scansione Automatica"

3. Nella sezione "Server Crawler PHP":
   - Inserisci: https://www.tuosito.com/federcreations-crawler.php
   - Clicca "✅ Verifica"

4. Quando appare "Crawler Verificato":
   - Inserisci l'URL del tuo sito
   - Seleziona la profondità
   - Clicca "🚀 Scansiona"

5. Attendi che trovi tutte le pagine

6. Clicca "Genera Sitemap XML"


================================================================================
💡 CONSIGLI:
================================================================================

• Per siti WordPress: usa profondità 2 (più veloce)
• Profondità 3 può richiedere 2-5 minuti su siti grandi
• Il crawler rispetta il rate limiting per non sovraccaricare il server


================================================================================
❓ PROBLEMI COMUNI:
================================================================================

PROBLEMA: "404 Not Found"
SOLUZIONE: Il file non è nella posizione corretta. Verifica che sia nella 
           root del sito, non in una sottocartella.

PROBLEMA: "Impossibile connettersi al crawler"
SOLUZIONE: Problemi CORS. Configura il file .htaccess come descritto sopra.

PROBLEMA: Scansione lenta
SOLUZIONE: Normale per WordPress. Riduci la profondità a 2 livelli.


================================================================================
📞 SUPPORTO:
================================================================================

Email: info@federcreations.com
Sito: https://www.federcreations.com

Per documentazione completa, consulta:
- INSTALL-GUIDE.html (guida visuale)
- README-CRAWLER.md (documentazione tecnica)


================================================================================
© 2025 FederCreations - Attilio Feder
================================================================================
