Importazione da feed (MRSS, RSS, CSV, JSON)

L'importazione tramite feed (talvolta chiamata grabbers) fa crescere automaticamente la tua libreria. Ci si abbona a un feed remoto una volta sola, e TubePress lo controlla secondo una pianificazione, importa i nuovi video e salta quelli già visti.

Si trova come scheda nella schermata di importazione — apri /admin/import e passa alla scheda Feeds (l'URL /admin/feeds reindirizza lì). A differenza di un caricamento singolo, un feed continua ad aggiornare il sito man mano che la fonte pubblica nuovi contenuti.

Cosa fa l'importazione di feed

Ogni fonte è un URL di feed accompagnato da alcune impostazioni. Secondo la pianificazione definita, TubePress recupera il feed, normalizza ogni voce e mette in coda quelle nuove; una seconda fase le trasforma in video. Puoi scegliere come archiviare i contenuti:

• Embed — salva il link del player. Rapido, non richiede spazio di archiviazione e il video viene riprodotto in streaming dalla fonte.
• Download — scarica il file effettivo nel tuo archivio o CDN e lo transcodifica nelle tue versioni.

Per ogni fonte si imposta anche il tipo di video (straight, gay o hentai) e se i nuovi video vengono pubblicati automaticamente o trattenuti come bozze da revisionare.

Formati di feed supportati

Sono supportati quattro formati, rilevati automaticamente dal pulsante Rileva e Anteprima:

Aggiungere una fonte di feed

1. Apri la scheda Feeds. Vai a /admin/import, seleziona Feeds, poi Aggiungi fonte di feed.
2. Inserisci l'URL del feed. Deve iniziare con http:// o https://. Clicca su Rileva e Anteprima per rilevare automaticamente il formato e visualizzare un'anteprima delle prime voci.
3. Assegna un nome e conferma il tipo. Assegna un nome alla fonte e verifica il formato rilevato (MRSS, RSS, CSV o JSON) e il tipo di video.
4. Scegli una modalità. Embed per salvare i link del player, oppure Download per scaricare e transcodificare i file.
5. Mappa le colonne se necessario. MRSS e RSS si mappano automaticamente; per CSV/JSON, trascina ogni colonna sul campo corrispondente.
6. Imposta la pianificazione e le opzioni. Scegli un intervallo di aggiornamento, la regola per i duplicati, la pubblicazione automatica e quante pagine esaminare.
7. Salva. Usa Recupera ora per importare subito, oppure lascia che la pianificazione faccia il suo corso. Esegui coda elabora gli elementi in attesa su richiesta.

Mappatura dei campi

I feed normalizzano le voci negli stessi campi canonici usati dall'importatore. Per MRSS/RSS è automatico; per CSV/JSON si mappano le colonne su:

Pianificazione e automazione

Un task in background denominato feed_import viene eseguito sul pseudo-cron circa ogni 30 secondi — nessun crontab di sistema necessario. Ogni fonte viene recuperata solo quando il suo intervallo è trascorso:

• Solo manuale — mai recuperata automaticamente; usa Recupera ora.
• Ogni 15 minuti, ogni ora, ogni 6 ore o ogni giorno.

Lo stesso task svuota anche la coda di importazione — gli elementi embed vengono elaborati più alla volta, i download uno alla volta in modo che un file grande non blocchi gli altri. L'impostazione Pagine massime (1–50) limita la profondità di scansione di un feed paginato.

Deduplicazione e filtri

La deduplicazione è automatica e funziona su due livelli:

• Per fonte. Il guid di ogni elemento viene memorizzato, quindi il recupero successivo mette in coda solo le voci realmente nuove (quelle già viste vengono contate e saltate).
• Su tutto il sito. In modalità Download l'ID dell'elemento viene memorizzato nel video, così lo stesso clip proveniente da due feed diversi non viene scaricato due volte.

L'opzione In caso di duplicato determina cosa succede quando un elemento esiste già: Salta (consigliato) o Aggiorna esistente.

Risoluzione dei problemi con i feed

• «Impossibile riconoscere il formato del feed.» L'URL non ha restituito un MRSS/RSS/CSV/JSON valido. Aprilo in un browser e verifica di vedere il feed grezzo, non una pagina HTML.
• Elementi bloccati su «importando.» Si recuperano automaticamente dopo circa 30 minuti e vengono rielaborati; i fallimenti transitori vengono ritentati fino a tre volte prima di essere contrassegnati come falliti.
• Elementi falliti. Usa Riprocessa per rimettere in coda tutto ciò che ha fallito per una fonte. Ogni fonte mostra il suo ultimo stato e messaggio.
• La modalità Download fallisce. Il Download richiede un URL video diretto (non una pagina di visualizzazione); gli host privati o interni sono bloccati, e c'è un limite di 5 GB per file.
• Non viene importato nulla. Verifica che la pianificazione non sia impostata su Solo manuale, che la fonte sia abilitata e che il sito riceva traffico per attivare il cron.

Passi successivi